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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/integracoes/whatsapp/kcs-erro-whatsapp-131026-mensagem-nao-entregavel.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.