Principal Integração com WhatsApp Por que minha mensagem não está sendo enviada? Guia completo de erros (WhatsApp, Twilio e e-mail)

Por que minha mensagem não está sendo enviada? Guia completo de erros (WhatsApp, Twilio e e-mail)

Última atualização em May 07, 2026

Quando usar

  • Sua mensagem aparece com erro no Cloud Chat e você quer entender o significado
  • Você quer um catálogo de referência dos códigos de erro mais comuns
  • Você precisa decidir se reenvia, ajusta o template ou aciona o suporte

Sobre este artigo

Algumas vezes a sua mensagem pode não ser enviada e aparecer um código de erro. Mapeamos os casos mais comuns usando o detalhamento da documentação oficial da Meta sobre o que fazer em cada caso.

Como o erro aparece no Cloud Chat

A mensagem fica com a borda em vermelho e exibe um link Ver detalhes que abre uma modal com o código:

Clique em Ver detalhes para ver o detalhamento do erro:

O Cloud Chat exibe o detalhamento de todos os códigos de erro da Meta — para o catálogo completo: Meta Developers — Error Codes.

Erros mais comuns — WhatsApp

131049 — Policy Violation

Message not delivered to maintain healthy ecosystem engagement.

  • 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:

131026 — Message Undeliverable (genérico)

Message Undeliverable.

  • 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 do envio

    • Garantir opt-in atualizado

    • Reprocessar envios em caso de erro transitório

131048 — Spam Rate Limit Hit

Spam rate limit hit.

  • 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:

130472 — User Not Eligible

User's number is part of an experiment / not eligible.

  • 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

131042 — Business Eligibility Issue

Payment or account not allowed.

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

  • Causas comuns:

    • Empresa em categoria restrita

    • Falta de verificação no Business Portfolio

    • Pendência de pagamento

  • Ação recomendada:

    • Resolver billing

    • Verificar elegibilidade no Meta Business Manager

    • Confirmar verificação do Business Portfolio

131047 — Re-engagement Failed

24h window exceeded — Re-engagement message failed.

  • 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:

Erros multicanal

63024 — Generic API Error (Twilio / Email / WhatsApp)

Generic WhatsApp Cloud API error code.

  • 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

#100 — Invalid Action (Facebook / Graph API)

Invalid action (not owner of topic / invalid API call).

  • 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

Erros adicionais por canal

E-mail

Código Significado
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

Código Significado
21617 Mensagem excede 1.600 caracteres
63007 Canal "From" inválido
63018 Rate Limit
63049 / 63032 / 63016 Erros genéricos de provedor

Observações