Modelos de mensagem: tipos, criação e aprovação#
Você quer avisar 300 clientes que a fatura vence amanhã. No WhatsApp oficial, fora da janela de 24 horas, mensagem escrita na hora não sai — só sai o que a Meta já aprovou antes. Esse conteúdo aprovado é o modelo (template).
Antes de começar#
Um aviso que evita horas perdidas: existem duas coisas chamadas "template" no sistema, e só uma delas é esta.
| Modelo oficial | Resposta rápida | |
|---|---|---|
| Onde é aprovado | Na Meta, com revisão | Em lugar nenhum |
| Abre conversa? | Sim | Não |
| Vale fora da janela de 24h? | Sim | Não |
| Onde se cadastra | Configurações → WhatsApp oficial | Configurações → Respostas rápidas |
Se você quer texto pronto para o atendente colar durante a conversa, o lugar é Respostas rápidas. Esta página é sobre o outro.
O que a Meta exige#
| Item | Regra |
|---|---|
| Categoria | Só três valores: MARKETING, UTILITY, AUTHENTICATION |
| Nome | Minúsculas, sem espaço e sem acento — é identificador, não título |
| Idioma | No formato pt_BR |
| Componentes | HEADER, BODY, FOOTER e BUTTONS, cada um com forma própria |
| Variáveis | Posicionais, numeradas a partir de 1, sem pular número, e sem começar nem terminar o corpo |
Os limites de caracteres:
| Componente | Limite |
|---|---|
| Nome | 512 |
| Cabeçalho (header) | 60 |
| Corpo (body) | 1024 |
| Rodapé (footer) | 60 |
| Texto de botão | 25 |
As três categorias#
UTILITY — sobre algo que o cliente já contratou ou pediu: fatura, agendamento, status de chamado, aviso de instalação. É a categoria da maioria dos avisos de um provedor.
MARKETING — promoção, novidade, convite, recuperação de carrinho. É a mais cara e a que o cliente pode bloquear por preferência de marketing.
AUTHENTICATION — somente código de verificação. Tem formato próprio, não aceita texto livre nem link, e não funciona para destinatário sem telefone.
Escolher a categoria errada custa dinheiro e entrega. Mandar um aviso de fatura como MARKETING faz você pagar mais caro e sujeita a mensagem a um limite diário por pessoa que a UTILITY não tem. E reincidir em categoria errada leva a conta a uma restrição que vale para modelo e para mensagem livre.
Os botões#
| Tipo | O que faz do lado do cliente | Abre a janela de 24h? |
|---|---|---|
| Resposta rápida | O texto do botão volta como mensagem dele | Sim — sem ele digitar nada |
| Abrir link | Leva a uma página (segunda via, rastreio) | Não — ele sai do WhatsApp |
| Ligar | Abre o discador com o número preenchido | Não |
| Compartilhar telefone | Pede o número a quem usa username no WhatsApp | CONFERIR: comportamento quanto à janela |
Quantos cabem:
| Limite | |
|---|---|
| Total de botões | 10 |
| Resposta rápida | 10 |
| Abrir link | 2 |
| Ligar | 1 |
| Compartilhar telefone | 1 |
A Meta não corta o que passa do limite: ela recusa o modelo inteiro — e a recusa chega horas depois como INVALID_FORMAT, que não diz qual botão sobrou. Confira os números antes de submeter.
Acima de três botões, o WhatsApp deixa de desenhá-los lado a lado e passa a mostrar "Ver todas as opções". Continua funcionando, mas muda o que o cliente vê.
Variável na URL do botão#
A URL aceita uma variável, e só no fim. https://provedor.com.br/fatura/{{1}} é aceito. https://{{1}}.com.br/fatura é recusado: o domínio faz parte do que a Meta revisa, e um domínio variável não passa por revisão nenhuma.
Como fazer#
- Vá em Configurações → WhatsApp oficial, aba de modelos.
- Escolha o canal, se houver mais de um.
- Clique em criar. Preencha nome, idioma e categoria.
- Escreva o corpo. Use variáveis posicionais (
{{1}},{{2}}) onde o texto muda por cliente. - Acrescente cabeçalho, rodapé e botões, se precisar.
- Confira a prévia. Ela mostra a mensagem como o cliente vai vê-la, com os botões desenhados.
- Submeta. O modelo nasce com status pendente e vai para a revisão da Meta.
Se você está migrando de outra plataforma e já tem modelos aprovados, use a importação: ela traz para cá os que já existem na conta, sem submeter tudo de novo.
Quanto tempo demora, e o que fazer enquanto isso#
A revisão da Meta leva de minutos a horas, e não há como apressá-la. Planeje: um modelo criado no dia do disparo é um disparo que não acontece. Cadastre os modelos de aviso recorrente com folga, antes de precisar deles.
Se algo der errado#
O modelo foi reprovado. Veja Por que um modelo é reprovado — a Meta devolve um código, e cada um aponta para um campo diferente.
"Este template não existe neste idioma, ou ainda não foi aprovado" (132001). Confira o nome e o idioma. Modelo aprovado em pt_BR não atende um envio pedido em pt_PT.
"Número de variáveis diferente do aprovado" (132000). O envio mandou mais ou menos campos do que o modelo tem. Confira o cadastro.
"O texto ficou longo demais" (132005). O corpo cabe no limite, mas o corpo com as variáveis preenchidas não. Encurte o que vai nos campos, não o modelo.
O modelo sumiu depois de aprovado. Modelo é objeto da conta na Meta e leva tempo para propagar. Recarregue a lista alguns minutos depois.