Erro 131048 no WhatsApp: Spam rate limit hit — o que é e como resolver

O erro 131048 (Spam rate limit hit) significa que a Meta restringiu temporariamente os envios do seu número porque muitas mensagens anteriores foram bloqueadas ou denunciadas como spam pelos destinatários. A solução é verificar o quality rating no WhatsApp Manager, pausar as campanhas, enviar apenas para contatos com opt-in e retomar o volume gradualmente — a restrição costuma ceder em 24 a 48 horas conforme a qualidade se recupera. Durante o bloqueio, responder clientes que falam com você continua funcionando.

Se o seu disparo de WhatsApp começou a falhar em massa com o código 131048, a Meta está dizendo uma coisa específica: os destinatários estão reclamando das suas mensagens. Este guia explica o diagnóstico e a recuperação.

O que é o erro 131048

A resposta da API (HTTP 400) ou o webhook de status failed chega assim:

{
  "error": {
    "message": "(#131048) Spam rate limit hit",
    "type": "OAuthException",
    "code": 131048,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "Message failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam."
    },
    "fbtrace_id": "..."
  }
}

Não confunda com vizinhos: 131056 é limite por par (mensagens demais para o mesmo destinatário em pouco tempo) e 80007 é limite de throughput. O 131048 é sobre reputação.

Por que ele acontece

O gatilho é o feedback negativo dos últimos ~7 dias: destinatários bloqueando o número, marcando como spam ou denunciando. As causas raiz de sempre:

Base sem opt-in — lista comprada ou raspada é o caminho mais curto para o 131048
Volume alto e repentino em número frio, sem escalonamento
Conteúdo genérico e insistente — a mesma oferta para a base inteira, repetida
Sem opção de descadastro — quem não consegue sair, denuncia
Reenvio para quem não engaja — contato frio insistido vira bloqueio

Há relatos na comunidade Meta de contas com rating "High" recebendo 131048 — a Meta usa sinais internos além do rating visível. Nesses casos, a receita é a mesma: reduzir cadência e, se persistir, abrir ticket.

Como resolver, passo a passo

Cheque o quality rating — WhatsApp Manager → Phone numbers → coluna Quality rating (verde/amarelo/vermelho). Sobre ratings médio/baixo, o painel mostra os motivos de bloqueio informados pelos usuários.
Pause todas as campanhas ativas. Insistir durante a restrição só aprofunda o problema.
Limpe a base — remova quem nunca deu opt-in, quem não engaja há meses e quem já falhou antes.
Revise o conteúdo — personalize com variáveis, segmente por interesse e inclua opção clara de saída.
Retome gradualmente — volumes menores, começando pelos contatos mais engajados, monitorando a taxa de failed no webhook.
Aguarde o ciclo de qualidade — a restrição típica cede em 24–48 horas, e o rating é reavaliado numa janela de ~7 dias.

Importante: o 131048 limita mensagens iniciadas pela empresa. Conversas iniciadas pelo cliente (janela de 24 horas) continuam funcionando — seu atendimento não para.

Como nunca mais ver esse erro

O 131048 é, na prática, o custo de tratar o WhatsApp como e-mail dos anos 2000. A prevenção é estrutural:

Opt-in sempre, com registro de quando e onde foi coletado
Segmentação por comportamento em vez de "base inteira"
Aquecimento de número respeitando os tiers da API oficial
Monitoramento contínuo da taxa de bloqueio e dos status de entrega

Plataformas construídas sobre a API oficial ajudam porque colocam guarda-corpos nesse processo: a Wizebot roda campanhas segmentadas por tags e comportamento, com relatórios de entrega em tempo real — o padrão de envio que mantém o quality rating alto e o 131048 longe.

Perguntas frequentes

Quanto tempo dura o bloqueio do erro 131048?

A Meta não publica prazo fixo. O consenso do ecossistema é de 24 a 48 horas para a restrição ceder, com a qualidade sendo reavaliada em ciclos de ~7 dias. A liberação é gradual e depende de o padrão de envio melhorar — não adianta só esperar e repetir o comportamento.

O erro 131048 pode banir meu número?

O 131048 em si é uma restrição temporária, não banimento. Mas ignorá-lo e insistir no mesmo padrão de envio derruba o quality rating, pausa templates e pode levar a restrições mais severas na conta. Trate-o como o aviso formal que ele é.

Posso continuar atendendo clientes durante a restrição?

Sim. O limite atinge conversas iniciadas pela empresa (templates). Respostas a clientes que mandaram mensagem — a janela de atendimento de 24 horas — continuam funcionando normalmente.

Recebi 131048 com quality rating alto. E agora?

Acontece — a Meta usa sinais internos de spam além do rating visível no WhatsApp Manager. Reduza a cadência, reforce a segmentação e, se o erro persistir com qualidade comprovadamente alta, abra um ticket no Direct Support da Meta incluindo o fbtrace_id do erro.

O 131048 é o WhatsApp protegendo a caixa de entrada dos usuários — e, bem lido, ele é um mapa do que corrigir na sua operação. Para disparar com segmentação, opt-in e métricas desde o início, a Wizebot opera suas campanhas sobre a API oficial com as boas práticas embutidas.