Template reprovado no WhatsApp: os motivos que a Meta registra e como recorrer

Template reprovado costuma virar tentativa e erro: muda uma palavra, submete de novo, reprova de novo, muda outra, e assim por três dias.

Não precisa ser assim. A Meta devolve o motivo junto com a reprovação — um código no campo reason do webhook message_template_status_update. E cada código aponta um problema completamente diferente. Corrigir sem olhar esse código é reescrever o texto quando o problema era a categoria, ou trocar a categoria quando o problema era uma chave faltando.

Primeiro: descubra o código

Antes de reescrever qualquer coisa, encontre o motivo. Ele chega por três caminhos: o alerta no WhatsApp Manager, o e-mail para os administradores e o webhook message_template_status_update, com event igual a REJECTED e o motivo no campo reason.

Se a sua plataforma não te mostra esse campo, você está adivinhando — e é por isso que muita gente acha que aprovação de template é loteria. Não é.

INVALID_FORMAT — é forma, não conteúdo

O mais frequente, e o mais fácil de resolver, porque não tem nada a ver com o que você escreveu.

As causas documentadas:

• Chaves de variável desemparelhadas. {{1} em vez de {{1}}.
• Caracteres especiais dentro do parâmetro, como #, $ ou %.
• Parâmetros fora de ordem sequencial. Pular de {{1}} para {{3}} reprova.
• Variáveis demais para o tamanho da mensagem.
• Template duplicado de um que já existe.
• O template começa ou termina com um parâmetro.

Esse último derruba muita gente boa, e é contraintuitivo. A documentação diz, com todas as letras, que “the message template cannot start or end with a parameter”.

Ou seja, isto reprova:

{{1}}, seu pedido foi confirmado.

E isto passa:

Olá, {{1}}! Seu pedido foi confirmado.

A diferença é uma palavra antes da variável. Vale conferir também o fim do texto: terminar com {{2}} tem o mesmo efeito.

INCORRECT_CATEGORY e TAG_CONTENT_MISMATCH — a categoria não bate

Estes dois dizem a mesma coisa por caminhos diferentes: o conteúdo não corresponde à categoria em que você submeteu.

Aqui mora a tentação mais cara do WhatsApp. Como marketing custa cerca de nove vezes mais que utilidade no Brasil, existe um incentivo enorme para submeter conteúdo promocional como utilidade. A revisão da Meta é feita justamente para isso, e devolve esses códigos.

A correção certa é submeter na categoria correta, não reescrever para disfarçar. Tentar disfarçar tem três problemas: costuma falhar, gasta tentativa, e classificação errada de template aparece entre as causas de restrição de conta — não é só uma questão de tarifa. Falamos das categorias em marketing, utilidade ou autenticação e do custo em quanto custa a API Oficial.

PROMOTIONAL — a oferta onde ela não cabe

Este é o irmão mais específico do anterior, e o exemplo é sempre o mesmo:

“Seu pedido saiu para entrega e chega hoje. Aproveite 20% de desconto na próxima compra com o cupom VOLTA20.”

A primeira frase é utilidade perfeita. A segunda é o que reprova.

A correção não é remover a segunda frase e desistir da promoção — é separar as duas coisas. Aviso operacional em template de utilidade, promoção em template de marketing, cada um com o seu custo e o seu momento. Misturar economiza um envio e custa a aprovação.

ABUSIVE_CONTENT e SCAM — pare antes de tentar de novo

Estes dois são de outra natureza. Não são erro de formatação nem de classificação: a Meta está dizendo que o conteúdo viola políticas.

A recomendação aqui é o oposto da anterior: não resubmeta variações rapidamente. Revise o conteúdo contra as políticas de comércio e de negócios, entenda o que disparou o sinal, e só então volte. Insistir com variações de um conteúdo sinalizado como abusivo ou golpe é o caminho para escalar de reprovação de template para restrição de conta — assunto de conta restrita na API Oficial.

Vale também um cuidado que a documentação registra e que pega negócios legítimos: não peça identificadores sensíveis no template. Solicitar dados como documento ou informação de pagamento dentro da mensagem é um padrão que a revisão trata com rigor, porque é exatamente o que golpe faz.

Como recorrer, em 24 horas

Reprovação não é ponto final. O caminho documentado:

1. Vá em Message Templates, no WhatsApp Manager.
2. Edite o conteúdo do template.
3. Use o botão Add Sample e adicione valores de exemplo para as variáveis e para as imagens.
4. Submeta.

A documentação informa que a apelação é revisada e decidida em até 24 horas — o mesmo prazo da análise original.

Repare no passo 3, porque ele é a parte que mais gente pula: amostras. Um template com {{1}} e {{2}} sem exemplos preenchidos obriga o revisor a adivinhar o que vai ali. Preencher com valores realistas — não “teste” e “123” — resolve uma parcela grande das reprovações, especialmente as de formato e de categoria, porque mostra a intenção real da mensagem.

Os outros estados que aparecem no caminho

Reprovado não é o único jeito de um template parar de funcionar. O webhook registra vários eventos, e vale reconhecer os principais:

Dois merecem atenção especial.

FLAGGED é o aviso antes do problema. Ele indica feedback negativo acumulado e risco de pausa. Quem monitora esse evento consegue agir antes de o template parar; quem não monitora descobre quando a campanha não sai. O ciclo de pausa está detalhado em template pausado no WhatsApp.

ARCHIVED pega quem tem template sazonal. Arquivamento por inatividade significa que aquele template de Black Friday que você usa uma vez por ano pode não estar disponível quando você precisar. Vale conferir antes da campanha, não no dia.

O que fazer para reprovar menos

Escreva pensando na categoria antes de escrever o texto. Decidir “isto é utilidade” primeiro evita a frase promocional que entra sem querer no final.

Nunca comece nem termine com variável. Regra fixa, custo zero.

Preencha amostras realistas sempre, mesmo na primeira submissão.

Tenha os templates prontos antes de precisar. Até 24 horas para aprovar significa que criar template no dia da campanha é apostar. Isso vale em dobro para o template de reengajamento que você vai querer usar dentro da janela de 72 horas do anúncio.

Guarde os aprovados como modelo. Padrão que passou tende a passar de novo — e evita o INVALID_FORMAT por duplicidade quando alguém recria algo parecido.

Onde a gente entra

Nada aqui é difícil. O que é difícil é descobrir sozinho, uma reprovação por vez, enquanto a campanha espera.

Com o AtendeChat, você não submete template no escuro: somos parceiros oficiais da Meta e conduzimos com você a redação e a aprovação dos templates, cuidando da categoria — que decide preço e aprovação ao mesmo tempo — e do formato que reprova por detalhe.

E a operação em volta acompanha: vários atendentes no mesmo número, fila, histórico centralizado, funil e relatórios, para você ver o que foi entregue e o que falhou, com o motivo, em vez de concluir que “a campanha foi mal”.

Se você tem template preso na fila ou reprovado sem entender o porquê, fale com a gente — costuma ser meia hora de conversa e um detalhe de formato.