Este documento reúne regras técnicas e boas práticas para criação de templates de mensagens no WhatsApp Business pré-definidas pela Meta e podem sofrer alterações sem aviso prévio.
Os templates são mensagens pré-aprovadas pela Meta. A aprovação ocorre automaticamente por revisão da Meta, portanto seguir as boas práticas aumenta significativamente as chances de aprovação.
Estrutura de um Template de WhatsApp
Um template é dividido em:
- Nome do Template
- Body (Corpo da mensagem)
-
Cabeçalho
-
Associação de variáveis
- CTA (ações interativas)
1. Nome do Template
O nome do template é utilizado apenas para identificação interna do template na plataforma e na Meta.
Regras
-
Deve conter apenas letras minúsculas, números e separados por underline (_)
-
Não pode conter espaços
-
Não pode conter caracteres especiais
- Não pode conter a palavra "teste"
Exemplo válido
nova_colecao
confirmacao_pedido
lembrete_consulta
2. Categoria do Template
A categoria define o tipo de comunicação da mensagem.
Principais categorias:
🔸Utility
Mensagens relacionadas a ações ou serviços solicitados pelo usuário.
Exemplos:
-
confirmação de pedido
-
status de entrega
-
lembrete de consulta
🔸Marketing
Mensagens promocionais ou campanhas comerciais.
Exemplos:
-
promoções
-
lançamento de produtos
-
campanhas de desconto
3. Body (corpo da mensagem)
O body é a única parte obrigatória do template.
Limites:
-
Até 1024 caracteres para envio e aprovação
✅ Conteúdo permitido:
-
texto
-
emojis
-
variáveis
-
formatação simples
Restrições:
❌ Não é permitido:
- iniciar a mensagem com variável
- terminar a mensagem com variável
- utilizar duas variáveis consecutivas
- utilizar de dois enters entre parágrafos
- utilizar apenas variáveis
- ter mais de 10 emojis
Exemplo correto:
Olá {{1}}, seu pedido {{2}} foi enviado.
Exemplo incorreto:
{{1}}, seu pedido foi enviado
4. Cabeçalho
✅ Tipos permitidos:
-
Texto
-
Imagem
-
Vídeo
-
Documento
Limites:
-
Texto: até 60 caracteres
-
Apenas 1 variável permitida no header de texto
-
Não pode começar ou terminar com variável
-
Emojis ou formatação geralmente não são permitidos no header
Exemplo:
Atualização do pedido
5. Associação de Variáveis com Campos da Plataforma
Após criar as variáveis no template, é necessário associá-las aos campos da base de dados da plataforma.
Essa associação permite que os dados sejam preenchidos automaticamente no momento do disparo da mensagem.
Exemplo
Template criado:
Olá {{1}}, seu pedido {{2}} foi enviado.
Associação na plataforma:
| Variável | Campo da base |
|---|---|
| {{1}} | nome |
| {{2}} | numero_pedido |
Como funciona no envio
Se o contato possuir os dados:
nome = Ana
numero_pedido = 4589
O usuário receberá:
Olá Ana, seu pedido 4589 foi enviado.
6. Ações Interativas (CTA)
CTA significa Call To Action, ou seja, botões que permitem ao usuário executar uma ação diretamente na mensagem.
Eles aparecem abaixo do conteúdo da mensagem no WhatsApp.
Na plataforma é possível criar dois tipos:
1. Phone:
Cria um botão que permite ao usuário ligar diretamente para um telefone.
Campos necessários:
-
Título do botão (até 25 caracteres)
-
Número de telefone
Exemplo de botão:
Ligar para loja
2. URL
Cria um botão que direciona o usuário para um site ou página específica.
Campos necessários:
-
Título do botão (até 25 caracteres)
-
URL completa
Exemplo:
Ver coleção
URL associada:
https://minhaloja.com/colecao
Limites de botões
-
até 2 botões do tipo CTA por template
-
até 25 caracteres no texto do botão
Evite links encurtados como:
-
bit.ly
-
tinyurl
Prefira sempre URLs completas
7. Formatos de mídia aceitos
Templates podem incluir mídia no header.
Imagens
✅ Formatos suportados:
-
JPG
-
JPEG
-
PNG
Limite de tamanho:
-
até 5 MB
Resolução recomendada:
-
mínimo 640 x 360 px
8. Documentação oficial da Meta
As regras técnicas e funcionamento dos templates podem ser consultadas na documentação oficial da Meta:
-
https://developers.facebook.com/docs/whatsapp/message-templates
-
https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates
-
https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates
Essas páginas fazem parte do portal Meta Developers e são a principal referência para implementação técnica.
Grande parte das boas práticas utilizadas no mercado são aprendidas na prática por empresas e parceiros da plataforma.