Referência — regras e limites para templates de WhatsApp
Regras técnicas e limites para criação de templates de mensagem no WhatsApp Business. Templates são mensagens pré-aprovadas pela Meta; a revisão é automática, e seguir estas regras aumenta as chances de aprovação. As regras são definidas pela Meta e podem mudar sem aviso prévio.
Onde ficam os templates
Os templates de WhatsApp são gerenciados no módulo Templates WhatsApp, em Conteúdo > Templates WhatsApp. Esse módulo concentra os modelos de mensagem usados nos envios pelo canal WhatsApp.
O envio dos templates para a Meta é feito pela integração Inngage WhatsApp Oficial, ativada na App Store. Sem a integração ativa, não há como submeter templates para aprovação.
Por que o template é obrigatório
Para iniciar uma conversa com o cliente — a chamada mensagem ativa — a Meta exige que a empresa use um template pré-aprovado. A regra vale para toda campanha de marketing, notificação de pedido ou lembrete disparado pela Context Cloud. A aprovação avalia a categoria e o conteúdo da mensagem. Somente templates com status Aprovado ficam disponíveis para uso em campanhas.
Colunas da lista de templates
A lista em Conteúdo > Templates WhatsApp exibe as colunas abaixo.
| Coluna | O que mostra |
|---|---|
| Nome | Identificador interno do template |
| Categoria | Classificação junto à Meta, que define regras e custos |
| Status | Estágio de aprovação do template |
| Criada em | Data de criação do template |
Status do template
| Status | Significado |
|---|---|
| Aprovado | Template liberado pela Meta e disponível para uso em campanhas |
| Em análise | Template submetido, aguardando revisão da Meta |
| Rejeitado | Template reprovado pela Meta; não pode ser usado em campanhas |
| Erro | Falha no cadastro ou no envio do template; não pode ser usado em campanhas |
Estrutura de um template
Um template é composto por: nome, categoria, body (corpo da mensagem), cabeçalho, associação de variáveis e botões de ação.
| Componente | Obrigatório | Limite principal |
|---|---|---|
| Nome do template | Sim | Apenas minúsculas, números e underline (_) |
| Categoria | Sim | Utility, Marketing ou Authentication |
| Body (corpo) | Sim | 1024 caracteres |
| Cabeçalho | Não | Texto: 60 caracteres. Mídia: ver limites por tipo |
| Associação de variáveis | Somente se houver variáveis | Cada variável associada a um campo da base |
| Botões de ação | Não, exceto em Authentication | Ver regras por tipo de botão |
Nome do template
Usado apenas para identificação interna do template na Context Cloud e na Meta.
| Regra | Detalhe |
|---|---|
| Caracteres permitidos | Apenas letras minúsculas, números e underline (_) |
| Espaços | Não permitidos |
| Caracteres especiais | Não permitidos |
| Palavra "teste" | Não permitida |
Exemplos válidos: nova_colecao, confirmacao_pedido, lembrete_consulta.
Categoria
Define o tipo de comunicação da mensagem. A categoria também determina quais botões de ação ficam disponíveis e o custo do envio junto à Meta.
| Categoria | Uso | Exemplos |
|---|---|---|
| Utility | Ações ou serviços solicitados pelo usuário | Confirmação de pedido, status de entrega, lembrete de consulta |
| Marketing | Mensagens promocionais ou campanhas comerciais | Promoções, lançamentos, campanhas de desconto |
| Authentication | Códigos de verificação e autenticação | Código de login, confirmação de identidade |
Body (corpo da mensagem)
O body é a única parte obrigatória do template. Limite: 1024 caracteres.
| Item | Situação |
|---|---|
| Texto, emojis, variáveis e formatação simples | Permitido |
| Iniciar a mensagem com variável | Não permitido |
| Terminar a mensagem com variável | Não permitido |
| Duas variáveis consecutivas | Não permitido |
| Mais de 10 emojis | Não permitido |
| Mensagem composta apenas de variáveis | Não permitido |
Exemplo válido: Olá {{1}}, seu pedido {{2}} foi enviado.
Exemplo inválido: {{1}}, seu pedido foi enviado. — a mensagem abre com variável.
Formatação de texto no template
O WhatsApp usa uma sintaxe própria de formatação, simplificada. Não é Markdown nem HTML: **negrito** com dois asteriscos, títulos, links em [texto](url), imagens e tabelas não funcionam no corpo de um template. Em templates aprovados pela Meta, as regras são mais restritas do que em uma conversa comum do WhatsApp.
| Recurso | Sintaxe | Suporte em template |
|---|---|---|
| Negrito | *texto* | Sim |
| Itálico | _texto_ | Sim |
| Riscado | ~texto~ | Sim |
| Monoespaçado | ```texto``` | Sim |
Lista (- ou 1.) | - item / 1. item | Parcial — varia por versão da API e por cliente |
| Citação | > texto | Parcial — apenas em versões mais recentes da Cloud API |
| Título | — | Não existe |
| Link formatado | [texto](url) | Não existe — use a URL completa ou um botão de ação |
| Imagem no corpo | — | Não existe — use o cabeçalho de mídia |
| Tabela | — | Não existe |
Os estilos podem ser empilhados no mesmo trecho, aplicando os símbolos em camadas. Exemplo: *~_texto_~* resulta em negrito, itálico e riscado ao mesmo tempo.
A formatação não é aplicada dentro de variáveis ({{1}}, {{2}} etc.). O valor que vem do campo da base entra sem negrito, itálico ou qualquer outro estilo. Para destacar um trecho que contém variável, aplique os símbolos fora do marcador — por exemplo, *Pedido {{1}}* formata a palavra e o valor juntos.
A Meta pode reprovar um template por formatação excessiva ou usada de forma enganosa — por exemplo, simular um botão usando asteriscos. Use a formatação para destacar informação, não para imitar elementos de interface.
Cabeçalho
O cabeçalho é opcional e aceita quatro tipos: texto, imagem, vídeo ou documento.
| Tipo | Como é informado | Limite |
|---|---|---|
| Texto | Digitado no template | 60 caracteres. Apenas 1 variável, que não pode abrir nem fechar o texto. Emojis e formatação geralmente não são permitidos |
| Imagem | URL ou upload de arquivo | Até 200 KB |
| Vídeo | URL ou upload de arquivo | Até 16 MB |
| Documento | URL ou upload de arquivo | Até 16 MB |
Exemplo de cabeçalho de texto: Atualização do pedido.
Nos cabeçalhos de mídia, o arquivo informado no cadastro do template serve como exemplo para a revisão da Meta. No envio real, a mídia é dinâmica — ela é fornecida no momento do disparo da campanha, respeitando os mesmos limites de tamanho.
Associação de variáveis
As variáveis ({{1}}, {{2}}...) personalizam a mensagem por usuário. Depois de criá-las no body, associe cada uma a um campo da base de dados da Context Cloud; os dados são preenchidos automaticamente no disparo.
Exemplo para o template Olá {{1}}, seu pedido {{2}} foi enviado.:
| Variável | Campo da base |
|---|---|
{{1}} | nome |
{{2}} | numero_pedido |
Com nome = Ana e numero_pedido = 4589, o contato recebe: Olá Ana, seu pedido 4589 foi enviado.
Botões de ação
Botões de ação (CTA) são exibidos abaixo da mensagem. A Context Cloud oferece quatro tipos, e a disponibilidade depende da categoria do template.
| Botão | O que faz | Campos | Disponível em |
|---|---|---|---|
| Copiar Código | Copia o código de verificação enviado no corpo da mensagem | Título | Apenas Authentication — e é obrigatório |
| Resposta Rápida | Envia uma resposta pré-definida de volta para a conversa | Título | Marketing, Utility, Authentication |
| Ligar | Inicia uma chamada para o telefone informado | Título (até 25 caracteres) e número | Marketing, Utility, Authentication |
| Visitar URL | Abre um site no navegador | Título (até 25 caracteres) e URL completa | Marketing, Utility, Authentication |
Regras aplicáveis a todos os botões:
| Regra | Detalhe |
|---|---|
| Texto obrigatório | Todo botão adicionado precisa ter texto. Um botão em branco impede salvar o template — remova o botão se não for usá-lo |
| Textos não repetidos | Dois botões do mesmo template não podem ter o mesmo texto |
| Limite de caracteres | 25 caracteres por botão em Ligar e Visitar URL |
| Limite de botões CTA | Até 2 botões de Ligar e Visitar URL por template |
| Links encurtados | Evite bit.ly, tinyurl e similares em Visitar URL — prefira a URL completa |
Exemplos: Ligar para loja (botão Ligar); Ver coleção → https://minhaloja.com/colecao (botão Visitar URL).
Regras específicas do template de autenticação
Templates da categoria Authentication têm uma exigência própria: o botão Copiar Código é obrigatório. Sem ele, o template não pode ser salvo.
| Regra | Detalhe |
|---|---|
| Botão Copiar Código | Obrigatório para salvar um template de autenticação |
| Disponibilidade do botão | O botão Copiar Código não aparece nas categorias Marketing e Utility |
| Conteúdo | O corpo deve conter o código de verificação, que é o valor copiado pelo botão |
Formatos de mídia aceitos
| Uso | Formatos | Tamanho | Resolução |
|---|---|---|---|
| Imagem no cabeçalho | JPG, JPEG ou PNG | Até 200 KB | Mínimo recomendado: 640×360 px |
| Vídeo no cabeçalho | MP4, 3GP | Até 16 MB | Ideal 1280×720 (720p) ou 1920×1080 (1080p), proporção 16:9 ou 9:16 |
| Documento no cabeçalho | Até 16 MB | 1024×1024 px (proporção 1:1) |
