Templates do WhatsApp (HSM)
Um template HSM (Highly Structured Message) é uma mensagem pré-aprovada pela Meta que você pode enviar fora da janela de 24h ou para iniciar contato com clientes (com opt-in válido).
Anatomia de um template
┌─────────────────────────────┐
│ HEADER (opcional) │ ← imagem, vídeo, doc, ou texto
├─────────────────────────────┤
│ BODY (obrigatório) │ ← texto principal com variáveis {{1}}, {{2}}
├─────────────────────────────┤
│ FOOTER (opcional) │ ← texto pequeno embaixo
├─────────────────────────────┤
│ BUTTONS (opcional) │ ← URL, telefone, ou quick reply
└─────────────────────────────┘Variáveis no body são {{1}}, {{2}}, etc — você preenche na hora de enviar.
Categorias
Marketing
Promoções, novidades, anúncios. Sujeito a "quality rating" — se muitos clientes bloquearem, a Meta limita ou reprova futuros templates.
Utility
Atualizações transacionais (pedido enviado, agendamento confirmado, fatura disponível). Mais permissivo.
Authentication
OTPs e códigos de verificação. Limitado a 1 botão "Copiar código".
Criar um template
Vá no Meta Business Manager
**WhatsApp → Modelos de mensagem → Criar modelo**. (Ou pelo Cosmobots em **Templates → + Novo** se você for usuário de provedor que ofereça gestão centralizada.)Escolha categoria e idioma
Marketing, Utility ou Authentication. Idioma "Portuguese (BR)" para cliente Brasil.Defina o conteúdo
- Header: Texto (até 60 chars), Imagem, Vídeo, Documento ou nenhum - Body: até 1024 chars, com `{{1}}`, `{{2}}`, etc. - Footer: até 60 chars - Botões: até 3 (URL, ligar, ou quick reply)Submeta para aprovação
A Meta analisa em **1 minuto a 24h**. O status fica visível no painel:
Em análiseAprovadoReprovadoUse o template
No reply box do WhatsApp, clique no ícone 📨 e selecione o template. Preencha as variáveis e envie.
Por que um template é reprovado?
- Conteúdo promocional na categoria Utility — eles realocam pra Marketing ou reprovam
- Linguagem genérica demais — "Ver mais", "Clique aqui" sem contexto
- Variáveis sem amostra — você precisa fornecer um exemplo do que
{{1}}representa - Erros de gramática ou caracteres incomuns
Template com mídia
Templates podem ter um header com mídia. Exemplo de fatura:
[IMG: comprovante.jpg]
Olá {{1}}, sua fatura de {{2}} no valor de R$ {{3}} já está disponível.
[Botão: Pagar agora] [Botão: Ver fatura]Variáveis dinâmicas
Você define um exemplo no momento da criação:
| Posição | Exemplo na criação | Substitui em runtime por... |
|---|---|---|
{{1}} | João | Nome do contato |
{{2}} | Janeiro/2026 | Mês de referência |
{{3}} | 199,90 | Valor |
A Meta usa o exemplo só pra avaliar o template — em produção você manda os valores reais.
Tipos de botões em templates
URL
Abre um link. Pode ser dinâmico: https://site.com/{{1}}.
Ligar
Disca um telefone (até 1 botão por template).
Quick reply
Vira uma mensagem que o cliente clica e responde — útil pra disparar fluxos.
Disparos com templates
Para enviar para muitos clientes, use Disparos. Cada disparo escolhe 1 template aprovado e o sistema envia para a lista alvo respeitando opt-in e janela.
Templates no construtor de fluxos
Você também pode disparar templates dentro de um fluxo — útil pra retomar contato com cliente que ficou inativo. Veja bloco Webhook ou disparo via Bloco Cosmoflow Link → Disparo.