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.