Bloqueio no WhatsApp Business API: tipos, códigos de erro e o que fazer

Entenda os tipos de bloqueio no WhatsApp Business API, o que significam os códigos 130472, 131049, 131026 e 368 e o que fazer em cada caso sem piorar a situação.

Bloqueio no WhatsApp é a primeira suspeita de quem vê um disparo falhar pela API oficial. Na maioria das vezes, porém, a conta está saudável. A Meta barrou aquela mensagem por um motivo que aparece no código de erro, e esse código diz se o problema está no cliente, no modelo de mensagem, no volume ou na conta.

Um caso recente mostra bem a confusão. Um cliente nosso recebeu o erro 130472 em parte de uma campanha, com o aviso de que o número do usuário fazia parte de um experimento. A primeira reação foi achar que o número da empresa tinha sido banido. Não tinha. A trava estava no número de quem ia receber, e a Meta nem cobrou pela mensagem.

Este guia organiza os bloqueios em quatro camadas, explica os códigos mais comuns e mostra o que fazer em cada caso. As regras vêm da documentação oficial da Meta, e avisamos quando uma informação vem de outra fonte.

Resumo: em qual camada está o bloqueio no WhatsApp?

  • Destinatário: o cliente está num experimento da Meta, atingiu o limite de mensagens de marketing ou pediu para não receber promoções. Sua conta não tem problema.
  • Modelo de mensagem: o template recebeu feedback negativo e foi segurado, pausado ou desativado.
  • Volume: a empresa atingiu o limite diário de clientes alcançados, a vazão da API ou o limite de envios para a mesma pessoa.
  • Conta: houve violação de política. É aqui que ficam as restrições temporárias, a trava por tempo indeterminado e a desativação.

Como descobrir o motivo de um bloqueio no WhatsApp?

O motivo de um bloqueio no WhatsApp aparece no código de erro que a Meta devolve. Ele chega de duas formas. Na resposta imediata da API, quando o envio é recusado na hora. Ou no webhook de status, com a mensagem marcada como failed, que é o caso mais comum em campanhas.

Se a sua plataforma mostra apenas "falhou", peça ao fornecedor o código numérico. Sem ele, qualquer diagnóstico é chute. Para problemas na conta, o lugar certo é o Business Support Home, no Meta Business Suite. Lá aparecem a política violada e as restrições ativas.

Quando o bloqueio no WhatsApp está no número do cliente?

O bloqueio no WhatsApp está no número do cliente quando a Meta decide não entregar mensagens de marketing para aquela pessoa. São os casos mais confundidos com banimento, porque a falha aparece no seu painel, mas a causa está do outro lado.

Erro 130472: o cliente está num experimento da Meta

O WhatsApp mantém um experimento em que uma parcela muito pequena dos usuários não recebe templates de marketing de nenhuma empresa. Quando o teste começou, em 2023, a Meta falava em cerca de 1% dos usuários. O objetivo é medir o efeito das mensagens de marketing na experiência de quem usa o aplicativo.

Quatro pontos práticos, todos da documentação da Meta:

  • A conta está normal. O erro não indica problema no seu número, no template ou na integração.
  • Não há cobrança. A mensagem não é enviada, e a Meta não cobra por ela.
  • Reenviar não adianta. Nova tentativa gera o mesmo erro, e a Meta não abre exceções para esse experimento.
  • A conversa iniciada pelo cliente resolve. A trava não vale quando há uma janela de atendimento aberta ou uma janela gratuita de entrada, como a dos anúncios Click to WhatsApp.

Por isso a Meta recomenda contatar a pessoa por outro canal, como e-mail, ligação ou SMS, e pedir que ela mande uma mensagem. Com a janela aberta, você reenvia o conteúdo.

Sobre o prazo, cuidado. Circulam prazos como 30 a 90 dias para o número sair do experimento, mas a Meta não publica esse número. A documentação diz apenas que o experimento não tem data para terminar. Trate qualquer prazo como estimativa.

Erro 131049: o cliente atingiu o limite de marketing

A Meta pode limitar quantos templates de marketing uma pessoa recebe de todas as empresas em um período. O limite se ajusta ao engajamento recente dela. Entram na conta a taxa de leitura de mensagens de marketing e o volume de conversas com amigos, família e empresas na caixa de entrada.

Ou seja, o cliente pode estar travado para a sua promoção por causa de mensagens que recebeu de outras marcas. Se ele responder a um template, abre-se uma janela de atendimento de 24 horas. Os templates de marketing enviados nessa janela não contam para o limite.

A orientação oficial é esperar pelo menos 24 horas antes de reenviar. Insistir piora, porque a Meta também limita quem repete tentativas para usuários que já atingiram o teto. O erro não afeta seus envios para outros clientes.

Esse limite não está ativo, por enquanto, para números do Espaço Econômico Europeu, do Reino Unido, do Japão e da Coreia do Sul. Já os números dos Estados Unidos não recebem templates de marketing de nenhuma empresa.

Erro 131050: o cliente parou de receber suas promoções

Esse código indica que o próprio cliente optou por não receber mensagens de marketing da sua empresa. Não tente reenviar. Retire o contato das listas de campanha e mantenha apenas as mensagens de utilidade que ele espera, como avisos de pedido.

Erro 131026: mensagem não entregue

O 131026 é um erro genérico de entrega. Entre as causas citadas por parceiros da Meta estão número sem WhatsApp, versão desatualizada do aplicativo e termos de uso ainda não aceitos pelo usuário. Não conclua que o cliente bloqueou sua empresa, porque o código não diz isso. Confirme o número por outro canal antes de insistir.

Quando o bloqueio no WhatsApp está no modelo de mensagem?

O bloqueio no WhatsApp está no modelo de mensagem quando o template recebe denúncias, bloqueios ou leitura baixa. Cada template tem uma nota de qualidade própria, em verde, amarelo ou vermelho. Essa nota define o que acontece com ele.

  • Pacing: templates novos, recém-despausados ou sem nota verde podem ser enviados primeiro para uma parte do público. A Meta segura o restante até ler a reação. Se o retorno for bom, libera tudo. Se for ruim, pausa o template e descarta as mensagens retidas com o erro 132015.
  • Pausa: o template com nota vermelha é pausado por 3 horas na primeira vez e por 6 horas na segunda. Enquanto ele estiver pausado, a API recusa os envios.
  • Desativação: na terceira ocorrência, o template é desativado. Para voltar a usar, é preciso editar e reenviar para aprovação.

Apagar o template e criar outro igual não resolve o problema de fundo. Revise o texto, a segmentação e a frequência antes de disparar de novo. Se a campanha depende de um template pausado, suspenda a campanha até ele voltar.

Quais são os limites de volume da API?

Os limites de volume da API controlam quanto a empresa pode enviar e, em geral, não são punição, embora muita gente os confunda com bloqueio no WhatsApp. Há três tipos:

  • Limite de mensagens: é o número máximo de clientes diferentes que a empresa alcança fora da janela de atendimento, em 24 horas móveis. Ele vale para o portfólio inteiro e é dividido entre todos os números. Portfólios novos começam com 250, e o limite pode subir para 2.000, 10.000, 100.000 e ilimitado.
  • Vazão (130429): a API recebeu mais mensagens por segundo do que aceita. A solução é reduzir a velocidade do disparo e tentar de novo depois.
  • Par empresa e cliente (131056): foram enviadas muitas mensagens para o mesmo cliente em pouco tempo. Espere e espace os envios.

Para subir de 250 para 2.000, a empresa precisa cumprir um dos caminhos de escala da Meta. Entre as opções citadas na documentação estão verificar a identidade do negócio ou entregar 2.000 mensagens fora da janela de atendimento, para clientes diferentes, em 30 dias, com templates de alta qualidade. Depois disso, o aumento é automático quando a empresa mantém boa qualidade e usa pelo menos metade do limite em 7 dias.

Erro 131048: o alerta que merece atenção

O 131048 é diferente dos outros limites de volume. Ele indica que o número sofreu uma restrição porque muitas mensagens anteriores foram bloqueadas ou denunciadas como spam. É o sinal de que os clientes estão reagindo mal. Pare o disparo, confira a qualidade do número no WhatsApp Manager e revise a lista e o conteúdo antes de continuar.

Quando a conta inteira é bloqueada?

A conta inteira é bloqueada quando a empresa viola as políticas do WhatsApp de forma repetida. Segundo a Meta, o processo é gradual e começa com um aviso que informa a política violada. É o tipo mais grave de bloqueio no WhatsApp. Se as violações continuam, vêm as restrições:

  1. 1 ou 3 dias sem enviar templates de marketing, utilidade e autenticação e sem adicionar números à conta.
  2. 5, 7 ou 30 dias sem enviar nenhuma mensagem e sem adicionar números.
  3. Trava por tempo indeterminado, que só sai com recurso.
  4. Desativação permanente da plataforma, se a empresa não mudar depois de vários avisos.

Entre os motivos citados pela Meta estão spam, classificação errada de templates e categorias de alto risco, como conteúdo adulto, álcool, tabaco, drogas, apostas e suplementos sem segurança. Em casos graves, como golpes, a remoção é imediata. Excesso de feedback negativo dos usuários também pode limitar ou remover a empresa.

Na API, essas sanções aparecem em códigos como o 368, de conta restrita ou desativada por violação de política, e o 131031, de conta travada. O 131031 também surge quando um dado da requisição não confere com a conta, como o PIN de verificação em duas etapas. Para entender o que a Meta realmente pune, vale ler nosso artigo sobre banimento no WhatsApp.

Como pedir revisão de uma restrição?

O recurso é feito no Business Support Home. Escolha a conta, selecione a violação, clique em Request Review e descreva o caso. A Meta informa que a decisão costuma sair em 24 a 48 horas e que a violação pode ser mantida ou revertida. Nem toda violação de spam aceita recurso. Nesses casos, resta esperar o fim da restrição.

Tabela de códigos: o que fazer em cada bloqueio no WhatsApp

CódigoO que significaCamadaO que fazer
130472Cliente em experimento da MetaDestinatárioNão reenviar. Pedir que o cliente inicie a conversa
131049Cliente atingiu o limite de marketingDestinatárioEsperar pelo menos 24 horas e rever a frequência
131050Cliente recusou o marketing da empresaDestinatárioTirar o contato das campanhas
131026Mensagem não entregueDestinatárioConfirmar o número por outro canal
132015Template pausadoModeloSuspender a campanha e revisar o texto
132016Template desativadoModeloEditar e reenviar para aprovação
130429Vazão da API atingidaVolumeReduzir a velocidade do disparo
131056Muitas mensagens para o mesmo clienteVolumeEsperar e espaçar os envios
131048Restrição por spamVolume e qualidadeParar e revisar lista e conteúdo
368Conta restrita por violaçãoContaVer o Business Support Home e pedir revisão
131031Conta travadaContaVer o Business Support Home e pedir revisão
131047Janela de 24 horas expiradaNão é bloqueioEnviar um template aprovado

O que não fazer diante de um bloqueio no WhatsApp?

  • Reenviar em loop. No 130472, o erro se repete. No 131049, a insistência gera novas restrições.
  • Trocar de número para fugir. O limite de mensagens é do portfólio, então um número novo divide o mesmo teto. E o problema de qualidade continua lá.
  • Classificar promoção como utilidade. A classificação errada de templates está entre os motivos de sanção à conta.
  • Confundir falha de entrega com banimento. Antes de qualquer decisão, leia o código.

Também não vale cortar a campanha inteira por causa de alguns 130472 ou 131049. Esses erros atingem pessoas específicas e não dizem nada sobre a saúde do seu número. Acompanhe a proporção deles por campanha. Se ela subir muito, o recado é sobre frequência e relevância.

Como a CodenTech ajuda a diagnosticar bloqueios?

A CodenTech é Tech Provider da Meta e acompanha operações de WhatsApp pela API oficial. No dia a dia, a maior parte dos chamados de bloqueio no WhatsApp se resolve na leitura do código de erro. O restante exige olhar a qualidade dos templates, a origem da lista e o histórico da conta.

Podemos ajudar a separar o que é ruído do que é risco real, configurar alertas pelos webhooks de status e de conta e revisar campanhas antes do disparo. Não prometemos reverter decisões da Meta, porque elas são da Meta. Se o seu número está com falhas e você não sabe por quê, conheça o CodenDesk ou fale com a gente pelo WhatsApp.

Sobre as fontes deste artigo

As regras sobre experimento, limites, qualidade e sanções vêm da documentação da Meta para desenvolvedores, consultada em 6 de novembro de 2026: Experiments e Per-user marketing template message limits, ambas atualizadas em 17 de junho de 2026, Messaging Limits, atualizada em 8 de maio de 2026, Policy and spam enforcement, Template pacing, Template pausing e Template quality rating.

A estimativa de 1% dos usuários vem da versão de 2023 da página de experimentos. As descrições dos códigos 131026, 131031, 131048, 131050, 131056, 130429, 368 e 132016 seguem a referência de códigos de erro da Meta, conferida por meio da reprodução publicada por parceiros como YCloud e 360dialog. Não encontramos em fonte oficial nenhum prazo para um número sair do experimento. Como as regras da Meta mudam com frequência, confira a documentação antes de decidir.

Texto de Gésio Flores, fundador da CodenTech e professor de inteligência artificial aplicada em cursos de pós-graduação.

Perguntas frequentes

O erro 130472 significa que meu número foi banido?

Não. O erro indica que o número do destinatário está num experimento da Meta que bloqueia templates de marketing. A trava vale para aquela pessoa, e sua conta, seus templates e sua integração continuam normais.

Sou cobrado pelas mensagens que voltam com o erro 130472?

Não. Segundo a Meta, a mensagem do grupo de experimento não é enviada e não é cobrada.

Quanto tempo um número fica no experimento da Meta?

A Meta não informa. A documentação diz apenas que o experimento não tem data para terminar e que não há exceções. Prazos como 30 a 90 dias circulam no mercado, mas não têm confirmação oficial.

Qual a diferença entre os erros 131049 e 131050?

O 131049 indica que o cliente atingiu o limite de mensagens de marketing que pode receber de todas as empresas, e você pode tentar de novo depois de 24 horas. O 131050 indica que ele recusou o marketing da sua empresa, então não deve haver nova tentativa.

Como saber se minha conta do WhatsApp foi bloqueada?

Abra o Business Support Home no Meta Business Suite. Ele mostra as violações, as restrições ativas e o caminho para pedir revisão. A Meta também avisa por e-mail aos administradores, por banner no WhatsApp Manager e pelo webhook account_update.

Trocar de número resolve um bloqueio no WhatsApp?

Em geral, não. O limite de mensagens é calculado para o portfólio inteiro, e as restrições por violação valem para a conta. Um número novo herda o mesmo teto, e o problema de lista ou de conteúdo continua.