Erro 131049 no WhatsApp: o que significa e como resolver

O 131049 quer dizer que o WhatsApp decidiu não entregar um template de marketing para aquele contato. Não é erro de código, de template nem de conta: é um limite que o WhatsApp aplica por pessoa, somando as mensagens de marketing de todas as empresas que falam com ela.

O que a Meta diz

A tabela de códigos da Meta descreve o erro assim — e é esse o texto que chega em title e message; o error_data.details traz outra frase, como no exemplo mais abaixo. Na tradução oficial da Meta: “essa mensagem não foi entregue para manter o engajamento saudável do ecossistema”.

Descrição na tabela de códigos da MetaThis message was not delivered to maintain healthy ecosystem engagement.

Por que acontece

O WhatsApp limita quantos templates de marketing uma pessoa recebe num período quando ela tende a não se engajar com eles. Segundo a Meta, o critério combina, entre outros fatores, a taxa de leitura recente de mensagens de marketing daquela pessoa e quantas mensagens ela já tem na caixa — de amigos, de família e de empresas. O limite é adaptativo: muda sozinho, contato a contato.

Na prática, há dois caminhos para o erro:

O contato já bateu o limite — ele recebeu marketing demais de empresas em geral, não só da sua. A sua mensagem foi a que passou do ponto.
Reenvio antes de 24 horas — a empresa tentou de novo, dentro de 24 horas, para quem já tinha batido o limite. A Meta avisa que novas tentativas para esses contatos podem ficar indisponíveis por até 24 horas, devolvendo o mesmo 131049.

O limite não está ativo para mensagens enviadas de números comerciais do Espaço Econômico Europeu, do Reino Unido, do Japão ou da Coreia do Sul, nem para usuários nesses países. O Brasil não está entre as exceções: número brasileiro mandando para contato brasileiro está sujeito a ele.

O que conta para o limite

Cada template de marketing entregue conta.
Se o contato responde, abre-se a janela de atendimento de 24 horas, e o marketing enviado dentro dela não conta.
Só templates da categoria MARKETING entram. Um template criado como utilidade e reclassificado pela Meta como marketing passa a contar — o guia de envio de template mostra como conferir a categoria aprovada.

Como resolver

Não há correção do seu lado que faça aquela mensagem sair agora. O que funciona:

Espere 24 horas antes de reenviar para o mesmo contato. Reenvio automático em laço só gera mais 131049.
Mande marketing para quem se engaja. O critério olha a leitura de marketing daquela pessoa; campanha para lista fria é a que mais esbarra no limite.
Prefira a conversa iniciada pelo contato. Com a janela aberta, a mensagem não conta para o limite — um botão de WhatsApp no site ou um anúncio que leva à conversa fazem o contato falar primeiro.
Confira a categoria. Aviso de pedido, cobrança e lembrete são utilidade; se a Meta classificou como marketing, revise o texto.
Tenha outro canal para o que for urgente: o WhatsApp pode segurar marketing, e e-mail ou SMS não dependem desse critério.

Como o 131049 aparece no CRPRO Hub

O envio responde 202 normalmente — a mensagem foi aceita. A recusa vem depois, no evento message.status com status: "failed", e o array errors chega como a Meta mandou. O exemplo abaixo usa o texto que a própria Meta publica para este código:

message.status com 131049

{
  "id": "7a2c9e10-4b3d-4f5e-8a6b-1c2d3e4f5a6b",
  "event": "message.status",
  "channel_id": "9f6a9c1e-2f3d-4a5b-8c7d-1e2f3a4b5c6d",
  "occurred_at": "2026-10-03T12:00:00.000Z",
  "data": {
    "message_id": "wamid.EXEMPLO456",
    "status": "failed",
    "recipient_id": "5521999999999",
    "conversation": null,
    "pricing": null,
    "errors": [
      {
        "code": 131049,
        "title": "This message was not delivered to maintain healthy ecosystem engagement.",
        "message": "This message was not delivered to maintain healthy ecosystem engagement.",
        "error_data": {
          "details": "In order to maintain a healthy ecosystem engagement, the message failed to be delivered."
        },
        "href": "https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes/"
      }
    ]
  }
}

No histórico do canal, a mensagem fica com error_code igual a 131049. Um tratamento razoável: ao receber o evento, marque o contato e a campanha, e só agende nova tentativa depois de 24 horas — nunca na hora.

Não confunda com dois vizinhos que também são marketing não entregue: o 131050 (o contato desligou o marketing da sua empresa — não reenvie) e o 130472 (o contato está num experimento da Meta e não recebe marketing de ninguém).

Perguntas frequentes

Quanto tempo esperar depois do erro 131049?

Pelo menos 24 horas antes de reenviar o mesmo template para o mesmo contato. A Meta avisa que reenviar antes disso gera novos erros e piora a precisão dos relatórios da campanha.

O erro 131049 é cobrado?

A Meta cobra por mensagem entregue, e o 131049 é justamente uma mensagem que não foi entregue. A página da Meta sobre o limite por contato, porém, não fala de cobrança; confira na fatura da conta se tiver dúvida.

Dá para pedir à Meta que libere o limite?

A documentação não prevê liberação manual. O limite é calculado por contato e se ajusta sozinho conforme o engajamento daquela pessoa com mensagens de marketing.

Template de utilidade também recebe o erro 131049?

O limite vale para templates de marketing. Mas a Meta pode reclassificar um template de utilidade como marketing se o conteúdo for promocional, e a partir daí ele passa a contar.

Erros parecidos

131050 — O contato parou de receber marketing da sua empresa.
130472 — O contato está num experimento da Meta que não recebe marketing.
131047 — A janela de atendimento de 24 horas está fechada.
131048 — O número está com envio restrito por bloqueios e denúncias.

A lista completa, com o que fazer em cada caso, está em códigos de erro da Meta. Os erros do próprio CRPRO Hub, como META_SEND_FAILED, estão em erros da API.

Fontes

Fonte: códigos de erro da Cloud API, limite de marketing por usuário, webhook de status, documentação da Meta conferida em 3 de outubro de 2026.