O disparo corre bem, o número está saudável e, de repente, uma parte dos contatos volta como falhou com o código 131049 e a frase This message was not delivered to maintain healthy ecosystem engagement. Não é erro de modelo, nem de token, nem de número: a Meta recusou aquela mensagem para aquela pessoa, naquele momento.
O que ele quer dizer
A Meta limita quantas mensagens de marketing uma mesma pessoa recebe de empresas no WhatsApp, e a conta soma todas as empresas, não só a sua. Quando a pessoa já recebeu o que a Meta considera suficiente, a mensagem seguinte de marketing não é entregue, por mais correta que esteja a sua. É uma regra de proteção do usuário final, e não uma punição do seu número.
A Meta não publica o tamanho do teto. Na nossa operação o comportamento é compatível com algo na ordem de duas mensagens de marketing por pessoa por dia, somando todas as empresas. É uma leitura, não um número oficial, e pode mudar sem aviso.
Por que parece defeito seu
Porque ele aparece em volume justamente quando a base é boa. Quem dispara para uma lista de pessoas que também são alvo de outras operações, como acontece com base de crédito, vê o código em fatias grandes do disparo. E ele chega por webhook, depois de a Meta ter aceito o envio, então um sistema que só olha a resposta imediata nem percebe.
O que fazer, na ordem
Não reenvie na hora
O teto é por pessoa e por dia. Reenviar logo em seguida gasta tentativa e não muda o resultado. O erro é transitório: a mesma mensagem, depois de um tempo, costuma ser entregue.
Reenvie depois, em outro dia
Deixe a fila dos que falharam por 131049 para o dia seguinte, e não para a hora seguinte. Um sistema que separa este código dos erros definitivos permite reprocessar só esses, sem tocar nos que nunca vão chegar.
Veja a categoria do modelo
O teto vale para marketing. Se o texto é um aviso que o contato espera (cadastro, atualização, andamento), ele pode ser Utilidade, que não entra nesse teto e custa uma fração do preço. Confira também se a Meta não aprovou como marketing um modelo que você enviou como utilidade: a categoria final é dela.
Espalhe o disparo
Concentrar uma base inteira num único dia faz o teto bater para muita gente ao mesmo tempo. Dividir em dias e variar o horário reduz a fatia que volta recusada.
Como separá-lo dos outros erros
| Sinal | É o 131049? |
|---|---|
| Alguns contatos falham, outros do mesmo disparo entregam | Sim, é o padrão: o teto é por pessoa |
| Todos os contatos falham pelo mesmo número | Não: é a conta ou o número. Veja pagamento e saúde do número |
| O erro diz que o número não tem WhatsApp | Não: é o 131026, e esse não se reenvia |
| O contato pediu para não receber | Não: é o 131050, e esse nunca se reenvia |
O guia dos códigos de erro do disparo traz os outros, separados entre o que se reenvia e o que não se reenvia, e o do custo por mensagem explica por que a categoria muda a conta.