.png?v=1790870524 "Suporte")
Use este artigo quando a IAra, a Meta, a API oficial do WhatsApp ou o provedor retornar um código de erro no envio.
Ordem recomendada de diagnóstico
- Confirme se a conversa está dentro da janela permitida para resposta livre.
- Se estiver fora da janela, use template aprovado e ativo.
- Valide nome técnico, idioma e variáveis do template.
- Confirme se o número do destinatário usa WhatsApp e está completo com DDI/DDD.
- Se houver mídia, teste uma mensagem sem anexo.
- Se houver volume alto, reduza ritmo e aguarde os limites normalizarem.
- Se o erro envolver política, bloqueio ou conta comercial, acione o suporte Digi2B com as evidências.
Limites, instabilidade e erros temporários
| Código | Significado provável | Como resolver |
|---|---|---|
| 130429 | Throughput excedido. O número ou conta ultrapassou o ritmo permitido. | Reduza o volume, use filas, segmente envios e aguarde antes de reenviar. |
| 131056 | Limite por par remetente-destinatário. | Aguarde antes de enviar novamente para o mesmo contato. |
| 131016 | Serviço temporariamente indisponível. | Aguarde e tente novamente com intervalo. |
| 131057 | Conta ou número em manutenção/upgrade. | Aguarde normalização e evite volume alto durante a janela. |
| 1, 2, 131000 ou 135000 | Erro genérico da API ou do serviço. | Repita com texto simples e colete retorno completo se persistir. |
| 130472 | Número do destinatário afetado por limitação/experimento do canal. | Use canal alternativo ou tente novamente mais tarde. |
Janela de 24 horas e templates
| Código | Significado provável | Como resolver |
|---|---|---|
| 131047 | Tentativa de reengajamento fora da janela permitida. | Use um template aprovado para iniciar ou retomar a conversa. |
| 132001 | Template inexistente, não aprovado, indisponível ou idioma incorreto. | Confira nome técnico, idioma e status do template. |
| 132000 | Quantidade de variáveis diferente do template. | Envie exatamente a quantidade de parâmetros exigida. |
| 132012 | Tipo ou formato de parâmetro inválido. | Corrija texto, moeda, data, mídia ou estrutura dos componentes. |
| 132005 | Texto final do template ficou longo demais. | Reduza variáveis e conteúdo gerado. |
| 132007 | Formatação/caracteres violam política do template. | Revise quebras, emojis, símbolos e texto promocional sensível. |
Destinatário, mídia e tipo de mensagem
| Código | Significado provável | Como resolver |
|---|---|---|
| 131026 | Mensagem não entregável ao destinatário. | Confirme número, DDI/DDD, WhatsApp ativo, bloqueio e aceite dos termos do app. |
| 131051 | Tipo de mensagem não suportado. | Troque por formato aceito, como texto ou link. |
| 131052 | Erro ao baixar mídia. | Use URL pública, estável, sem expiração curta e com content-type correto. |
| 131053 | Erro ao enviar ou processar mídia. | Reduza tamanho, troque formato e teste arquivo simples. |
| 131021 | Remetente e destinatário são o mesmo número. | Envie para outro número de teste. |
Permissão, conta, pagamento e política
| Código | Significado provável | Como resolver |
|---|---|---|
| 131005 | Acesso negado. | Reconecte o canal com permissões corretas. |
| 131008 | Parâmetro obrigatório ausente. | Revise dados do template, destinatário e payload. |
| 131042 | Elegibilidade comercial, pagamento ou conta WhatsApp Business com problema. | Regularize a conta comercial e acione o suporte Digi2B se necessário. |
| 368, 130497 ou 131031 | Bloqueio, restrição geográfica ou conta bloqueada. | Interrompa envios e trate como incidente de política/compliance. |
| 131049 | Entrega suprimida por proteção do ecossistema, frequência, qualidade ou elegibilidade. | Reduza frequência, melhore segmentação e revise qualidade dos templates. |
Códigos comuns via Twilio ou provedor intermediário
| Código | Significado provável | Como resolver |
|---|---|---|
| 63016 | Fora da janela permitida. | Use template oficial ou aguarde nova interação do cliente. |
| 63040, 63041 ou 63042 | Template rejeitado, pausado ou desabilitado. | Corrija, substitua ou ressubmeta o template. |
| 63005 ou 63021 | Conteúdo inválido ou recusado pelo canal. | Ajuste formato, variáveis, mídia e componentes. |
| 63013 | Violação de política do canal. | Revise o conteúdo antes de tentar novamente. |
| 63017 ou 63018 | Rate limit excedido. | Reduza ritmo, aplique espera e segmente envios. |
Quando pedir ajuda à Digi2B
- O código afeta grande volume ou todos os envios do número.
- A conta, número ou WABA aparece bloqueada/restrita.
- O erro persiste mesmo com texto simples e contato de teste válido.
- O template está aprovado, mas falha com 132001, 132000 ou 132012.
- A IAra mostra enviado, mas o provedor retorna falha posterior.
Envie o código, horário, número remetente, número destinatário, link da conversa, nome do template e print do erro.