Disparei e parte não chegou: como diagnosticar o erro 131049 e ajustar segmentação e frequência

O relatório da campanha mostra 5.000 mensagens enviadas e algumas centenas com status de falha. Ninguém mexeu na lista, o template foi aprovado e o número está saudável. Quem dispara pela API oficial já passou por isso, e a primeira reação costuma ser reenviar. É justamente o que a documentação da Meta recomenda não fazer.

Esta página mostra como ler o relatório, separa o erro do limite por pessoa (131049) dos outros códigos de falha mais comuns, explica o que a Meta documenta sobre o limite e termina com seis ajustes de segmentação e frequência e um checklist de pré-disparo. Os dados vêm da documentação da Meta lida em 21 de outubro de 2026.

Por que parte da mensagem de marketing não chegou?

Existem poucos motivos de verdade, e cada um deixa um rastro diferente no relatório. O erro depende de quem não recebeu: o número da pessoa, a conta da empresa ou o limite aplicado àquela pessoa.

• Limite de marketing por pessoa: o destinatário já recebeu mensagens de marketing demais, e a Meta segura as novas. É o erro 131049.
• Contato fora do WhatsApp ou que não aceitou os termos atuais: a mensagem não pode ser entregue. É o caso do erro 131026.
• Janela de 24 horas fechada: foi enviada uma mensagem livre onde só template funciona. É o erro 131047.
• Restrição por qualidade do número: muitos bloqueios e denúncias reduzem a capacidade de envio. Veja qualidade do número do WhatsApp API.
• Template pausado ou reprovado: o envio nem sai. Veja template reprovado no WhatsApp.

Como identificar o erro 131049 no relatório da campanha?

O erro chega no status da mensagem, enviado pela Meta ao webhook da sua plataforma com o estado de falha e o código. Para achar, filtre as falhas e agrupe por código.

1. 1
   Abra o relatório da campanha e filtre o status de falha

   Separe as mensagens que não foram entregues das que foram enviadas, entregues e lidas. Se o seu sistema não mostra o código, peça ao implementador o status bruto do webhook.

2. 2
   Agrupe as falhas pelo código de erro

   Conte quantas falhas tiveram 131049 e quantas tiveram outros códigos. O ramo do diagnóstico depende dessa divisão.

3. 3
   Olhe quem são os contatos com 131049

   Verifique quantas campanhas essas pessoas receberam de você nos últimos 7 e 30 dias. Se a maioria é de quem recebeu mais de uma, o problema é de frequência.

4. 4
   Registre no CRM e pare de reenviar

   Separe esses contatos numa lista de nova tentativa e agende o reenvio para daqui a pelo menos 24 horas, com uma única tentativa.

O que cada código de erro indica?

A tabela resume os quatro códigos de falha mais comuns em envio de marketing e o primeiro passo de cada um. Use-a depois de agrupar as falhas do relatório.

Os códigos podem mudar de nome e a mesma requisição pode devolver erros diferentes conforme a validação que falha primeiro. Por isso a regra é tratar o número do código e consultar a lista oficial de erros da Meta, indicada nas fontes desta página, quando aparecer um código novo.

O que a Meta documenta sobre o limite por pessoa?

O limite de mensagens de marketing por usuário é dinâmico, e a Meta não divulga o número. A documentação, atualizada em 17 de junho de 2026, o relaciona ao comportamento recente do destinatário, em particular à leitura das mensagens. Quanto mais a pessoa lê o que recebe, mais espaço as mensagens de marketing seguintes tendem a ter.

• Quando uma mensagem não é entregue por esse limite, o webhook devolve o status de falha com o código 131049.
• Se a empresa tenta reenviar várias vezes a quem já atingiu o limite, novas entregas a essa pessoa podem ficar indisponíveis por até 24 horas.
• A orientação é esperar pelo menos 24 horas antes de reenviar o template.
• O efeito é por pessoa. Não impede o envio para os demais contatos.

A consequência prática é boa: o limite premia quem envia o que a pessoa quer ler. Segmentação e relevância não são só estética de campanha, elas decidem se a mensagem chega.

Exemplo resolvido: a campanha do Pet Fácil

O Pet Fácil é um pet shop fictício. Os números são inventados para ilustrar o método. Ele disparou uma campanha de banho e tosa para 5.000 contatos, e 400 mensagens falharam com 131049. A conta é 400 dividido por 5.000, ou seja, 8 falhas em cada 100 envios.

A lição não é que a campanha foi ruim. É que 300 das 400 falhas estavam num grupo que já tinha sido contatado na semana anterior. A correção foi definir um intervalo mínimo por contato e dividir os disparos em ondas, começando por quem leu a última mensagem.

Quais ajustes de segmentação e frequência resolvem?

Seis ajustes, em ordem de urgência. Os dois primeiros evitam que o problema piore, e os quatro seguintes reduzem a chance de ele voltar na campanha seguinte.

1. 1
   Pare o reenvio em laço

   Configure uma fila de reenvio com espera mínima de 24 horas e uma única nova tentativa. Reenviar na hora só prolonga a indisponibilidade da pessoa.

2. 2
   Separe a lista por engajamento

   Crie três grupos: leu ou respondeu nos últimos 30 dias, entre 31 e 90 dias, e mais antigo. Dispare primeiro para o grupo quente e deixe o frio para uma campanha de reativação com outro texto.

3. 3
   Defina um intervalo mínimo por contato

   Por exemplo, uma campanha por semana por pessoa. Esse número é uma regra interna sugerida como ponto de partida, e não uma regra da Meta. Ajuste conforme o que o relatório mostrar.

4. 4
   Segmente por interesse, não só por lista

   Use a etapa do funil, a última compra, a origem e o produto de interesse. Uma oferta de tosa para quem só compra ração com você tende a ser ignorada. A página campanha de WhatsApp marketing mostra como montar a campanha.

5. 5
   Cuide do opt-in e da saída

   Registre quando e como a pessoa aceitou receber mensagens, e trate qualquer pedido para parar de receber na hora. Veja opt-in no WhatsApp.

6. 6
   Meça por campanha e pause quando subir

   Acompanhe falha por código, leitura e resposta em cada disparo. Se as falhas por 131049 crescerem entre uma campanha e outra, pause e revise o intervalo. Veja métricas de campanha de WhatsApp.

E em datas de pico, como a Black Friday?

É onde o limite mais pega, porque todas as empresas disparam ao mesmo tempo e a pessoa recebe várias ofertas num curto intervalo. O calendário de 2026 tem a Black Friday em 27 de novembro e a Cyber Monday em 30 de novembro. A saída é planejar poucas mensagens bem segmentadas e usar a base própria quente, em vez de insistir. O roteiro está em campanha de Black Friday no WhatsApp.

O que conferir antes de disparar uma campanha de marketing?

Dois modelos copiáveis: um checklist de pré-disparo para colar na rotina da equipe e uma linha de registro para comparar uma campanha com a outra.

[ ] A lista tem opt-in registrado e quem pediu para sair foi retirado.
[ ] Separei a lista em engajados (30 dias), mornos (31 a 90 dias) e frios.
[ ] Nenhum contato recebeu campanha minha nos últimos ___ dias (intervalo mínimo da empresa).
[ ] O template está aprovado e na categoria correta (oferta é marketing).
[ ] O disparo está dividido em ondas, começando pelos engajados.
[ ] Sei onde ver o status de falha por código no relatório.
[ ] Reenvio configurado: espera mínima de 24 horas e uma única tentativa.
[ ] Há alguém acompanhando a primeira hora e autorizado a pausar.
[ ] Os contatos com erro 131049 vão para a lista de nova tentativa.

Campanha: ____________ | Data: ____________ | Template: ____________
Enviadas: ____ | Entregues: ____ | Lidas: ____ | Respostas: ____
Falhas 131049: ____ | Falhas 131026: ____ | Outras: ____
Grupo que concentrou as falhas: ____________
Ajuste para o próximo disparo: ____________

Onde o CRM entra: segmentar é função do funil

Quem tem o funil organizado no CRM já tem boa parte da segmentação pronta: etapa, origem, produto de interesse e data do último contato. O DataCrazy reúne esses dados e traz BI interno com conversão por origem, vendedor e produto, que ajudam a escolher o grupo certo para cada campanha. A montagem dos grupos por engajamento, a fila de reenvio e o disparo pela API oficial são trabalho de implementação, e a AD PRO faz essa estruturação na etapa de disparos pela API oficial. Para a parte de segurança do envio, veja disparo em massa de WhatsApp seguro.