> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/configuracoes/geral/integracoes/whatsapp/kcs-erro-whatsapp-131026-mensagem-nao-entregavel.md).

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

1. 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.
2. 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.
3. 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.
4. 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?<br>

***

Links de Referência:

* [Limites de mensagem de modelo de marketing por usuário (Meta)](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits)