O que significa o erro 131049 do WhatsApp quando o template de marketing não é entregue?

O erro 131049 quer dizer que a Meta não entregou um template de marketing para aquela pessoa para manter o que ela chama de engajamento saudável do ecossistema. Na prática é um limite por usuário: quem recebe marketing de empresas e não interage passa a receber menos. Não é defeito do seu número nem do template. A documentação manda esperar pelo menos 24 horas antes de reenviar, e reenviar em loop só piora.

O que a documentação diz

Conferi as páginas da Meta em 10 de outubro de 2026. A tabela de códigos de erro da Cloud API descreve o 131049 como "esta mensagem não foi entregue para manter o engajamento saudável do ecossistema" e recomenda aguardar pelo menos 24 horas antes de reenviar o template.

A página de limites por usuário explica o mecanismo. O WhatsApp pode limitar quantos templates de marketing uma pessoa recebe de qualquer empresa em um período, e esse limite se ajusta ao longo do tempo conforme o engajamento recente dela, incluindo a taxa de leitura. Cada template de marketing entregue conta para o limite. O erro chega pelo webhook de mensagens, com status failed, quando a mensagem não é entregue por causa desse limite ou de tentativas repetidas de reenvio.

Três detalhes dessa página mudam a conduta:

• Reenviar dentro das 24 horas só devolve outro erro, e a Meta diz que isso pode reduzir a precisão do relatório de entrega da campanha. Novas tentativas para aquele usuário podem ficar indisponíveis por até 24 horas. O bloqueio é por usuário e não afeta o envio para outras pessoas.
• Marketing enviado dentro da janela de atendimento de 24 horas não conta para o limite. A janela abre quando o usuário responde.
• A página lista regiões em que o limite não está ativo hoje: Espaço Econômico Europeu, Reino Unido, Japão e Coreia do Sul, tanto para número de negócio nessas regiões quanto para usuários nelas. Separado disso, a mesma página diz que o WhatsApp não entrega, por ora, templates de marketing para usuários com número dos Estados Unidos. Esse é outro bloqueio, que devolve erro, e não tenho evidência de que tenha relação com o caso abaixo.

Não encontrei nessa página nada sobre anúncios que abrem conversa no WhatsApp (Click to WhatsApp). Não vou afirmar uma regra que a documentação que li não traz.

O que vi em produção

Em um sistema de atendimento que mantenho, uma pessoa do time mandou um template de abertura para um lead pelo painel de conversas. A mensagem ficou como failed e o erro era o 131049. O lead nunca recebeu.

Dois efeitos laterais mereceram atenção. O primeiro: a automação de réguas de follow-up viu aquilo como uma mensagem enviada. Mensagem recusada de uma pessoa do time ainda disparava o webhook de saída do painel de conversas, e a automação marcou o lead como já abordado, sem entrega alguma. O segundo: quem olha só a contagem de templates disparados acha que a régua está funcionando.

Por que acontece

A Meta protege a experiência de quem recebe. Se uma pessoa recebe vários templates de marketing e não lê nenhum, o sistema reduz quantos novos chegam a ela, de qualquer empresa. Isso é coerente com o que vi: o mesmo template entregou para um contato e falhou para outro. A documentação diz que o limite depende do engajamento recente de cada pessoa, e é essa a minha explicação, não uma regra que a Meta descreva com esse exemplo.

Reenviar em seguida não ajuda. A documentação diz que o limite pode valer por períodos diferentes para cada pessoa, que reenviar só gera outro erro e que as tentativas repetidas podem deixar novos envios indisponíveis por até 24 horas.

O que fazer

1. Tratar o 131049 como não entregue e não fatal. Registrar o erro por contato, sem tentar de novo na hora.
2. Esperar pelo menos 24 horas antes de qualquer reenvio do mesmo template, como manda a documentação.
3. Não marcar o contato como abordado só porque a mensagem saiu do seu lado. Marque pela confirmação de entrega que chega no webhook de status, não pelo envio.
4. Ler o 131049 na taxa de entrega esperada de uma régua de marketing. Parte dos contatos não vai receber, e o desenho da régua tem de aguentar isso.
5. Usar a janela de atendimento. Quando o lead responde qualquer coisa, a janela de 24 horas abre e o limite deixa de contar naquele período.
6. Se a mensagem for de fato utilidade, como confirmar um agendamento ou avisar de um pedido que o cliente fez, o template deve estar na categoria correta. Não vi documentado o que a Meta faz com promoção cadastrada como utilidade, não testei e não recomendo tentar.
7. Para quem não engaja no WhatsApp, usar outro canal, como e-mail ou ligação.

Se o seu atendimento no WhatsApp depende de réguas de template e você quer entender o que está chegando de verdade ao cliente, veja como eu monto e opero atendimento no WhatsApp com IA.