Template (modelo de mensagem) do WhatsApp

As três categorias — e por que elas importam

A categoria é declarada por você na criação e confirmada pela Meta. Ela define o preço da mensagem e as regras de opt-out:

• Marketing — promoções, ofertas, novidades, conteúdo promocional. É a categoria mais cara e a única que exige oferecer saída (opt-out) ao cliente.
• Utilidade — confirmações, atualização de pedido, cobrança, lembrete de agendamento. Custa uma fração do marketing.
• Autenticação — código de verificação e confirmação em duas etapas.

Os valores por categoria estão na página de custo da WhatsApp Business API, com a tabela oficial da Meta para o Brasil e a data de vigência.

Os status pelos quais um template passa

Pendente, aprovado, rejeitado, pausado, desabilitado, em recurso e excluído. Só o aprovado pode ser enviado — e o status muda sozinho: a Meta avisa por webhook e a plataforma atualiza o template sem ninguém precisar conferir.

Os limites de formato que reprovam antes da Meta

• Corpo: até 1.024 caracteres.
• Cabeçalho de texto e rodapé: até 60 caracteres cada.
• Botões: até 10 no total, sendo no máximo 3 de resposta rápida e 2 de URL, com até 25 caracteres cada.
• Variáveis: até 10 por componente.

O detalhe que derruba campanha: o limite conta o texto JÁ preenchido

Os 1.024 caracteres valem para o texto renderizado — corpo do template mais o conteúdo das variáveis —, não para cada variável isolada. Medimos contra a API da Meta em 29 de julho de 2026, com um template de corpo fixo de 53 caracteres: uma variável de 971 caracteres (total de 1.024) foi aceita e 972 (total de 1.025) foi recusada com o erro 132005 — Translated text too long.

Na prática: um template curto com um campo longo (histórico, descrição de produto, lista de itens) estoura sem aviso. A plataforma corta o valor no limite antes de enviar, para o disparo não ser perdido.

Qualidade e recategorização

A Meta atribui uma nota de qualidade a cada template — verde, amarelo ou vermelho — baseada em bloqueios e denúncias de quem recebe. No vermelho, o risco de suspensão é alto, e a plataforma bloqueia o envio daquele template.

A Meta também pode mudar a categoria de um template já aprovado (de utilidade para marketing, por exemplo), o que altera preço e regras. Quando isso acontece, as campanhas em andamento que usam aquele template são pausadas automaticamente para revisão — em vez de continuarem gastando com um preço que você não aprovou.

O erro comum: classificar marketing como utilidade

Como marketing é mais caro, é tentador declarar uma promoção como "confirmação". A Meta recategoriza ou reprova, e o resultado é pior do que pagar a diferença: campanha pausada no meio, template com nota baixa e, na reincidência, risco para a conta.

Termos relacionados

• Janela de 24 horas — o prazo que torna o template obrigatório.
• Erro 131047 — a recusa da Meta quando se tenta texto livre no lugar do template.
• WABA — a conta onde os templates ficam guardados; eles pertencem a ela, não ao número.
• Erro 131042 — pendência de pagamento; nesse caso nem o template aprovado sai.