# Erros

# Erros

## 131049 - A Meta escolheu não entregar a mensagem


:::info
tl;dr: O erro **131049** ocorre quando uma mensagem de template de marketing não é entregue para manter a saúde do ecossistema do WhatsApp. Isso acontece devido a limites de envio por usuário para evitar excesso de mensagens de marketing. Reenviar imediatamente não resolverá o problema; em vez disso, aumente o intervalo de tempo entre as tentativas.

:::

A Meta implementou um limite de envio de mensagens de marketing por usuário para ajudar a garantir que os usuários do WhatsApp recebam apenas comunicações que sejam relevantes e valiosas. Desde a introdução dessa política, a plataforma observou melhorias significativas nas taxas de leitura e no sentimento dos usuários em relação às mensagens de negócios.

### O que é esse Limite?

O limite se refere à quantidade de **mensagens de marketing** que um usuário pode receber de uma empresa dentro de um determinado período. Inicialmente, ele afeta conversas que têm menor probabilidade de serem lidas, e em breve, a Meta também aplicará esse controle para reduzir a entrega de mensagens para usuários que mostram menor engajamento com comunicações de marketing.

### Por que Isso é Importante?

A Meta percebeu que limitar o número de mensagens de marketing por usuário aumenta a taxa de engajamento e melhora a experiência geral, fazendo com que os usuários se sintam menos sobrecarregados com mensagens de negócios. Isso torna as comunicações mais eficazes e faz com que os usuários enxerguem valor em continuar recebendo essas mensagens.

### Como Funciona para a Sua Empresa

O limite se aplica **apenas a mensagens de templates de marketing** que abririam uma nova conversa de marketing. Se já existe uma conversa de marketing aberta entre a empresa e o usuário, você pode enviar **uma mensagem adicional** de template de marketing. Mensagens adicionais só poderão ser enviadas se o usuário responder dentro dessa janela de conversa.

#### Exemplo:


1. A primeira mensagem de template de marketing é enviada e abre uma nova conversa de marketing de 24 horas (janela de atendimento).
2. Você pode enviar **uma segunda mensagem de template** dentro da mesma conversa ativa.
3. Se o usuário responder a qualquer mensagem dentro dessa conversa, você poderá enviar mais uma mensagem de template.
4. Caso contrário, você não poderá enviar novas mensagens de marketing até que o usuário inicie uma nova interação.

### Notificação e Código de Erro

Se a mensagem de marketing não for entregue devido a esse limite, você receberá o **código de erro 131049** com a descrição:

* **"This message was not delivered to maintain a healthy ecosystem."**

Esse erro significa que a Meta decidiu não entregar a mensagem para manter o engajamento saudável e evitar excesso de mensagens. Se você receber esse erro, **não tente reenviar imediatamente**, pois o limite pode durar diferentes períodos. Em vez disso, aumente gradativamente o intervalo de tempo entre tentativas até que a mensagem seja entregue.

### Resumo do Código de Erro

* **Erro 131049**: "Esta mensagem não foi entregue para manter um ecossistema saudável."

### Melhorando a Experiência no WhatsApp

Essas limitações são parte dos esforços da Meta para garantir que o WhatsApp continue sendo um espaço valioso e não uma plataforma saturada por mensagens de marketing. Com isso, a Meta busca proporcionar a melhor experiência para empresas e consumidores, equilibrando a quantidade de mensagens para aumentar a satisfação e o engajamento dos usuários.

Para mais detalhes, consulte a documentação sobre limites de mensagens de marketing por usuário na [página oficial](https://developers.facebook.com/docs/whatsapp).

## 130472 - Experimento de Marketing


:::info
tl;dr: O erro 130472 acontece quando um template de marketing não é entregue porque o destinatário faz parte de um experimento de controle, onde 1% dos usuários não recebem essas mensagens. Nesse caso, não há cobrança pela mensagem. Tentar reenviar resultará no mesmo erro. Se necessário, entre em contato por outros meios para que o cliente inicie uma nova conversa com você no WhatsApp.

:::

A Meta realiza experimentos de tempos em tempos para avaliar como as mensagens afetam a experiência e o engajamento dos usuários no WhatsApp. Um desses experimentos, chamado **"Marketing Message Experiment"**, começou em 14 de junho de 2023.

### Detalhes do Experimento

Nesse experimento, **aproximadamente 1% dos usuários do WhatsApp não receberão mensagens de templates de marketing de nenhuma empresa**, a menos que se enquadrem em uma das seguintes condições:


1. **Janela de Atendimento**: Existe uma janela de atendimento aberta (ou seja, uma interação anterior iniciada pelo cliente) entre o usuário e a empresa.
2. **Conversa de Marketing Aberta**: Já há uma conversa de marketing ativa com esse cliente.
3. **Ponto de Entrada Gratuito**: Existe uma conversa aberta por um ponto de entrada gratuito (como um link de mensagem).

### Comportamento ao Enviar para Usuários do Grupo de Experimento

Se você enviar uma mensagem de template de marketing para um cliente que faz parte do grupo de experimento, **a mensagem não será enviada** e **você não será cobrado** por ela, pois nenhuma conversa foi criada.

Em vez disso, você receberá um **webhook de status de mensagem como "undeliverable"** com o **código de erro 130472**, indicando a falha no envio.

### Recomendações para esse Cenário

Reenviar a mensagem para esse cliente resultará no mesmo erro. Se for essencial enviar o template de marketing para esse cliente, a recomendação é:

* Entrar em contato com o cliente por outros meios que não o WhatsApp e pedir para que ele envie uma mensagem para você.
* Dessa forma, você poderá enviar o template dentro de uma janela de atendimento aberta.

### Código de Erro Específico para o Experimento

O código de erro retornado nesse caso será:

* **Erro 130472**: Indica que o template não foi entregue devido ao cliente estar no grupo de controle do experimento.

Isso garante que a experiência do usuário seja protegida e ajuda a Meta a aprimorar a plataforma com base nos resultados coletados.

### Referência

<https://developers.facebook.com/docs/whatsapp/cloud-api/guides/experiments#marketing-message-experiment>

---

**Documents**

- [Manuais de produtos](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/manuais-de-produtos-9Zwzl1ufq8)
- [Treinamentos em vídeo](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/treinamentos-em-video-RtQVBvFmgW)
- [Versões de produtos](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/versoes-de-produtos-TH4Y8GFXxO)