Qualidade do número no WhatsApp API: como evitar restrição

A qualidade do número no WhatsApp API é a nota que a Meta dá ao seu número com base na reação dos clientes às mensagens dos últimos sete dias: verde (alta), amarelo (média) ou vermelho (baixa). Bloqueios, denúncias e mensagens ignoradas derrubam essa nota. Desde outubro de 2025, nota baixa não rebaixa mais o limite de envio, mas impede o limite de subir, pode pausar templates e, se persistir, leva a restrições na conta. Para recuperar, você interrompe o que gera rejeição, corrige base e conteúdo e retoma os envios aos poucos.

Neste guia você vai entender o que a Meta mede, a diferença entre qualidade do número, qualidade do template e conta restrita, e como evitar e reverter cada situação.

O que é a qualidade do número no WhatsApp API

Segundo a documentação de envio de mensagens da Meta, a qualidade é calculada sobre como as suas mensagens foram recebidas nos últimos sete dias, com peso maior para o que aconteceu mais recentemente. Entram na conta sinais como:

• bloqueios do seu número;
• denúncias de spam;
• silenciamentos e arquivamentos da conversa;
• os motivos que o cliente escolhe ao bloquear você.

Pela central de ajuda da Meta sobre a classificação de qualidade, quem bloqueia uma empresa pode escolher motivos como "não preciso mais", "não me cadastrei", "spam" e "mensagens ofensivas". Muito "não me cadastrei" aponta para a origem da lista. Muito "não preciso mais" aponta para frequência ou relevância.

Números com tráfego alto podem mudar de qualidade em minutos, então uma campanha mal segmentada derruba a nota no mesmo dia.

Verde, amarelo e vermelho: o que cada cor significa

No Gerenciador do WhatsApp, em Ferramentas da conta > Números de telefone, a coluna de qualidade mostra três estados:

• Verde (alta): os clientes recebem bem suas mensagens. A Meta diz que manter o verde deixa a empresa elegível para mais recursos.
• Amarelo (média): já existe rejeição relevante. É o momento de reduzir frequência e revisar público e conteúdo.
• Vermelho (baixa): muitos clientes reagiram mal. Manter o ritmo trava o crescimento do limite e aumenta o risco de pausas de template e de ações de política.

Com a nota em amarelo ou vermelho, passe o mouse sobre ela para ver os motivos de bloqueio, quando disponíveis. Na coluna de configurações fica o histórico dos últimos 30 dias, útil para cruzar a queda com o dia de uma campanha.

O que mudou: limite por portfólio e fim do status sinalizado

Muito conteúdo antigo ainda fala em número "sinalizado" (Flagged) que perde nível de envio depois de sete dias. Essa regra acabou: a central de ajuda da Meta informa que os status de número Flagged e Restricted foram descontinuados em 7 de outubro de 2025.

Na mesma data, conforme a nota da Meta sobre a mudança nos limites, o limite passou a valer para o portfólio empresarial inteiro, compartilhado por todos os números. Hoje vale assim:

• A qualidade baixa não rebaixa o limite automaticamente. Se o seu portfólio está em 10.000 contatos por dia, uma nota vermelha não leva você de volta para 2.000.
• A qualidade alta é condição para subir. A documentação de limites de mensagens exige mensagens de alta qualidade em todos os seus números e templates, além de uso de pelo menos metade do limite nos últimos sete dias.
• Um número afeta os outros. Uma campanha ruim no número de vendas pode travar o crescimento do número de suporte.

Os níveis de 250 a ilimitado estão explicados no guia sobre limite de mensagens do WhatsApp API.

Qualidade do template: pausa e desativação

Cada modelo de mensagem também tem nota própria. Pela documentação de qualidade de templates, ela pode ser pendente, alta, média ou baixa, e considera feedback negativo e taxa de leitura.

Quando um template chega à qualidade baixa, a regra de pausa de templates entra em ação:

1. Primeira vez: o template fica pausado por 3 horas.
2. Segunda vez: pausado por 6 horas.
3. Terceira vez: o template é desativado.

Durante a pausa, a API recusa o envio daquele modelo. As tentativas não são cobradas nem consomem limite, mas a campanha para, então interrompa as automações que dependem dele até o template voltar a ficar ativo.

No começo a pausa não atinge o número, e outros templates bons continuam saindo. Mas, se a empresa insiste em templates que caem para qualidade baixa, o número pode acabar afetado.

Existe ainda o controle de ritmo de templates (template pacing): templates novos de marketing e utilidade, ou sem nota alta, podem ter parte dos envios retida até a Meta medir a reação dos primeiros clientes. Se a reação for ruim, as mensagens retidas são descartadas. Para criar modelos com menos risco de rejeição, veja o guia de templates do WhatsApp e aprovação na API oficial.

Quando a conta fica restrita de verdade

Sem o antigo status de número restrito, "número restrito" hoje quase sempre significa uma ação de política sobre a conta do WhatsApp Business. A página de aplicação de políticas da Meta descreve uma escada progressiva para quem viola repetidamente as regras, por exemplo com spam, categoria de template errada ou venda de produtos proibidos:

• primeiro, um aviso com a política violada;
• bloqueio de 1 ou 3 dias para enviar templates de marketing, utilidade e autenticação e para adicionar números;
• bloqueio de 5, 7 ou 30 dias para enviar qualquer mensagem;
• bloqueio da conta por tempo indeterminado, que só sai com recurso;
• desativação permanente da plataforma, se a empresa não mudar depois de vários avisos.

Em casos graves, como golpes, a conta é removida na hora. A Meta também pode limitar ou remover a empresa por feedback negativo excessivo, e a Política de Mensagens do WhatsApp Business confirma que bloqueios e denúncias podem limitar quantas mensagens você envia.

Há também o controle de ritmo do portfólio: portfólios com menos de 500 mil templates enviados em 365 dias têm disparos grandes entregues em lotes. Se o retorno indicar spam, o restante é descartado e o portfólio fica impedido de enviar e criar templates durante a revisão.

Como consultar o status do número e da conta

Você tem três lugares para acompanhar a saúde da operação:

1. Gerenciador do WhatsApp: em Ferramentas da conta > Números de telefone você vê status, qualidade e limite de cada número.
2. Business Support Home, na Meta Business Suite: mostra violações, restrições ativas e o botão para pedir revisão. Os avisos também chegam por e-mail aos administradores do portfólio, então mantenha esses contatos atualizados.
3. Pela API: o campo quality_rating do número retorna GREEN, YELLOW ou RED, e o campo health_status resume se o número, a conta, o portfólio e o template estão disponíveis, limitados ou bloqueados para envio.

Quem integra por API pode assinar os webhooks account_update, para violações e restrições, e message_template_status_update, para pausas de template.

Como evitar a queda de qualidade

A maioria das quedas nasce de lista sem consentimento, mensagem genérica, excesso de frequência e público errado. Na prática:

• Envie só para quem pediu. A política exige que a pessoa tenha dado o número e confirmado que quer receber suas mensagens. Lista comprada é o caminho mais curto para o "não me cadastrei".
• Peça opt-in por tipo de mensagem. A Meta recomenda separar o consentimento para avisos de pedido, ofertas e lembretes. Quem aceitou o rastreio da compra não quer, necessariamente, promoção toda semana.
• Evite a primeira mensagem genérica. A documentação desaconselha mensagens de boas-vindas abertas. Diga logo o motivo do contato: o boleto que vence amanhã, o Pix pendente do pedido, o acesso ao infoproduto que acabou de ser liberado.
• Controle a frequência. Se a base recebeu campanha ontem, espere antes da próxima.
• Segmente. Quem comprou na loja virtual no último mês reage melhor do que quem baixou um material há um ano.
• Respeite a saída. Ofereça um botão para parar de receber e remova quem pedir, dentro ou fora do WhatsApp, como a política exige.
• Use a categoria certa. Classificar marketing como utilidade é uma das violações citadas pela Meta.
• Teste template novo com poucos contatos engajados e acompanhe a nota antes de liberar para todos.

O guia de disparo em massa no WhatsApp em conformidade aprofunda segmentação, frequência e coleta de opt-in.

Como recuperar a qualidade do número

Se a nota caiu para amarelo ou vermelho, siga esta ordem:

1. Pare os disparos ativos que usam o número, principalmente campanhas de marketing.
2. Leia os motivos de bloqueio no Gerenciador do WhatsApp e cruze com o histórico de 30 dias para achar a campanha que causou a queda.
3. Limpe a base: retire contatos sem opt-in claro, quem nunca respondeu e quem pediu para sair.
4. Revise o template. Você pode editar um template pausado, mas ele volta para análise e só pode ser enviado depois de aprovado de novo.
5. Volte devagar, com mensagens úteis para a parte mais engajada da base. Como a nota olha os últimos sete dias, envios saudáveis e constantes puxam a qualidade para cima.
6. Se houve restrição de política, abra a violação no Business Support Home. Se você acredita que estava dentro das regras, clique em pedir revisão e explique o contexto. A resposta costuma sair em 24 a 48 horas. Nem toda violação de spam aceita recurso: em alguns casos é preciso esperar o fim do bloqueio.

API oficial protege, mas não substitui boas práticas

A API oficial elimina o risco de banimento por automação não autorizada, que é o que derruba números ligados a ferramentas não oficiais. Mas qualidade, opt-in e política da Meta continuam valendo e ainda podem restringir a conta. A comparação completa está no artigo API oficial vs não oficial do WhatsApp.

Como a WizeBot ajuda a manter a qualidade

Na WizeBot você conecta a sua própria conta do WhatsApp Business pela API oficial, então qualidade e limite são os do seu portfólio. A nota você acompanha no Gerenciador do WhatsApp da Meta, e a plataforma ajuda a manter a operação saudável:

• Disparos em massa com segmentação, para mandar cada campanha só para quem faz sentido.
• CRM Kanban e etiquetas, para separar quem comprou, quem está negociando e quem pediu para sair.
• Chatbot com IA e fluxos visuais que respondem rápido e transferem para um atendente humano quando precisa.
• WhatsApp Flows e carrossel, para mensagens mais úteis do que um texto genérico.
• Webhooks, API HTTP e integrações com Hotmart, Kiwify, Eduzz, Shopify, WooCommerce, Pipedrive e Google Sheets, para avisar sobre pedido e pagamento na hora em que o cliente espera.

As mensagens são pagas diretamente à Meta, sem markup da WizeBot. Os planos são Básico (R$ 197 por mês), Pro (R$ 297) e Elite (R$ 397), com 25% de desconto no anual, e cada número adicional custa R$ 97 por mês.

Qualidade alta depende de falar com quem quer ouvir você, no momento certo. Para operar na API oficial com segmentação, IA e atendimento humano no mesmo lugar, clique em Começar agora e conte com 30 dias de garantia. Se não gostar, devolvemos 100%. Antes, se preferir, veja como funciona, compare os planos e tire dúvidas na central de ajuda. #Wizebot