Número bloqueado na API do WhatsApp: como evitar e o que fazer se for restringido

Atualizado em 20/10/2026

Na API oficial do WhatsApp, a Meta raramente derruba um número sem etapas: o processo descrito na documentação começa com aviso, passa por bloqueios temporários de envio (de 1 a 30 dias), chega ao bloqueio por tempo indeterminado e só no fim à desativação, com exceção de casos graves, como golpes, exploração infantil e venda de drogas ilegais, que são removidos na hora. Para evitar, colete opt-in claro com o nome da empresa, envie só o que o usuário espera, respeite pedidos para parar e acompanhe a qualidade. Se a conta for restringida, veja o motivo no Business Support Home e peça revisão quando couber.

Este guia mostra como a Meta aplica as medidas, os sinais que levam a elas, como monitorar pela API e o que fazer em cada situação.

Bloqueio, restrição e limite não são a mesma coisa

Quando alguém diz “meu número foi bloqueado”, pode estar falando de coisas bem diferentes:

Situação	O que acontece	Como você percebe
Template pausado	Um template com qualidade baixa fica fora do ar por 3 h, depois 6 h; na terceira vez é desativado	Erro 132015 ou 132016; webhook message_template_status_update
Limite de mensagens atingido	O portfólio alcançou o teto de usuários únicos em 24 horas	Envios fora da janela param até o período liberar
Limite de taxa por qualidade	A Meta restringe envios de quem tem qualidade baixa por muito tempo	Erro 131048 (“muitas mensagens bloqueadas ou marcadas como spam”)
Restrição de conta	Bloqueio temporário de templates ou de qualquer mensagem, por violação de política	Webhook account_update com ACCOUNT_RESTRICTION; erro 368
Bloqueio indeterminado ou desativação	Conta impedida de enviar até recurso, ou removida da plataforma	Webhook account_update com DISABLED_UPDATE; aviso no Business Support Home
Usuário bloqueou a empresa	Só aquele contato deixa de receber	Sinal negativo que pesa na qualidade

Restrição de conta e desativação são medidas de aplicação de política. Pausa de template, limite de mensagens e limite de taxa costumam ser resolvidos ajustando público, volume e conteúdo; o artigo sobre limite de mensagens da API do WhatsApp trata delas.

Como a Meta aplica as medidas

A documentação de aplicação de políticas descreve uma escala. Na primeira violação, a conta recebe um aviso com a política violada. Se as violações se repetem (spam, templates classificados na categoria errada, setores de alto risco), vêm restrições que aumentam de duração:

1. Bloqueio de 1 ou 3 dias para enviar templates de marketing, utilidade e autenticação e para adicionar números.
2. Bloqueio de 5, 7 ou 30 dias para enviar qualquer mensagem e para adicionar números.
3. Bloqueio da conta por tempo indeterminado, removido só por recurso.
4. Desativação permanente da plataforma, se nada mudar depois de vários avisos.

Violações que causam dano grave aos usuários, como exploração infantil, golpes, terrorismo ou venda de drogas ilegais, levam à remoção imediata. A Meta também informa que pode limitar ou remover empresas por excesso de feedback negativo.

Quer testar enquanto lê? Crie sua conta na Vectalk e envie a primeira mensagem pela API oficial. Criar conta grátis →

Opt-in: a base para não ser bloqueado

A Política de Mensagens do WhatsApp Business exige permissão antes do contato. Desde a atualização de novembro de 2024, o opt-in pode ser geral, não precisa mencionar o WhatsApp, desde que cumpra a lei local. Você pode falar com alguém quando ele (a) informou o número de celular e (b) confirmou que quer receber mensagens ou ligações daquela empresa.

A Meta pede três requisitos:

• deixar claro que a pessoa está aceitando receber comunicações;
• deixar claro o nome da empresa que vai enviar;
• cumprir a legislação aplicável, que no Brasil inclui a LGPD.

O método é escolha sua: formulário no site, SMS, ligação com URA, papel assinado no balcão. Um exemplo de texto em checkbox de cadastro:

[ ] Quero receber da Loja Exemplo, pelo WhatsApp, avisos sobre meus pedidos
    e, se eu marcar abaixo, ofertas e novidades.
[ ] Quero receber ofertas e novidades da Loja Exemplo pelo WhatsApp.

Separar avisos e ofertas segue a recomendação da Meta de pedir consentimento por categoria. Quem aceitou só avisos e começa a receber promoções tende a bloquear.

Guarde a prova: data, hora, origem (página, loja, atendente), texto exato aceito e o número. Se houver denúncia ou questionamento, você sabe de onde veio o contato.

Opt-out: respeite pedidos dentro e fora do WhatsApp

A política determina respeitar todos os pedidos para parar, feitos dentro ou fora do WhatsApp. Na prática:

• Tenha um botão de resposta rápida “Parar de receber” nos templates de marketing e trate a resposta no webhook, marcando o contato na hora.
• Trate palavras como “sair”, “parar” e “não quero” em mensagens livres.
• Sincronize descadastros feitos por e-mail, site ou SAC com a base do WhatsApp.

O próprio WhatsApp dá ao usuário a opção de parar as mensagens de marketing de uma empresa. Se você enviar mesmo assim, o envio falha com o erro 131050, e o webhook user_preferences avisa quando o usuário para ou retoma. Use esse evento para atualizar a base em vez de insistir.

Qualidade: os sinais que pesam

A qualidade é calculada sobre os últimos 7 dias, com peso maior para o mais recente, a partir de bloqueios, denúncias, silenciamentos, arquivamentos e dos motivos que o usuário informa ao bloquear. As recomendações da Meta para manter a nota alta:

• seguir a Política de Mensagens do WhatsApp Business;
• enviar só para quem deu opt-in;
• personalizar e entregar algo útil;
• evitar mensagens de boas-vindas ou apresentação abertas;
• não enviar mensagens demais por dia;
• ajustar conteúdo e tamanho.

Ao lançar uma nova forma de coletar opt-in, a Meta recomenda acompanhar a qualidade de perto. O mesmo vale para campanhas novas: comece por uma amostra da base e só amplie se a nota se mantiver.

Setores e conteúdos que geram violação

A Política de Comércio do WhatsApp proíbe transacionar alguns produtos e serviços. A lista de violações que a Meta pode aplicar inclui, entre outras:

Código da violação	Exemplos
ALCOHOL	Bebidas alcoólicas e kits para produzir bebida
GAMBLING	Apostas, cassinos online, loterias e jogos pagos
DRUGS	Drogas ilegais, recreativas ou com prescrição (fabricantes e serviços de saúde sem venda direta são permitidos)
TOBACCO	Cigarros, cigarros eletrônicos, narguilés
SUPPLEMENTS	Suplementos considerados inseguros, como esteroides anabolizantes
MISLEADING	Marketing multinível, opções binárias, empréstimos de curto prazo, cobrança de dívidas
DIGITAL_SERVICES_PRODUCTS	Venda de conteúdo, assinaturas e contas digitais
THIRD_PARTY_INFRINGEMENTS	Falsificações e cópias não autorizadas

Antes de integrar um cliente, confira se o modelo de negócio dele cabe na política. Nenhuma configuração técnica protege um número usado para algo proibido.

Templates também são avaliados pelo conteúdo. Pedir número completo de cartão ou documento, ameaçar o cliente ou classificar promoção como utilidade de forma recorrente leva a reprovações e, no último caso, a restrições próprias. Veja os detalhes no guia de templates da API do WhatsApp.

Monitorando pela API

Três recursos da Cloud API avisam antes que um problema vire bloqueio. Na Vectalk, os webhooks chegam no mesmo formato da Meta nas URLs que você registrou.

Webhook account_update. Informa violações (ACCOUNT_VIOLATION, com o código da violação), restrições (ACCOUNT_RESTRICTION, com tipo e data de expiração) e mudanças de banimento (DISABLED_UPDATE). Um exemplo de restrição:

{
  "field": "account_update",
  "value": {
    "event": "ACCOUNT_RESTRICTION",
    "restriction_info": [
      { "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING", "expiration": 1767225600 },
      { "restriction_type": "RESTRICTED_ADD_PHONE_NUMBER_ACTION", "expiration": 1767225600 }
    ]
  }
}

RESTRICTED_BIZ_INITIATED_MESSAGING impede iniciar conversas; RESTRICTED_CUSTOMER_INITIATED_MESSAGING impede até responder clientes. Ao receber esse evento, suspenda campanhas automaticamente e alerte o time.

Campo health_status. Na Graph API, consultar GET /{id}?fields=health_status em um número, conta ou template devolve AVAILABLE, LIMITED ou BLOCKED para cada nó envolvido no envio (app, portfólio, conta, número e template), com a descrição do erro quando há bloqueio.

Qualidade do número. O campo quality_rating (GREEN, YELLOW, RED) aparece na consulta do número. Na Vectalk:

curl 'https://apis.vectalk.com.br/api/phone-numbers?fields=id,display_phone_number,quality_rating' \
  -H 'Authorization: Bearer SEU_TOKEN_DE_INSTANCIA'

Fui restringido: o que fazer

1. Pare os envios automáticos. Campanhas e réguas de cobrança continuam batendo na API e gerando erro.
2. Leia a violação no Business Support Home. Em Meta Business Suite, acesse Todas as ferramentas, depois Business Support Home e Visão geral da conta. A notificação mostra a política violada, exemplos do que é ou não permitido, as restrições ativas e o que acontece numa reincidência.
3. Decida entre reconhecer e recorrer. Se a empresa estava dentro da política, clique em Solicitar análise na violação, explique o caso e envie. A Meta informa que a decisão costuma sair em 24 a 48 horas e a violação fica “Inalterada” ou “Revertida”. Nem toda violação de spam aceita recurso; nesses casos é preciso esperar o fim da restrição.
4. Corrija a causa antes de voltar. Revise a origem da lista, a frequência, os templates que mais geraram bloqueio e o opt-out.
5. Volte aos poucos. Retome com o público mais engajado e acompanhe qualidade e webhooks antes de ampliar.

Mantenha os dados dos administradores do portfólio atualizados: as notificações de violação vão por e-mail para eles, além dos webhooks e do banner no WhatsApp Manager.

Número banido no app comum

Um número banido no WhatsApp comum não pode ser registrado na Cloud API enquanto o banimento não for revertido pelo processo de recurso do WhatsApp. Isso aparece com frequência em quem usava ferramentas não oficiais e decide migrar. O guia sobre como migrar para a API oficial do WhatsApp cobre esse cenário.

Bloqueando usuários abusivos

A API também permite que a empresa bloqueie contatos que enviam spam ou ofensas. Na Vectalk, a chamada é POST /api/block-users:

curl -X POST https://apis.vectalk.com.br/api/block-users \
  -H "Authorization: Bearer SEU_TOKEN_DE_INSTANCIA" \
  -H "Content-Type: application/json" \
  -d '{ "users": ["5584988887777"] }'

Pela documentação da Meta, só dá para bloquear quem enviou mensagem nas últimas 24 horas, até 1.000 usuários por requisição, com lista de no máximo 64.000 bloqueados.

Perguntas frequentes

Usar a API oficial garante que meu número não será bloqueado?

Não. A API oficial elimina o risco de banimento por uso de ferramenta não autorizada, mas a Meta continua aplicando a política a quem envia spam, sem opt-in ou em setores proibidos.

Quantos bloqueios de usuários derrubam um número?

A documentação consultada não traz um número. A qualidade considera bloqueios, denúncias, silenciamentos e arquivamentos dos últimos 7 dias, com peso maior para os mais recentes.

O recurso demora quanto tempo?

A documentação indica que a análise costuma levar de 24 a 48 horas.

Se um número for restringido, os outros números do portfólio continuam funcionando?

Depende do nível da medida. Restrições podem atingir o número, a conta do WhatsApp Business ou o portfólio. O health_status mostra qual nó está limitado ou bloqueado.

Opere com segurança pela Vectalk

A Vectalk usa a API oficial da Meta e repassa os webhooks da documentação, inclusive os de qualidade e de restrição, para você automatizar a resposta a cada evento. Você usa um token para todas as contas, oferece coexistência com o app WhatsApp Business e paga a Meta pela Vectalk, sem cartão cadastrado na Meta. Crie sua conta em apps.vectalk.com.br/register, veja os endpoints em docs.vectalk.com.br ou fale com o time pela página de contato.

---

Fontes oficiais consultadas em 20/10/2026: Aplicação de políticas e spam na plataforma, Como obter opt-in, Política de Mensagens do WhatsApp Business (atualizada em 23/09/2026).