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 ou 3 dias sem enviar templates de marketing, utilidade e autenticação e sem adicionar números à conta.
- 5, 7 ou 30 dias sem enviar nenhuma mensagem e sem adicionar números.
- Trava por tempo indeterminado, que só sai com recurso.
- 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ódigo | O que significa | Camada | O que fazer |
|---|---|---|---|
| 130472 | Cliente em experimento da Meta | Destinatário | Não reenviar. Pedir que o cliente inicie a conversa |
| 131049 | Cliente atingiu o limite de marketing | Destinatário | Esperar pelo menos 24 horas e rever a frequência |
| 131050 | Cliente recusou o marketing da empresa | Destinatário | Tirar o contato das campanhas |
| 131026 | Mensagem não entregue | Destinatário | Confirmar o número por outro canal |
| 132015 | Template pausado | Modelo | Suspender a campanha e revisar o texto |
| 132016 | Template desativado | Modelo | Editar e reenviar para aprovação |
| 130429 | Vazão da API atingida | Volume | Reduzir a velocidade do disparo |
| 131056 | Muitas mensagens para o mesmo cliente | Volume | Esperar e espaçar os envios |
| 131048 | Restrição por spam | Volume e qualidade | Parar e revisar lista e conteúdo |
| 368 | Conta restrita por violação | Conta | Ver o Business Support Home e pedir revisão |
| 131031 | Conta travada | Conta | Ver o Business Support Home e pedir revisão |
| 131047 | Janela de 24 horas expirada | Não é bloqueio | Enviar 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.