Algumas vezes a sua mensagem pode não ser enviada e aparecer uma mensagem de erro. Nós mapeamos todos os casos usamos o detalhamento da Meta sobre o que fazer quando aparecer cada tipo de erro específico.

Exemplo de como aparece a mensagem de erro. A caixa ficará com uma cor vermelha e aparecerá um link ver detalhes que abre uma modal:

Você poderá ver o detalhamento do erro clicando em ver detalhes:

O cloudchat exibe o detalhamento de todos os códigos de erro da Meta

Erros mais comuns e explicação detalhada sobre eles

🔴 131049 – WhatsApp – Policy Violation

• Descrição: Message not delivered to maintain healthy ecosystem engagement

• Canal: WhatsApp

• O que significa: O WhatsApp bloqueou a entrega por violação de política.

• Causas comuns:

  • Conteúdo considerado spam ou de baixa qualidade.

  • Alta taxa de bloqueios/denúncias de usuários.

  • Falta de opt-in válido.

• Ação recomendada:

  • Revisar os templates aprovados e a linguagem usada.

  • Melhorar a coleta de opt-ins.

  • Monitorar métricas de qualidade no Meta Business Manager.

🟠 131026 – WhatsApp – Message Undeliverable (generic)

• Descrição: Message Undeliverable

• Canal: WhatsApp

• O que significa: A mensagem não pôde ser entregue, sem detalhes específicos.

• Causas comuns:

  • Número inválido, desativado ou bloqueado.

  • Usuário desinstalou o app.

  • Erro temporário na infraestrutura da Meta.

• Ação recomendada:

  • Validar números antes de envio.

  • Garantir opt-in atualizado.

  • Reprocessar envios em caso de erro transitório.

🟡 131048 – WhatsApp – Spam Rate Limit Hit

• Descrição: Spam rate limit hit

• Canal: WhatsApp

• O que significa: A conta ultrapassou o limite de envio permitido.

• Causas comuns:

  • Volume de disparos acima do tier de qualidade.

  • Conta com reputação baixa.

• Ação recomendada:

  • Segmentar envios.

  • Acompanhar métricas de reputação.

  • Solicitar revisão de limites, se necessário.

🟡 63024 – Twilio/Email/WhatsApp – Generic API Error

• Descrição: Generic WhatsApp Cloud API error code

• Canal: Multicanal (Twilio, Email, WhatsApp)

• O que significa: Erro genérico da API, sem detalhamento da causa.

• Causas comuns:

  • Timeout ou falha na rede.

  • Payload inválido.

  • Erro transitório na API.

• Ação recomendada:

  • Implementar retry automático.

  • Validar payloads.

  • Escalar para suporte do provedor em caso de repetição.

🟡 130472 – WhatsApp – User Not Eligible

• Descrição: User’s number is part of an experiment / not eligible

• Canal: WhatsApp

• O que significa: O número do usuário não pode receber mensagens no momento.

• Causas comuns:

  • Número em sandbox/teste da Meta.

  • Usuário não habilitado para receber mensagens comerciais.

• Ação recomendada:

  • Confirmar elegibilidade do número.

  • Escalar ao provedor se recorrente.

🟠 #100 – Facebook – Invalid Action

• Descrição: Invalid action (not owner of topic / invalid API call)

• Canal: Facebook (API)

• O que significa: A chamada feita não é válida.

• Causas comuns:

  • Endpoint incorreto.

  • Token sem permissão.

  • Parâmetros inválidos.

• Ação recomendada:

  • Revisar payloads e permissões.

  • Conferir documentação da Graph API.

🔴 131042 – WhatsApp – Business Eligibility Issue

• Descrição: Payment or account not allowed

• Canal: WhatsApp

• O que significa: A conta não está apta a enviar mensagens.

• Causas comuns:

  • Empresa em categoria restrita.

  • Falta de verificação no Business Manager.

  • Pendência de pagamento.

• Ação recomendada:

  • Resolver billing.

  • Verificar elegibilidade no Meta Business Manager.

🟡 131047 – WhatsApp – Re-engagement Failed

• Descrição: 24h window exceeded – Re-engagement message failed

• Canal: WhatsApp

• O que significa: Mensagem enviada fora da janela de 24h sem uso de template.

• Causas comuns:

  • Resposta enviada depois do limite permitido.

• Ação recomendada:

  • Usar templates aprovados para reengajamento.

  • Configurar alertas para respeitar a janela.

🟡 Erros adicionais (por canal):

• E-mail:

  • 451 4.7.1 → Rate Limit atingido no servidor de e-mail.

  • 535-5.7.8 → Falha de autenticação SMTP.

  • 003 → Timeout de rede no envio.

  • 2603 → Rede inacessível.

• Twilio:

  • 21617 → Mensagem excede 1600 caracteres.

  • 63007 → Canal “From” inválido.

  • 63018 → Rate Limit.

  • 63049 / 63032 / 63016 → Erros genéricos de provedor.