Como identificar um erro de envio
Quando uma mensagem enviada pela API Oficial apresenta falha, será exibido um ícone de erro (exclamação) ao lado da mensagem no chat.
Esse ícone indica que a mensagem não foi entregue ao destinatário.
Como verificar o motivo do erro
Localize a mensagem com o ícone de exclamação ao lado.
Clique sobre o ícone.
Será aberto um modal com as seguintes informações:
Descrição do erro retornado pela API
Código do erro (ex.: 131026-Message undeliverable)
Link para a documentação oficial, com mais detalhes sobre o motivo da falha.
O que fazer quando ocorrer um erro
Ao identificar um erro de envio:
Clique no ícone para entender o motivo
Verifique a descrição apresentada
Acesse o link da documentação para mais detalhes, se necessário
💡 Dica: ao abrir a documentação, você pode usar Ctrl + F e pesquisar pelo código do erro (ex.: 131049) para encontrar rapidamente a explicação.
A ação a ser tomada pode variar conforme o erro exibido.
Exemplo de erro comum
131049 – Undelivered (não entregue)
Descrição (conforme a documentação):
A Meta optou por não entregar a mensagem para manter o engajamento saudável do ecossistema.
Isso pode ocorrer, por exemplo, quando existem limites de envio de mensagens (principalmente de marketing).
Como agir:
Aguarde pelo menos 24 horas antes de tentar reenviar o template
Evite múltiplas tentativas seguidas, pois isso pode gerar o mesmo erro novamente
Observação
Esses erros estão diretamente relacionados às regras da Meta Platforms e pode variar conforme:
Comportamento do destinatário
Frequência de envio
Tipo de mensagem (principalmente marketing)
Pontos importantes
⚠️ Os erros exibidos são retornados diretamente pela API do WhatsApp, gerenciada pela Meta Platforms.
⚠️ Nem todos os erros dependem da plataforma, alguns estão relacionados ao número do destinatário ou às regras do WhatsApp.