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.

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.

ComponenteObrigatórioLimite principal
Nome do templateSimApenas minúsculas, números e underline (_)
CategoriaSimUtility, Marketing ou Authentication
Body (corpo)Sim1024 caracteres
CabeçalhoNãoTexto: 60 caracteres. Mídia: ver limites por tipo
Associação de variáveisSomente se houver variáveisCada variável associada a um campo da base
Botões de açãoNão, exceto em AuthenticationVer regras por tipo de botão

Nome do template

Usado apenas para identificação interna do template na Context Cloud e na Meta.

RegraDetalhe
Caracteres permitidosApenas letras minúsculas, números e underline (_)
EspaçosNão permitidos
Caracteres especiaisNã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.

CategoriaUsoExemplos
UtilityAções ou serviços solicitados pelo usuárioConfirmação de pedido, status de entrega, lembrete de consulta
MarketingMensagens promocionais ou campanhas comerciaisPromoções, lançamentos, campanhas de desconto
AuthenticationCódigos de verificação e autenticaçãoCódigo de login, confirmação de identidade

Body (corpo da mensagem)

O body é a única parte obrigatória do template. Limite: 1024 caracteres.

ItemSituação
Texto, emojis, variáveis e formatação simplesPermitido
Iniciar a mensagem com variávelNão permitido
Terminar a mensagem com variávelNão permitido
Duas variáveis consecutivasNão permitido
Mais de 10 emojisNão permitido
Mensagem composta apenas de variáveisNã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.

Cabeçalho

O cabeçalho é opcional e aceita quatro tipos: texto, imagem, vídeo ou documento.

TipoComo é informadoLimite
TextoDigitado no template1024 caracteres. Apenas 1 variável, que não pode abrir nem fechar o texto. Emojis e formatação geralmente não são permitidos(Rodapé 60)
ImagemURL ou upload de arquivoAté 200 KB
VídeoURL ou upload de arquivoAté 16 MB
DocumentoURL ou upload de arquivoAté 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ávelCampo 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ãoO que fazCamposDisponível em
Copiar CódigoCopia o código de verificação enviado no corpo da mensagemTítuloApenas Authentication — e é obrigatório
Resposta RápidaEnvia uma resposta pré-definida de volta para a conversaTítuloMarketing, Utility, Authentication
LigarInicia uma chamada para o telefone informadoTítulo (até 25 caracteres) e númeroMarketing, Utility, Authentication
Visitar URLAbre um site no navegadorTítulo (até 25 caracteres) e URL completaMarketing, Utility, Authentication

Regras aplicáveis a todos os botões:

RegraDetalhe
Texto obrigatórioTodo 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 repetidosDois botões do mesmo template não podem ter o mesmo texto
Limite de caracteres25 caracteres por botão em Ligar e Visitar URL
Limite de botões CTAAté 2 botões de Ligar e Visitar URL por template
Links encurtadosEvite bit.ly, tinyurl e similares em Visitar URL — prefira a URL completa

Exemplos: Ligar para loja (botão Ligar); Ver coleçãohttps://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.

RegraDetalhe
Botão Copiar CódigoObrigatório para salvar um template de autenticação
Disponibilidade do botãoO botão Copiar Código não aparece nas categorias Marketing e Utility
ConteúdoO corpo deve conter o código de verificação, que é o valor copiado pelo botão

Formatos de mídia aceitos

UsoFormatosTamanhoResolução
Imagem no cabeçalhoJPG, JPEG ou PNGAté 200 KBMínimo recomendado: 640×360 px
Vídeo no cabeçalhoMP4, 3GPAté 16 MBIdeal de 1280 x 720 (720p) ou 1920 x 1080 (1080p), Proporção16:9 ou 9:16
Documento no cabeçalhoPDFAté 16 MB1024 x 1024 pixels (proporção quadrada 1:1)

Referências oficiais

As regras completas estão na documentação de Message Templates do portal Meta Developers (WhatsApp Cloud API e Business Management API). Parte das boas práticas descritas aqui vem da experiência prática de empresas e parceiros da plataforma.