> 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/chat/kcs-erros-ao-iniciar-novos-chats-via-whatsapp-cloud-api.md).

# KCS - Erros ao iniciar novos chats via WhatsApp Cloud API

## 💬 Erros ao iniciar novos chats via WhatsApp Cloud API

🕒 Tempo aproximado para leitura: 00:02:00 min

***

### ❓ Dúvida:

Por que ocorrem erros ao tentar iniciar um novo chat com determinados clientes via **WhatsApp Cloud API (Meta)**, impedindo o envio de mensagens e a abertura de novas conversas?

***

### 🔎 Causa:

Existem **duas causas principais**, ambas relacionadas às políticas da **Meta (WhatsApp Cloud API)** para garantir a qualidade e segurança do ecossistema:

#### 1. **Erro 131049 – “A Meta escolheu não entregar a mensagem”**

Esse erro ocorre **para manter o engajamento saudável do ecossistema de mensagens**.\
A Meta impõe **limites de recebimento de mensagens de marketing** para cada usuário, evitando excesso de notificações comerciais.\
Esses limites variam e **não são divulgados publicamente**, o que significa que nem os parceiros (como o Tiflux) têm acesso ao tempo exato ou quantidade de mensagens permitidas por usuário.

#### 2. **Erro 130472 – “O número do usuário faz parte de um experimento”**

Esse erro ocorre quando o número do destinatário está **participando de testes internos conduzidos pela Meta**, como o *Marketing Message Experiment*.\
Durante esses experimentos, as mensagens de marketing podem ser bloqueadas temporariamente para fins de análise de comportamento e entrega.

Essas restrições não são erros técnicos do Tiflux, mas **limitações controladas diretamente pela Meta**, aplicadas globalmente a todas as integrações com a API oficial.

***

### ✅ Solução:

Como os bloqueios são impostos pela Meta, **não é possível forçar a entrega da mensagem** imediatamente.\
Recomenda-se seguir os passos abaixo:

1. **Evitar reenviar a mensagem imediatamente** após o erro.
   * A Meta orienta aplicar **intervalos de tempo maiores** antes de tentar novamente.
2. **Aguardar algumas horas** antes de uma nova tentativa de envio.
3. Caso o contato seja urgente, utilizar **métodos alternativos de comunicação**, como:
   * Criação de um **Ticket no Tiflux**.
   * Envio de uma **comunicação por e-mail** diretamente do Ticket, garantindo que o cliente seja notificado.

***

📎 **Observação:**\
Esses erros também podem ocorrer internamente com a própria equipe Tiflux, pois são **restrições globais da Meta** e não falhas de sistema local.\
A recomendação é sempre respeitar os intervalos de envio e utilizar os canais alternativos até que o limite de mensagens seja liberado novamente.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/chat/kcs-erros-ao-iniciar-novos-chats-via-whatsapp-cloud-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.