Nobre CRM
Testar grátis
Guias

Meu número foi banido na API oficial. Como descobrir o que aconteceu?

8 min de leitura

Se você chegou aqui depois de procurar "número banido no WhatsApp", já deve ter lido a mesma receita cinco vezes: abra o aplicativo, toque em "Solicitar revisão", mande um e-mail para o suporte, espere de 24 a 72 horas. Essa é a resposta para o WhatsApp Business comum, aquele que se instala no celular. Se o seu número está na API oficial, nada disso se aplica: não há aplicativo para abrir, o formulário não existe, e o e-mail cai num suporte que não atende contas de API.

Pior: antes de saber o que fazer, é preciso saber o que aconteceu. E o painel da Meta não conta.

Três coisas diferentes que parecem a mesma

O que a operação chama de "número banido" costuma ser um destes três estados, e o gesto certo muda em cada um:

O que éO que aconteceOnde aparece
Queda de qualidadeO número continua enviando, mas o teto de contatos por dia cai. Ninguém é bloqueado.Qualidade do número, no Gerenciador
RestriçãoA conta para de poder enviar por um período, ou perde a capacidade de adicionar números. Tem prazo.Só na Graph API, em restriction_info
BanimentoO número morre. Não há prazo, e o que existe é recurso, não espera.status: BANNED, no nó dos números

Os três chegam do mesmo jeito para quem está olhando: o disparo para de sair. A diferença é que, no primeiro, esperar resolve; no segundo, esperar resolve e há data; e no terceiro, esperar não resolve nunca.

Por que o painel não basta

O campo que a maioria das plataformas mostra é o health_status, e ele engana nos dois sentidos. Foi medido na nossa operação, em 11 de setembro de 2026, sobre 49 contas de WhatsApp Business:

Uma conta bloqueada por forma de pagamento recusada (erro 141006) aparece como se estivesse punida. E uma conta de fato restrita pode continuar respondendo status: ACTIVE.

Ou seja: o indicador que parece dizer "está tudo bem" não diz, e o que parece dizer "você foi punido" às vezes está falando do cartão de crédito. Tratar os dois como a mesma coisa faz a operação passar o fim de semana tentando recorrer de uma punição que não existe, enquanto a fatura continua em aberto.

Como perguntar à Meta o que ela realmente sabe

Os três campos que respondem não aparecem em painel nenhum. Eles estão no nó da conta de WhatsApp Business, na Graph API, e é preciso pedir por nome:

GET /{waba_id}?fields=restriction_info,ban_info,violation_info

Cada um responde uma pergunta distinta:

CampoO que ele diz
restriction_infoQual restrição está ativa e até quando. É o único lugar com a data de fim.
ban_infoSe a conta foi banida e em que estado está o recurso, quando há um.
violation_infoQual regra a Meta entendeu como violada. É o que diz o que corrigir.

Para o número, e não para a conta, quem denuncia é outro campo ainda — e este foi medido em 16 de setembro de 2026:

GET /{waba_id}/phone_numbers

O status de cada número vale BANNED quando ele morreu. Não aparece como "desconectado", não vira erro de PIN, e tentar registrar o número de novo devolve apenas Invalid parameter (código 100), que não diz nada sobre a causa.

Foi exatamente assim que cinco números da nossa operação passaram dias classificados como "instância perdida numa realocação entre contas". Não eram. Estavam banidos desde sempre, e o único lugar que dizia isso era um campo que ninguém tinha pedido.

Duas armadilhas que a documentação não menciona

As duas foram medidas em 11 de setembro de 2026 e valem para a versão 26 da API:

1

O teto de mensagens pode simplesmente não vir

O campo messaging_limit_tier, que diz se o número está em 250, 1.000, 10.000 ou 100.000 contatos por dia, não é devolvido para todos os números. A Meta responde 200 e simplesmente omite o campo. Conferimos pedindo o campo sozinho em seis números saudáveis: nenhum voltou. Código que assume a presença dele quebra sem erro.

2

Pedir várias contas de uma vez deixou de funcionar

O parâmetro ids=, que permitia consultar várias contas numa chamada, foi aposentado na versão 26. Quem tem dezenas de contas precisa de uma chamada por conta. Na nossa operação, 49 chamadas com pausa de cerca de 350 ms passam sem estourar a cota.

O que fazer com a resposta

Com os campos em mãos, o caminho deixa de ser adivinhação:

1

Restrição com data

Há prazo, e ele é cumprido. O trabalho aqui não é recorrer, é entender o violation_info e mudar o que causou — quase sempre ritmo de disparo, público que não pediu para receber, ou modelo com cara de propaganda numa categoria de utilidade.

2

Banimento

O recurso é pelo Gerenciador de Contas Comerciais, na própria conta, e não por e-mail. Clicar em "solicitar revisão" qualquer um faz; o que muda o resultado é o que você corrige antes de mandar. Recurso enviado sem tocar na causa que o violation_info aponta volta negado, e cada negativa deixa a próxima mais difícil.

3

Nada nos três campos

Se restrição, banimento e violação vierem vazios e o disparo mesmo assim não sai, o problema provavelmente não é punição: é forma de pagamento, é o número sem registro, ou é o teto de 24 horas do próprio número. São três coisas que se resolvem sozinho, em minutos.

Onde a Nobre entra

Recuperar número banido é o trabalho que a gente faz todo dia, e ele tem três partes — nenhuma delas é insistir:

1

Ler o que a Meta acusou, e não o que o painel mostra

Os três campos do começo deste texto, mais o histórico de qualidade do número. É onde aparece se o caso foi ritmo de disparo, público que não pediu para receber, modelo em categoria errada, ou nada disso — e cada um pede uma correção diferente.

2

Corrigir antes de recorrer, e recorrer uma vez só

A correção é o argumento. Um recurso que diz "corrigimos o ritmo e tiramos da base quem pediu para sair" é outra conversa que um recurso que diz "por favor liberem".

3

Acompanhar o estado sem ficar olhando

A Meta muda o estado do recurso sem avisar ninguém, e ele só aparece para quem pergunta. A nossa ferramenta faz essa pergunta sozinha e avisa quando muda, em vez de alguém abrir o Gerenciador todo dia.

Ninguém pode garantir desbanimento, e garantia é o sinal de golpe. Quem decide é a Meta, sempre. O que se faz é chegar no recurso com a causa corrigida e o argumento certo — e é isso que separa um caso que volta de um que não volta.

E enquanto o recurso corre, a operação não precisa parar: número novo conectado, base e histórico no lugar, disparo saindo no mesmo dia. Na prática é isso que segura o mês de quem perdeu o número principal numa sexta-feira.

O que dá para fazer antes

Quase todo banimento que vimos de perto tem a mesma origem: volume alto num número novo. Um número recém-conectado começa em 250 contatos únicos por dia, e é a Meta quem sobe esse teto conforme a qualidade se mantém. Disparar dez mil no primeiro dia não é agressivo: é impossível, e a tentativa é o que queima o número.

Três medidas que funcionam, e que a operação usa todo dia: espalhar o disparo por vários números em rodízio, em vez de gastar um; deixar pausa aleatória entre os envios, porque ritmo constante é assinatura que qualquer detecção lê de longe; e tirar da base quem pediu para sair antes da próxima campanha, e não depois da reclamação.

As três são maneiras de dizer a mesma coisa: quem bane o número é quem recebe a mensagem, não a Meta. A Meta só executa.