Referência
Todos os erros de templates da Meta: e como resolver cada um
Senha incorreta.
Tem a senha deste guia ou da comunidade? A da comunidade vale para todos os materiais.
Quero fazer parte e receber esse tipo de conteúdoTodos os erros de templates da Meta: e como resolver cada um
Referência completa dos erros de aprovação de templates: causas, mensagens da API e como corrigir para aprovar de primeira.
Última atualização: 30 de março de 2026
Como funciona a aprovação de templates
Toda mensagem proativa (fora da janela de 24h) precisa de um template aprovado pela Meta. A revisão é feita por uma combinação de IA e revisão humana.
Tabela completa de erros
Erros de criação (API retorna erro imediato)
| Código | Mensagem | Causa | Solução |
|---|---|---|---|
100 |
Invalid parameter | Parâmetro inválido no body (nome, categoria, idioma) | Verifique se o nome do template usa apenas lowercase, números e underscore. Máximo 512 caracteres. |
2388023 |
Template name already exists | Já existe um template com esse nome na WABA | Use um nome diferente ou delete o template existente antes de recriar. |
2388024 |
Template limit reached | A WABA atingiu o limite de templates (250 por padrão) | Delete templates não utilizados. Solicite aumento de limite se necessário. |
2388046 |
Component format mismatch | O formato dos componentes não corresponde ao tipo declarado | Verifique se o tipo de cada componente (header, body, footer, buttons) corresponde ao formato enviado. |
2388047 |
Invalid header format | O header não está no formato esperado para o tipo escolhido | Para header IMAGE, envie um handle de mídia válido. Para TEXT, máximo 60 caracteres. |
Erros de envio (ao usar o template em produção)
| Código | Mensagem | Causa | Solução |
|---|---|---|---|
132000 |
Template not found | Template não existe, foi deletado ou está com nome/idioma errado | Verifique o name e language.code exatos. Templates deletados retornam este erro. |
132001 |
Template parameters mismatch | Número de parâmetros enviados não corresponde ao template | Confira se todas as variáveis do template estão preenchidas no payload de envio. |
131026 |
Message undeliverable | Mensagem não pôde ser entregue (número inválido, bloqueado ou sem WhatsApp) | Verifique se o número de destino é válido, está no WhatsApp e não bloqueou sua empresa. |
131047 |
Re-engagement message | Tentou enviar mensagem fora da janela de 24h sem template | Use um template aprovado para iniciar conversas fora da janela de 24 horas. |
131048 |
Spam rate limit hit | Muitas mensagens foram marcadas como spam | Reduza o volume e melhore a segmentação. Quality rating provavelmente está vermelho. |
Motivos de rejeição na revisão
Quando um template é rejeitado, a Meta retorna um reason no webhook message_template_status_update. Os valores mais comuns:
| Motivo (reason) | O que a Meta entende | Como resolver |
|---|---|---|
| INCORRECT_CATEGORY | A categoria escolhida não corresponde ao conteúdo | Marketing para promoções, Utility para transações (pedidos, pagamentos), Authentication para OTP. Recategorize e resubmeta. |
| INVALID_FORMAT | Variáveis mal posicionadas ou formato incorreto | Use variáveis nomeadas ( |
| SCAM | Conteúdo que se assemelha a golpe ou phishing | Não use linguagem que peça dados bancários, senhas ou pagamentos via link suspeito. Evite urgência falsa ("ÚLTIMA CHANCE"), promessas irreais ou imitação de mensagens do WhatsApp/Meta. |
| ABUSIVE_CONTENT | Conteúdo ofensivo, discriminatório ou adulto | Revise o tom da mensagem. Evite temas sensíveis: política, religião, saúde, finanças pessoais sem contexto claro. |
| NONE | Motivo não especificado (revisão humana genérica) | Revise o template por inteiro: contexto, tom, variáveis, e se o opt-in está claro para templates de marketing. Adicione "Você se inscreveu para receber nossas ofertas." se for promoção. |
Templates pausados: A Meta pode pausar templates aprovados se o quality rating cair. O status muda para PAUSED. Ao ser pausado, o template para de funcionar até que o quality rating melhore e a Meta o reative automaticamente. Monitore o webhook message_template_status_update para detectar pausas.
Boas práticas para aprovação rápida
Estrutura de um template que aprova de primeira
- Header claro: identifique o assunto. Ex: "Confirmação de pedido" em vez de "Novidade!"
- Body contextualizado: comece com contexto. Ex: "Olá , seu pedido # foi confirmado."
- Variáveis nomeadas com exemplos: use nomes descritivos (
,) e sempre forneça exemplos realistas ao submeter - CTA relevante: botões devem fazer sentido com o conteúdo
- Footer com opt-out: inclua opção de parar de receber (para marketing)
Regra de ouro: Se você lesse a mensagem como destinatário, ficaria claro quem está mandando, por que está mandando, e como parar de receber? Se sim, o template vai passar.
Categorias e quando usar cada uma
template?"} A -->|Promo / oferta| B["MARKETING"] A -->|Pedido / status| C["UTILITY"] A -->|OTP / login| D["AUTHENTICATION"] B --> E["Opt-in explícito"] C --> F["Sem opt-in extra"] D --> G["Fluxo OTP padrão"]
Exemplos mínimos (contexto ao ler erros e categorias)
Os três modelos abaixo servem para visualizar marketing, utilidade e autenticação ao interpretar rejeições e códigos. A biblioteca por nicho (dezenas de variações para copiar) está em Curadoria de templates aprovados por nicho (em breve).
Marketing: Promoção
Utility: Confirmação de pedido
Authentication: OTP
Edição de templates: A Meta permite editar templates já aprovados (body, header, footer e botões). A edição envia o template para nova revisão. Durante a revisão, o template original continua funcionando. Se a edição for rejeitada, o template volta ao estado anterior.
Dica: Templates de Authentication têm aprovação quase instantânea quando seguem o formato padrão da Meta. Não customize demais.