Principal Perguntas frequentes Por que minha mensagem não está sendo enviada?

Por que minha mensagem não está sendo enviada?

Última atualização em Sep 02, 2025

Algumas vezes a sua mensagem pode não ser enviada e aparecer uma mensagem de erro. Nós mapeamos os principais casos e escrevemos um pouco 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á uma mensagem com código:

🔴 131049 – WhatsApp Policy Violation

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

  • O que significa: O WhatsApp bloqueia a mensagem por violação das políticas da plataforma.

  • Causas comuns:

    • Conteúdo classificado como spam, ofensivo ou que induz a comportamento impróprio.

    • Altas taxas de bloqueio/denúncia por parte dos usuários.

    • Mensagens enviadas em massa sem consentimento prévio (opt-in).

  • Impacto: A mensagem não chega ao usuário final.

  • Ações recomendadas:

    • Revisar conteúdo dos templates (linguagem clara, sem clickbait ou SPAM).

    • Melhorar a coleta de opt-ins (apenas usuários que aceitaram receber mensagens).

    • Acompanhar métricas de qualidade no WhatsApp Manager (Meta).

🟠 131026 – WhatsApp – Message Undeliverable (generic)

  • Descrição oficial: “Message Undeliverable”

  • O que significa: O WhatsApp não conseguiu entregar a mensagem, mas não especifica o motivo.

  • Causas comuns:

    • Número inválido/desativado.

    • Usuário bloqueou o número da empresa.

    • Configurações de privacidade do cliente.

    • Erro temporário do provedor.

  • Impacto: Mensagem não chega ao usuário.

  • Ações recomendadas:

    • Validar se o número tem WhatsApp ativo.

    • Garantir opt-in válido do cliente.

    • Monitorar repetição e, se frequente, abrir chamado junto ao BSP/Twilio.

🟡 131048 – WhatsApp – Spam Rate Limit Hit

  • Descrição oficial: “Spam rate limit hit”

  • O que significa: O WhatsApp detectou que a empresa ultrapassou limites de envio impostos para proteger contra spam.

  • Causas comuns:

    • Disparo de mensagens acima do tier de qualidade da conta.

    • Conta com baixa reputação (muitos bloqueios/denúncias).

  • Impacto: O envio é bloqueado até que os limites sejam resetados.

  • Ações recomendadas:

    • Verificar o tier de qualidade da conta no WhatsApp Manager.

    • Reduzir envios massivos.

    • Reforçar opt-in e segmentação para evitar denúncias.

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

  • Descrição oficial: “Error code: 63024”

  • O que significa: Erro genérico do WhatsApp Cloud API. Não traz causa detalhada.

  • Causas comuns:

    • Erro transitório nos servidores da Meta.

    • Problema de rede entre aplicação e Cloud API.

    • Payload inválido não reconhecido pelo endpoint.

  • Impacto: Mensagem pode não ser entregue.

  • Ações recomendadas:

    • Reprocessar envio.

    • Habilitar retry automático.

    • Caso frequente, abrir suporte com detalhes (payload, timestamp).

🟡 130472 – Whatsapp - User’s Number Is Part of an Experiment / Not Eligible

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

  • O que significa: O WhatsApp sinaliza que não é possível enviar para aquele número no momento.

  • Causas comuns:

    • Número de telefone em sandbox/teste.

    • Número marcado em grupos de teste da Meta.

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

  • Impacto: Bloqueio seletivo de entrega.

  • Ações recomendadas:

    • Confirmar que o número é válido e optou por receber mensagens.

    • Se recorrente, abrir suporte junto ao BSP/Twilio.

🟠 #100 – Facebook – Invalid Action

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

  • O que significa: A requisição feita ao WhatsApp Cloud API ou BSP é inválida.

  • Causas comuns:

    • Parâmetros incorretos na chamada (por ex., ID de conversa inexistente).

    • Token de autenticação sem permissão.

    • Uso de endpoint errado.

  • Impacto: A mensagem não é processada.

  • Ações recomendadas:

    • Validar payload e parâmetros enviados.

    • Conferir permissões da app no Meta Developer.

    • Revisar documentação oficial da API.

🔴 131042 – WhatsApp – Business Eligibility Issue

  • Descrição oficial: “Business eligibility issue - payment or account not allowed”

  • O que significa: A conta de WhatsApp Business não tem autorização para envio.

  • Causas comuns:

    • Empresa em categoria proibida (ex.: armas, criptomoeda sem licença).

    • Pagamentos ou billing pendentes na conta Meta.

    • Business Manager não verificado.

  • Impacto: Todos os envios podem falhar.

  • Ações recomendadas:

    • Verificar status da empresa no Meta Business Manager.

    • Resolver pendências de pagamento.

    • Solicitar revisão de elegibilidade.

🟡 131047 – WhatsApp – 24 window exceeded - Re-engagement Failed

  • Descrição oficial: “Re-engagement message failed - 24h window exceeded”

  • O que significa: A empresa tentou responder fora da janela de 24h de última interação.

  • Causas comuns:

    • Mensagem enviada sem template aprovado após 24h.

  • Impacto: Bloqueio da mensagem.

  • Ações recomendadas:

    • Utilizar templates aprovados (HSM) para reengajamento fora da janela.

    • Configurar fluxos automáticos para respeitar a regra das 24h.

🟡 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.