Sua integração para de enviar, o log cospe um número de cinco dígitos e você tem que decidir rápido: é problema meu, é problema do cliente, ou é a Meta?
Este guia traduz os códigos mais frequentes direto da documentação oficial. E começa por uma correção que importa, porque leva gente a depurar o problema errado.
A confusão do 132000
Boa parte do conteúdo em português — inclusive material de suporte de plataformas conhecidas — descreve o 132000 como “template não encontrado”.
A documentação da Meta diz outra coisa:
132000 — The number of variable parameter values included in the request did not match the number of variable parameters defined in the template.
Ou seja: 132000 é divergência na contagem de parâmetros. Seu template tem três variáveis e você mandou duas, ou mandou quatro.
Template inexistente ou não aprovado é o 132001.
A diferença é prática. Quem lê “template não encontrado” vai conferir nome, idioma e status de aprovação — e não vai achar nada, porque o template está lá. O problema está na chamada.
Erro temporário x erro permanente
Antes da lista, a distinção que economiza mais tempo.
Erro temporário resolve sozinho com espera e nova tentativa. Limite de throughput e limites por tempo entram aqui.
Erro permanente vai se repetir para sempre até você corrigir a causa. Parâmetro errado, template não aprovado, número não registrado.
Sistemas de integração costumam ter retry automático. Se ele repete um erro permanente, você queima cota e enche o log sem chance nenhuma de sucesso. Vale classificar antes de repetir.
Os erros de janela e entrega
131047 — passou das 24 horas
More than 24 hours have passed since the recipient last replied to the sender number.
O mais comum de todos, e o menos preocupante. Não é bloqueio, não é punição: apenas passou da janela de atendimento e você não pode mais mandar texto livre.
Como resolver: envie um template aprovado. Quando o cliente responder, a janela reabre e o texto livre volta a funcionar.
Como evitar: se a conversa costuma esfriar, programe o follow-up para antes das 24 horas. Dentro da janela a mensagem é livre; fora dela, você paga template.
131026 — não foi possível entregar
A documentação lista três causas: o número pode não ter WhatsApp, o destinatário pode não ter aceitado os Termos atualizados, ou pode estar com uma versão antiga do aplicativo.
Como resolver: confirmar o número por outro canal. Não há o que ajustar do seu lado tecnicamente.
Cuidado: número inválido não melhora com repetição. Marque o contato como inalcançável e tire da base. Insistir em número morto degrada suas métricas de entrega sem nenhum ganho.
133010 — número não registrado
Phone number not registered on the WhatsApp Business Platform.
O número que você está usando para enviar não está registrado na plataforma. Acontece muito em ambiente novo ou depois de trocar de número.
Como resolver: registrar e verificar o número antes de qualquer envio. Se você acabou de migrar da conta comum, confira se a etapa de registro foi concluída.
Os erros de template
132001 — template não existe ou não foi aprovado
The template does not exist in the specified language or the template has not been approved.
Duas causas distintas embaixo do mesmo código: nome/idioma errados, ou template ainda não aprovado.
Como resolver: confira três coisas, nesta ordem — o nome exato (é sensível a maiúsculas e underscores), o código de idioma (pt_BR não é pt), e o status de aprovação no WhatsApp Manager.
O idioma é o que mais escapa. Um template aprovado em pt_BR chamado com pt retorna 132001 mesmo existindo.
132000 — contagem de parâmetros errada
Já explicado acima. Seu template define N variáveis e a requisição enviou um número diferente.
Como resolver: abra o template no WhatsApp Manager, conte as variáveis e compare com o array que você monta. O erro clássico é alguém editar o template adicionando uma variável e esquecer de atualizar o código que o chama.
132012 — parâmetros mal formatados
The variable parameter values included in the request are not using the format specified in the template.
A quantidade está certa, o formato não. Comum em templates com data, moeda ou componentes estruturados.
Como resolver: consultar a especificação do template e ajustar o formato do valor.
132007 — violação de política no template
Template content violates a WhatsApp policy.
Este não é bug de código: o conteúdo do template infringe política.
Como resolver: revisar o texto e submeter versão corrigida. As causas mais frequentes estão em como criar um template aprovado — e a mais comum é oferta comercial dentro de template operacional.
132005 — tradução longa demais
A tradução do template excede o limite de caracteres. Encurte o texto e verifique o status no WhatsApp Manager.
Os erros de limite
130429 — limite de throughput
Cloud API message throughput has been reached.
Você está enviando rápido demais. É temporário e a orientação é reduzir a frequência ou implementar backoff.
Como resolver: espaçar os envios e usar backoff exponencial — em vez de repetir imediatamente, dobrar o intervalo a cada tentativa. Disparo em rajada é a causa habitual.
131049 — limite de marketing por usuário
This message was not delivered to maintain healthy ecosystem engagement.
Este merece atenção porque assusta sem motivo. Não é restrição da sua conta: é um limite de quantas mensagens de marketing um usuário específico recebe.
A documentação orienta aguardar pelo menos 24 horas antes de reenviar.
O que ele está te dizendo: você está mandando marketing demais para a mesma pessoa. Tecnicamente dá para esperar e repetir. Na prática, é sinal de que a frequência está alta — e insistir leva a bloqueio e denúncia, que aí sim afetam a conta. Vale tratar como aviso, não como obstáculo.
131031 — conta restrita
WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy…
Este é o sério. A conta foi restringida por violação de política, ou houve falha na verificação de dados da requisição (o PIN de duas etapas incorreto, por exemplo).
Como resolver: verificar o Business Support Home para entender a violação específica e, se for o caso, recorrer. O processo e os níveis de restrição estão em conta restrita na API Oficial.
Se for PIN incorreto, é só corrigir o valor enviado.
Como tratar erro em produção
Uma rotina que evita a maior parte da dor:
1. Classifique antes de repetir. Mantenha uma lista de códigos permanentes que nunca devem entrar em retry. Repetir 132001 mil vezes não aprova o template.
2. Use backoff nos temporários. Para 130429 e afins, dobre o intervalo a cada tentativa em vez de martelar.
3. Marque o contato nos erros de destinatário. 131026 recorrente significa número morto. Higienize a base — ela fica menor e sua taxa de entrega melhora.
4. Alerte gente nos erros de conta. 131031 não pode ficar só no log. Precisa acordar alguém.
5. Registre o código, não só a falha. “Erro ao enviar” no log não ajuda ninguém. Guardar o código e a mensagem original é a diferença entre resolver em cinco minutos e passar a tarde adivinhando.
6. Monitore por webhook. Muito erro só aparece no status de entrega, depois do envio aceito. Sem consumir o webhook, você acha que enviou. Explicamos em webhook do WhatsApp.
Resumo rápido
| Código | O que é | Repetir adianta? |
|---|---|---|
| 131047 | Passou das 24h | Não — mande template |
| 131026 | Não foi possível entregar | Não — verifique o número |
| 133010 | Número remetente não registrado | Não — registre antes |
| 132001 | Template não existe ou não aprovado | Não — corrija nome, idioma ou aguarde aprovação |
| 132000 | Contagem de parâmetros divergente | Não — corrija a chamada |
| 132012 | Formato de parâmetro errado | Não — ajuste o formato |
| 132007 | Template viola política | Não — reescreva |
| 132005 | Tradução longa demais | Não — encurte |
| 130429 | Throughput excedido | Sim — com backoff |
| 131049 | Limite de marketing por usuário | Sim — após 24h, mas revise a frequência |
| 131031 | Conta restrita ou dado inválido | Não — resolva a causa |
A regra que fecha tudo: se o erro é sobre o que você mandou, corrija; se é sobre o ritmo, espere; se é sobre a conta, aja rápido.
Se sua operação está enfrentando erro recorrente e você não tem clareza da causa, é exatamente o tipo de coisa que resolvemos junto com o cliente — somos parceiros oficiais da Meta e lidamos com esses códigos todo dia.