Modelos de mensagem na API do WhatsApp: categorias, aprovação e erros comuns

Quem começa a usar a API oficial do WhatsApp logo percebe uma diferença em relação ao aplicativo: quando a empresa quer iniciar a conversa, ou retomá-la depois de um tempo sem resposta do cliente, a mensagem precisa sair de um modelo previamente aprovado pela Meta. É aqui que muitos projetos travam: modelos reprovados sem motivo claro, avisos que viram "marketing" da noite para o dia, botões que não aparecem no computador do cliente. Este guia explica as regras e mostra, com exemplos, o que costuma dar certo e o que costuma dar errado.

O que é um modelo de mensagem e quando ele é obrigatório

Um modelo (em inglês, message template) é um texto cadastrado na conta do WhatsApp Business Platform, revisado pela Meta e reutilizado em muitos envios. Ele tem partes fixas e variáveis, que são preenchidas no momento do envio: o nome do cliente, o número do pedido, a data de uma consulta.

A obrigatoriedade está ligada à janela de atendimento. Quando o cliente manda uma mensagem, abre-se um período em que a empresa pode responder livremente, sem modelo. Fora desse período, a única forma de falar com o cliente é por um modelo aprovado. O funcionamento dessa janela está detalhado em A janela de 24 horas do WhatsApp Business Platform explicada. Na prática, quase toda comunicação ativa passa por modelos: confirmação de pedido, lembrete de consulta, aviso de boleto, código de verificação, promoção.

A anatomia de um modelo

Todo modelo tem nome, idioma, categoria e componentes. O nome aceita apenas letras minúsculas, números e sublinhado (por exemplo, lembrete_consulta_v2). A Meta não traduz nada: quem atende em português e espanhol cadastra o texto nos dois idiomas, e cada versão conta no limite de modelos da conta.

• Cabeçalho (opcional): texto curto ou mídia, como imagem, vídeo ou documento. A mídia de exemplo enviada no cadastro também é revisada.
• Corpo (obrigatório): o texto principal, onde ficam a maior parte das informações e das variáveis.
• Rodapé (opcional): uma linha discreta, como "Responda SAIR para não receber mais avisos".
• Botões (opcionais): respostas rápidas, links, ligação, cópia de código e outros tipos.

Os principais limites, segundo a documentação de componentes da Meta:

Esses limites mudam de tempos em tempos; confira a documentação antes de desenhar um modelo no limite.

As três categorias: utilidade, marketing e autenticação

A categoria não é só uma etiqueta: ela influencia o preço de cada mensagem, os limites de envio e a forma como a Meta avalia o conteúdo. Desde julho de 2025 a Meta cobra por mensagem de modelo entregue, com valores que dependem da categoria e do país do destinatário, e as regras de gratuidade já mudaram mais de uma vez desde então. Por isso, consulte a página de preços oficial em vez de confiar em tabelas antigas ou em valores repassados por terceiros.

Utilidade

Mensagens que dão continuidade a algo que o cliente fez ou pediu. Pelas diretrizes de categorização da Meta, um modelo de utilidade precisa ser não promocional e, ao mesmo tempo, específico para o usuário (o pedido, a conta, a transação dele) ou essencial para ele, como um alerta de segurança. Exemplos: confirmação de pedido, atualização de entrega, aviso de reembolso, lembrete de consulta agendada.

Marketing

A categoria mais flexível, que recebe tudo o que não se encaixa nas outras: promoções, lançamentos, carrinho abandonado, convites, cupons e mensagens que tentam convencer o cliente a renovar uma assinatura. Um ponto que surpreende muita gente: conteúdo misto é marketing. Se um aviso de envio traz um cupom para a próxima compra, o modelo inteiro passa a ser tratado como marketing. O mesmo vale para textos vagos, que não deixam claro do que se trata, como um "Parabéns!" seguido de uma variável.

A fronteira costuma estar na intenção, não no assunto. "Sua mensalidade de {{1}} será cobrada em {{2}} no cartão cadastrado" é um aviso neutro de cobrança e pode ser utilidade. "Sua assinatura vence em {{1}}! Renove hoje e ganhe desconto" busca a renovação com uma oferta e é marketing.

Autenticação

Exclusiva para códigos de verificação de uso único, como os enviados no login. Modelos de marketing e utilidade não podem carregar esses códigos. Os de autenticação seguem formato padronizado, com botão para copiar ou preencher automaticamente o código, e não aceitam URLs, mídia nem emojis. O próprio parâmetro do código tem limite de 15 caracteres.

Variáveis: como funcionam e onde dão problema

A API aceita dois formatos de variável:

• Posicionais: numeradas a partir de 1, como {{1}} e {{2}}. Os valores enviados precisam seguir essa ordem.
• Nomeadas: nomes em minúsculas com sublinhado, como {{nome_cliente}}. São mais fáceis de manter, porque o sistema que envia não depende da ordem.

Cada variável exige um valor de exemplo no cadastro, e ele é lido na revisão. "teste" ou "xxx" atrapalham; "Mariana" e "12/11" mostram ao revisor o que de fato será enviado. Os erros mais comuns, citados na página de revisão de modelos, são:

• Variável no começo ou no fim do texto. "{{1}}, seu pedido saiu" tende a ser reprovado. Basta cercar a variável de texto fixo: "Olá, {{1}}! Seu pedido saiu."
• Muitas variáveis para pouco texto. Quatro variáveis e dez palavras fixas parecem um modelo "em branco", capaz de transportar qualquer conteúdo.
• Numeração fora de ordem. Pular de {{2}} para {{5}} gera reprovação.
• Chaves desbalanceadas ou caracteres especiais. Erros como "{1}}" e variáveis com #, $ ou % são recusados.

Um teste simples: leia o modelo trocando todas as variáveis por "___". Se ainda der para entender a mensagem, a proporção está boa.

Botões: o que cada tipo resolve

• Resposta rápida: o texto do botão volta para a empresa como mensagem. Ideal para "Confirmar", "Remarcar" e "Falar com atendente". A resposta do cliente abre a janela de atendimento.
• Link: abre uma página; a parte variável fica no final da URL, como em https://loja.exemplo.com.br/pedido/{{1}}.
• Telefone: inicia uma ligação para o número cadastrado.
• Copiar código: no máximo um por modelo; útil para cupons em modelos de marketing.

Quando o modelo mistura respostas rápidas com outros tipos de botão, as respostas rápidas precisam ficar agrupadas, todas antes ou todas depois dos demais; caso contrário, a API devolve erro. Segundo a Meta, modelos com quatro ou mais botões, ou que misturam respostas rápidas com outros tipos, não aparecem no WhatsApp para computador: o destinatário é orientado a abrir a mensagem no celular. Se parte do público usa o WhatsApp Web no trabalho, mantenha poucos botões. E escreva rótulos que digam o que acontece: "Ver pedido" é melhor que "Clique aqui".

Como funciona a revisão

A revisão acontece quando o modelo é criado ou editado e é, em grande parte, automatizada. Muitas vezes o resultado sai em minutos, mas a Meta informa que a decisão pode levar até 24 horas. Os status que importam no dia a dia:

• Em análise: ainda não pode ser enviado.
• Aprovado: pronto para uso. No início, a qualidade aparece como pendente, porque ainda não há reação suficiente dos clientes para avaliá-lo.
• Reprovado: pode ser corrigido e reenviado, ou contestado. A contestação precisa incluir um exemplo de mensagem.
• Pausado: acontece quando o modelo atinge a classificação de qualidade mais baixa. Na primeira vez, a pausa dura 3 horas; na segunda, 6 horas. Enquanto isso, os envios são recusados (sem cobrança).
• Desativado: é o que ocorre na terceira vez que o modelo cairia em pausa. Para voltar a usá-lo, é preciso editá-lo e submetê-lo a nova aprovação.

A qualidade de cada modelo aprovado é calculada a partir dos retornos negativos dos clientes (como bloqueios e denúncias) e da taxa de leitura. A pausa existe justamente para proteger a qualidade dos números que usam o modelo, tema de Qualidade do número e limites de mensagens no WhatsApp Business Platform. Se um modelo de campanha estiver sendo pausado, interrompa os disparos automáticos que dependem dele e revise o texto e o público antes de retomar.

Há ainda limites de volume. Contas ligadas a um portfólio empresarial não verificado podem ter até 250 modelos; com o portfólio verificado, o teto sobe para 6.000. Lembre-se de que cada idioma de um mesmo modelo conta separadamente. A Meta também arquiva automaticamente modelos sem uso há 12 meses ou mais, e os arquivados são excluídos depois de 28 dias se não forem recuperados. Na prática, vale fazer uma faxina periódica na biblioteca e eliminar versões de teste esquecidas.

Recategorização: quando a Meta muda a categoria

A categoria escolhida é conferida na criação e depois dela. Desde abril de 2025, um modelo enviado como utilidade que a Meta considere marketing não é reprovado: ele é aprovado diretamente como marketing. Além disso, a Meta revisa de forma recorrente os modelos já aprovados e pode reclassificá-los; pela API, a nova categoria passa a valer no primeiro dia do mês seguinte, com aviso prévio por e-mail, webhook e banner no WhatsApp Manager.

O modelo continua funcionando, mas passa a ser cobrado como marketing e a seguir as regras dessa categoria, inclusive os limites de mensagens de marketing por pessoa. Segundo a documentação de categorização, a empresa tem 60 dias para contestar a mudança pelo Business Support Home. Quem insiste em classificar marketing como utilidade enfrenta restrições progressivas: primeiro um aviso (e as mudanças de categoria passam a ser imediatas), depois limite de volume para mensagens de utilidade e, em casos persistentes, a conversão temporária de todos os modelos de utilidade da conta em marketing.

Os gatilhos mais comuns são frases de venda em mensagens de serviço ("aproveite", "não perca", "confira nossas ofertas"), sugestões de produtos relacionados, lembretes de renovação e pesquisas de satisfação genéricas, sem ligação com um atendimento específico.

Motivos frequentes de reprovação

1. Conteúdo duplicado. Corpo e rodapé iguais aos de outro modelo da conta.
2. Pedido de dados sensíveis. Número completo de cartão, conta bancária ou documento de identidade. Pedir só os últimos dígitos é aceito.
3. Tom ameaçador ou constrangedor. Cobrança que ameaça processo ou exposição pública. Cobrar é permitido, com linguagem informativa.
4. Produtos ou serviços proibidos. Conteúdo que viola as políticas comerciais do WhatsApp.
5. Código de verificação fora da categoria autenticação. Só modelos de autenticação podem enviar senhas de uso único.
6. Problemas de formatação das variáveis. Chaves faltando, caracteres especiais, numeração fora de ordem, variável no início ou no fim e excesso de variáveis para pouco texto, como detalhado acima. Exemplos pouco realistas também dificultam a avaliação.

Como o motivo informado na reprovação costuma ser genérico, mantenha um registro interno: texto enviado, resultado e o que mudou na tentativa seguinte. Em poucas semanas a equipe aprende o que funciona para o seu tipo de negócio.

Exemplos de bons e maus modelos

Os cenários abaixo são fictícios, baseados em situações comuns em empresas brasileiras.

Loja de autopeças: aviso de envio

Versão problemática (enviada como utilidade):

{{1}}, seu pedido saiu! Aproveite e confira as ofertas de pneus desta semana com até 20% off 🚗🔥

Começa com variável e mistura aviso com oferta. Mesmo corrigido o início, seria tratado como marketing.

Versão melhor (utilidade):

Olá, {{1}}. Seu pedido {{2}} foi enviado hoje e a previsão de entrega é {{3}}. Você pode acompanhar o trajeto pelo botão abaixo.

Botão de link: "Acompanhar entrega". A oferta de pneus vai para um modelo de marketing separado, enviado só a quem aceitou receber promoções.

Clínica odontológica: lembrete de consulta

Versão problemática:

Lembrete: {{1}} {{2}} {{3}}

Três variáveis seguidas e nenhuma pista do conteúdo real: o típico modelo "em branco" que a revisão recusa.

Versão melhor:

Olá, {{1}}. Sua consulta com {{2}} está marcada para {{3}}. Se não puder comparecer, avise por aqui para liberarmos o horário.

Botões de resposta rápida: "Confirmar" e "Preciso remarcar". Qualquer das respostas abre a janela de atendimento, e a automação trata cada caso.

Distribuidora: boleto em aberto

Versão problemática:

ÚLTIMO AVISO. Pague o boleto {{1}} hoje ou seu CNPJ será negativado e tomaremos as medidas judiciais cabíveis.

Ameaça, letras maiúsculas e pressão: forte candidata à reprovação e, se passar, a bloqueios.

Versão melhor:

Olá, {{1}}. O boleto da nota {{2}}, com vencimento em {{3}}, ainda consta em aberto. Se o pagamento já foi feito, desconsidere esta mensagem. Para receber a segunda via ou combinar uma nova data, use os botões abaixo.

Informativa, com saída para quem já pagou e caminho claro para resolver. Mais sobre esse tipo de texto em Como escrever mensagens automáticas que as pessoas entendem.

Checklist antes de enviar para revisão

• O modelo tem um objetivo único (avisar, lembrar, vender ou autenticar) e a categoria corresponde a ele.
• O texto não começa nem termina com variável.
• As variáveis estão em sequência, com chaves corretas e exemplos realistas.
• Dá para entender a mensagem sem as variáveis.
• Não há pedido de dados completos de cartão, conta ou documento.
• O tom é cordial, sem ameaças nem urgência artificial.
• Os botões dizem o que fazem e não passam de três, se o público usa o WhatsApp no computador.
• O destinatário consentiu em receber esse tipo de mensagem.

Sobre o último item: a aprovação do modelo não autoriza o envio para qualquer pessoa. A Meta exige opt-in, e a LGPD exige base legal para o tratamento dos dados. Veja como obter e registrar esse consentimento em Opt-in no WhatsApp: como pedir consentimento antes de enviar mensagens.

Perguntas frequentes

Posso editar um modelo já aprovado?

Sim, com limites. Modelos aprovados podem ser editados no máximo uma vez a cada 24 horas e até 10 vezes em 30 dias; a categoria de um modelo aprovado não pode ser alterada. Toda edição passa por nova revisão. Em fluxos críticos, como lembretes diários, é mais seguro criar uma nova versão com outro nome, esperar a aprovação e só então trocar o modelo usado pelo sistema.

Se o cliente responder ao modelo, posso continuar a conversa livremente?

Sim. A resposta abre a janela de atendimento, e durante ela a empresa envia mensagens livres. Encerrada a janela, volta a ser necessário usar um modelo.

Por que um modelo de utilidade virou marketing?

Porque a Meta reavalia os modelos aprovados. Em geral, a mudança vem de trechos promocionais, sugestão de produtos ou falta de relação clara com uma ação do cliente. Dá para contestar pelo Business Support Home em até 60 dias; se a reclassificação estiver correta, separe o conteúdo em dois modelos.

Conclusão

Modelos de mensagem são a porta de entrada de toda comunicação ativa na API do WhatsApp. Quem entende as três categorias, cerca as variáveis de contexto e separa aviso de oferta enfrenta bem menos reprovações. O resto é disciplina: registrar o que foi testado, enxugar a biblioteca de tempos em tempos e acompanhar a qualidade de cada modelo em uso.

Se a sua empresa está criando os primeiros modelos ou precisa organizar uma biblioteca que cresceu sem padrão, a Telep pode ajudar a desenhar os textos junto com o fluxo de atendimento. Veja como trabalhamos ou fale com a equipe pela página de contato.