Resposta rápida
Quando a Meta bloqueia um número, todo envio volta com o erro 131031 e nada é entregue. O bloqueio raramente vem de um erro só. Costuma ser a soma de volume subindo rápido, mensagem repetida, frequência alta e aviso sem conteúdo. O caminho é parar os envios, corrigir tudo antes e pedir revisão uma vez, no lugar certo. Num caso que acompanhamos, a Meta revisou e liberou o número cerca de 25 horas depois do bloqueio.
Um serviço por assinatura manda avisos pelo WhatsApp. No começo de outubro, saíam uns 100 templates por dia, todos pela API, com qualidade verde na Meta. Em três semanas, o volume chegou perto de 1.000 por dia. No último dia, foram uns 2.000.
Numa manhã, saíram cerca de 770 templates em uma hora. Sete horas depois, todo envio passou a voltar com erro. O número apareceu como BANNED. A Meta não mandou aviso prévio nem motivo. Até ali, a qualidade estava verde.
Esse é um caso que acompanhamos de perto, com final feliz. Este guia mostra os sinais que os dados revelaram, o que fazer quando o número trava e como evitar chegar lá.
Como saber se o número foi bloqueado
O sinal mais claro é o erro 131031 ("Business account has been locked"). Ele quer dizer que a conta está travada. Tentar de novo não entrega nada.
Dois outros códigos ajudam a ler o que está acontecendo antes do bloqueio. A Meta explica os critérios na página de aplicação de políticas (abre em nova aba).
| Erro | O que significa | O que fazer |
|---|---|---|
| 131031 | Conta travada | Parar todo envio. Repetir não entrega nada. |
| 131049 | A Meta segurou a mensagem por baixo engajamento | Tratar como alerta e rever volume, frequência e conteúdo. |
| 131026 | A mensagem não pôde ser entregue (por exemplo, número sem WhatsApp) | Limpar a base. |
Repare em um detalhe: a qualidade verde não protege sozinha. No caso, ela estava verde até a hora do bloqueio.
Os sinais que levaram ao bloqueio
Os dados mostraram oito sinais. Nenhum deles é raro. Juntos, eles contam a história.
1. Volume subindo de uma vez
De uns 100 para uns 2.000 por dia em três semanas. E para gente que ainda não reconhecia o número.
2. Mensagem duplicada
Por uma falha na integração do próprio negócio, dois processos rodaram o mesmo disparo. Umas 360 pessoas receberam o mesmo aviso duas vezes, com 2 segundos de diferença. Para quem recebe, parece descuido ou golpe.
3. Frequência alta
Numa semana, cerca de 200 contatos receberam template todos os dias, inclusive no fim de semana. Uns 300 receberam em 5 dias ou mais. O próprio site do negócio prometia "no máximo uma mensagem por dia útil".
4. Mensagem sem conteúdo
Um aviso diário dizia só que "hoje não teve novidade". É o tipo de mensagem que mais leva a bloqueio e denúncia.
5. Pouca leitura
Três em cada quatro contatos não aparecem como tendo lido nenhuma mensagem na semana. O número pode estar inflado por quem desliga a confirmação de leitura. Mesmo assim, a Meta mede engajamento e começa segurando entregas (erro 131049) antes de travar.
6. Ofertas para quem não comprou
Templates de marketing com desconto iam para quem deixou o pagamento em aberto. É a famosa recuperação de carrinho.
7. Pedidos para sair
Eram poucos ("Sair", "para de me mandar mensagem"). Mas cada pedido não atendido vira candidato a denúncia.
8. O texto do site
A política de privacidade dizia que a empresa podia fazer "primeiro contato" com quem não tinha se cadastrado. A Política de Mensagens do WhatsApp Business (abre em nova aba) exige autorização antes da primeira mensagem. A base legal da LGPD não substitui isso. E quem analisa o recurso lê o site.
O que não estava na lista: base comprada. Os contatos digitavam o próprio WhatsApp no site. O que pesou foi o comportamento de envio.
O número estava em coexistência, com o app do celular junto da API. Isso não teve a ver com o bloqueio. O mesmo padrão de envio travaria um número conectado só na API.
O que fazer quando o número trava
1. Pare todos os envios
Cada nova tentativa volta recusada. Insistir só soma recusas. Pausar é o primeiro passo.
No BotoZap, se a Meta bloquear o número, o dono recebe um e-mail. E os envios recusados por conta travada não gastam a cota de templates do plano.
2. Corrija tudo antes de pedir
No caso, estas mudanças foram feitas antes do recurso:
- Os envios foram pausados.
- A falha que duplicava envios foi corrigida. Só um processo envia por vez.
- O aviso diário "sem novidade" acabou.
- Ofertas e recuperação de carrinho saíram do WhatsApp.
- O limite passou a ser uma mensagem por dia útil, nada no fim de semana.
- "Sair" e pedidos parecidos removem o contato na hora.
- O trecho de "primeiro contato" saiu da política de privacidade.
O pedido de revisão convence pelo que já mudou. Não pelo que você promete mudar.
3. Peça revisão no lugar certo
O lugar depende de como o número está conectado:
- Número conectado só pela API: Central de Suporte para Empresas da Meta, na violação listada, botão de solicitar análise.
- Número em coexistência: pelo próprio app WhatsApp Business no celular, na tela de bloqueio ("Pedir revisão" ou "Entrar em contato com o suporte").
Se a tela não oferecer revisão, o WhatsApp trata o banimento como definitivo. Os detalhes estão em Sobre o banimento de contas (abre em nova aba), na Central de Ajuda do WhatsApp.
No caso, a Central de Suporte para Empresas não deixava pedir revisão. O botão estava desabilitado e a lista, vazia. O suporte da Meta explicou que, em número em coexistência, o pedido sai pelo app no celular.
4. Faça um pedido só, completo e verdadeiro
Diga como os contatos autorizam as mensagens, o que deu errado e o que já mudou. Um pedido. Sem exagero e sem promessa.
Contato por fora do pedido não acelera nada. O WhatsApp diz que a maioria das revisões sai em até 24 horas.
5. Não tente contornar
Conectar outro número na mesma conta para driblar o bloqueio atrapalha a análise. O bloqueio é da conta, não só do número.
Como terminou
O pedido de revisão foi feito pelo app. A Meta revisou e liberou a conta cerca de 25 horas depois do bloqueio. A tela do app dizia:
"Agora esta conta pode usar o WhatsApp. Verificamos os dados do dispositivo e as atividades da conta para confirmar que estão de acordo com os Termos de Serviço do WhatsApp Business."
Depois da liberação, foi preciso verificar o número de novo no app, com código por SMS. Nessa etapa, mantenha marcada a opção de continuar conectado à plataforma e não desconecte nada. A Meta religa a API sozinha quando a verificação termina. No caso, isso levou cerca de duas horas.
Desde então, tudo é entregue. O volume é baixo e espaçado. Nenhuma mensagem repetida, nenhum pedido para sair. A qualidade segue verde.
Como evitar chegar lá
- Suba o volume aos poucos, para gente que já reconhece o seu número.
- Garanta que cada pessoa receba cada aviso uma vez só.
- Cumpra a frequência que você promete no site.
- Não mande aviso que diz que não tem novidade. Sem novidade, sem mensagem.
- Separe aviso de oferta. Pense bem antes de mandar desconto para quem não comprou.
- Atenda o "Sair" na hora.
- Peça autorização antes da primeira mensagem, e deixe o texto do site dizer o mesmo.
- Trate o erro 131049 como alerta, não como ruído.
No BotoZap, cada negócio tem a sua palavra de saída. Quem manda essa palavra para de receber mensagens de marketing daquele negócio. Um envio de marketing para essa pessoa é recusado antes de chegar à Meta. Há também a palavra de volta, para o próprio contato voltar a aceitar.
Para montar avisos espaçados, veja a régua de acompanhamento no WhatsApp. Para envios em volume, veja disparo em massa pela API oficial.
Para quem integra outro sistema
A duplicidade do caso veio de dois processos rodando o mesmo disparo. A API do BotoZap aceita o cabeçalho Idempotency-Key. Com a mesma chave e o mesmo corpo, o segundo pedido devolve a resposta do primeiro e nada sai de novo.
Funciona na API, no SDK (idempotencyKey), na CLI (--idempotency-key) e no MCP. A referência está em Mensagens: idempotência.
E se a resposta for 131031, pare a fila. Repetir não entrega nada.
Comece pelo número oficial
Bloqueio se evita com envio cuidadoso, em qualquer modo de conexão. Se você ainda vai montar a operação, comece pelo WhatsApp oficial. No BotoZap, a conexão oficial leva minutos pela janela da Meta, só API ou em coexistência com o app do celular. A equipe atende pelo painel. O passo a passo está em conectar o WhatsApp.
Na documentação
Perguntas frequentes
O que significa o erro 131031 no WhatsApp?
Significa que a conta foi travada pela Meta ("Business account has been locked"). Enquanto ela estiver travada, tentar de novo não entrega nada. O certo é parar os envios, corrigir o que causou o bloqueio e pedir revisão.
Onde peço revisão de um número bloqueado?
Depende da conexão. Número só na API: Central de Suporte para Empresas da Meta, na violação listada, botão de solicitar análise. Número em coexistência: pelo app WhatsApp Business no celular, na tela de bloqueio ("Pedir revisão" ou "Entrar em contato com o suporte").
Quanto tempo a Meta leva para revisar?
O WhatsApp diz que a maioria das revisões sai em até 24 horas. No caso que acompanhamos, a Meta revisou e liberou a conta cerca de 25 horas depois do bloqueio.
Qualidade verde garante que o número não vai travar?
Não. No caso que acompanhamos, a qualidade estava verde até a hora do bloqueio. O que pesou foi o comportamento de envio: volume subindo rápido, mensagem repetida, frequência alta e aviso sem conteúdo.
A coexistência aumenta o risco de bloqueio?
Não. O bloqueio vem do comportamento de envio. O mesmo padrão de envio travaria um número conectado só na API. A coexistência muda só o lugar de pedir revisão, que passa a ser o app do celular.
Posso conectar outro número enquanto o primeiro está bloqueado?
Não para contornar o bloqueio. O bloqueio é da conta, e conectar outro número na mesma conta para driblar a trava atrapalha a análise.