Como Interpretar Erros
A API retorna erros em formato JSON padronizado com codigo numerico, titulo e detalhes. Entender esse formato e o primeiro passo para debugar rapidamente:
{
"error": {
"message": "Rate limit hit",
"type": "OAuthException",
"code": 80007,
"error_subcode": 2388049,
"fbtrace_id": "xxx"
}
}Erros de Autenticacao
- 190 (OAuthException): Token invalido ou expirado. Gere um novo System User Token.
- 10 (Permission Error): Token sem permissao necessaria. Adicione whatsapp_business_messaging ao System User.
Erros de Envio
- 131030: Limite de conversas do tier atingido. Aguarde 24h ou solicite aumento de tier.
- 131047: Mensagem expirou antes da entrega (24h timeout). Destinatario pode estar offline.
- 131026: Mensagem bloqueada por politica. Revise o conteudo do template.
- 130472: Numero nao registrado no WhatsApp. Remova da lista de contatos.
- 131051: Tipo de mensagem nao suportado. Verifique o payload.
Erros de Template
- 132000: Numero de parametros nao confere com o template. Confira a quantidade de variaveis.
- 132012: Template pausado por baixa qualidade. Melhore o conteudo ou crie um novo.
- 132015: Template nao encontrado. Verifique nome, idioma e namespace.
Erros de Rate Limit
- 80007: Rate limit excedido. Implemente backoff exponencial e filas.
- 130429: Muitas requisicoes ao Cloud API. Reduza a frequencia de envio.
Estrategia de Tratamento
Classifique erros em retriable (temporarios) e non-retriable (permanentes). Retry so para os temporarios.
- Retriable: 80007, 131047, 130429 — use retry com backoff
- Non-retriable: 130472, 131026, 132000 — logue e alerte, nao reenvie
Conclusao
Ter um catalogo de erros e saber como reagir a cada um e essencial para manter a saude da sua integracao. Implemente tratamento adequado, monitore taxas de erro e corrija problemas proativamente.