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

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.

Antes do código: o que a falha está mostrando

As mensagens dos clientes chegam, mas as respostas não saem

Quando o recebimento continua normal e só o envio falha, em várias conversas do mesmo canal (inclusive nas mensagens de atendentes humanos), a causa mais comum é o token que liga o número à conta da Meta: ele perdeu a validade ou a permissão.

• Acontece quando o token não é de um usuário do sistema (system user) permanente, ou quando o Business Manager perdeu acesso à conta do WhatsApp

• Como resolver: quem administra o Business Manager da Meta reconecta o canal em Configurações → Caixas de entrada → canal de WhatsApp, pelo Cadastro Incorporado (Embedded Signup). Isso gera um token novo

• Antes de reconectar, confira no Business Manager se o número continua ativo e vinculado à WABA, se não há restrição de política na conta e se o app conectado tem a permissão whatsapp_business_messaging

• Não é falha do Cloud Chat nem da ClaudIA: o erro vem da resposta da Meta

O envio falha em todos os números ou em todas as caixas

Se tudo o que sai pelos números de uma mesma conta do WhatsApp Business (WABA) falha ao mesmo tempo, confira se a Meta desativou a WABA ou baniu o número. O erro que aparece costuma ser o 131031 (Business Account locked).

• Quem tem acesso de administrador ao portfólio entra em business.facebook.com/business-support-home, seleciona o portfólio e confere se há restrição no portfólio e em cada conta do WhatsApp

• Se aparecer Solicitar análise (Request Review), peça a revisão de cada conta afetada, explicando o uso real (por exemplo, mensagens operacionais para clientes cadastrados)

• Enquanto a conta estiver desativada, pause as automações e campanhas desses números: tudo o que for enviado vai falhar

• A Meta não costuma dizer qual regra foi descumprida. Vale revisar a política do WhatsApp Business: ela proíbe, por exemplo, cobrança de dívidas e pedir número completo de cartão, conta bancária ou documento pela conversa

Só um modelo (template) falha no envio

• Passou de 1.024 caracteres: o limite do corpo vale com as variáveis já preenchidas. Um link longo numa variável (como o link completo de um boleto) faz a mensagem passar do limite e ser recusada. Use um link curto

• Modelo operacional cadastrado como Marketing: a Meta limita quantas mensagens de marketing cada pessoa recebe, e as que passam do limite falham com 131049. Se o texto é transacional, recrie o modelo como Utility

• Erro example.body_text ao criar o modelo: veja Templates de WhatsApp: criar, editar, excluir e usar o construtor, seção Erros comuns

Erros mais comuns — WhatsApp

131049 — Policy Violation

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

• Causas comuns:

  • Limite da Meta para mensagens de marketing por pessoa: modelos operacionais cadastrados como Marketing também contam

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

  • Se o texto é transacional, recriar o modelo como Utility

  • Revisar templates aprovados e a linguagem usada

  • Melhorar a coleta de opt-ins

  • Monitorar métricas de qualidade no Meta Business Manager

  • Ver: Como evitar bloqueios e banimentos no WhatsApp

131026 — Message Undeliverable (genérico)

• 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

• 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

  • Ver: Tiers de envio do WhatsApp: o que são e como evoluir

130472 — User 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

• 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

131031: Business Account locked

• O que significa: a Meta desativou a conta do WhatsApp Business (WABA) ou baniu o número. Todos os envios desses números falham

• Ação recomendada:

  • Conferir a restrição em business.facebook.com/business-support-home e, se houver a opção, clicar em Solicitar análise

  • Pausar automações e campanhas desses números até a conta voltar

  • Revisar a política do WhatsApp Business

131047 — Re-engagement 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:

  • Usar templates aprovados para reengajamento

  • Configurar alertas para respeitar a janela de 24h

  • Ver: Regras de templates do WhatsApp (Meta)

Erros multicanal

63024 — Generic API Error (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

#100 — Invalid Action (Facebook / Graph 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

Erros adicionais por canal

E-mail

Twilio

Observações

• Para o catálogo completo de erros WhatsApp da Meta: Meta Developers — Cloud API Error Codes.

• Para entender o sistema de tiers e como ele influencia o erro 131048: Tiers de envio do WhatsApp.

• Para reduzir o risco de erros relacionados a qualidade (131049, 131048): Como evitar bloqueios e banimentos no WhatsApp.