For the complete documentation index, see llms.txt. This page is also available as Markdown.
KCS - Erro Whatsapp #131026: Mensagem Não Entregável
Erro Whatsapp #131026: Mensagem Não Entregável
🕒 Tempo aproximado para leitura: 00:02:00 min
❓ Dúvida:
O cliente recebe o erro #131026 "Message Undeliverable" (Mensagem Não Entregável) ao tentar realizar disparos via API, indicando que a mensagem foi rejeitada por restrições do destinatário.
🔎 Causa:
Este erro não representa uma falha técnica no servidor de envio, mas sim uma rejeição por parte do destinatário ou da plataforma Meta. As causas mais frequentes são:
Número Inválido: O destinatário não possui uma conta de WhatsApp ativa ou o número foi desativado.
Políticas de Privacidade: O usuário final ainda não aceitou os Termos de Serviço ou as Políticas de Privacidade mais recentes do aplicativo.
Versão do Aplicativo: O destinatário utiliza uma versão muito antiga do WhatsApp que não suporta recursos modernos (como botões interativos ou listas).
Limite de Frequência (Marketing): O WhatsApp limita o volume de mensagens de marketing que um usuário pode receber em um curto período para evitar spam.
Bloqueio Direto: O usuário pode ter bloqueado o número de telefone da empresa.
✅ Solução:
Para tratar o erro e validar a comunicação, o cliente deve realizar os seguintes procedimentos:
Verificação do Contato: Utilizar a ferramenta de verificação de contatos da API do WhatsApp para confirmar se o número de destino é válido e está registrado na plataforma.
Teste de Categoria (Utility): Tente enviar uma mensagem simples de texto configurada na categoria "Utility" (Utilidade). Caso esta mensagem seja entregue, o problema original estava relacionado ao limite de mensagens de marketing ou à versão do aplicativo do usuário.
Intervalo de Reenvio: Se a suspeita for limite de frequência de marketing, oriente o cliente a aguardar entre 24 a 48 horas antes de tentar um novo envio para aquele mesmo contato.
Monitoramento Global: Consultar o painel de Status do Meta Business para verificar se não há instabilidades momentâneas na infraestrutura da Meta.
Gostaria que eu verificasse se existe algum outro código de erro comum associado a esse cenário para complementarmos seu guia?
