Quality rating e messaging limits: como não ter o número banido

Para quem constrói na WhatsApp Business API, o número não é um detalhe de infra — é o ativo. Um número restrito derruba campanha, intake e notificação ao mesmo tempo. E o pior: quando o estrago aparece no dashboard, ele já aconteceu dias atrás, numa janela móvel que você não viu rodar.

A boa notícia é que a Meta não bane do nada. Existe um sistema legível por trás disso — quality rating, messaging limits e status do número — e ele é governado por sinais que você controla no design do produto. Este é o playbook para ler esses sinais e proteger os números antes de a luz ficar vermelha.

Quality rating: o termômetro que você precisa olhar

A Meta atribui a cada número um quality rating com três cores, visível no WhatsApp Manager:

• Verde — qualidade alta.
• Amarelo — qualidade média; sinal de alerta.
• Vermelho — qualidade baixa; risco real de rebaixamento.

A cor é calculada a partir de sinais dos usuários numa janela móvel (rolling window): bloqueios, denúncias e feedbacks de “não é útil” depois que a pessoa recebe sua mensagem. Não é o que você acha da sua mensagem — é o que o destinatário faz com ela.

Dois pontos que confundem todo mundo:

1. É retroativo e defasado. A janela móvel significa que a cor de hoje reflete o comportamento dos últimos dias. Quando vira amarelo, o problema já está rodando.
2. Volume amplifica. Um punhado de denúncias num número que manda pouco pesa muito mais do que o mesmo número absoluto num número com tráfego alto.

Quality rating não é uma nota de prova — é a média móvel da paciência dos seus destinatários. Trate cada bloqueio como dívida técnica que vence em dias.

Messaging limits: como os tiers escalam (e despencam)

Além da cor, todo número tem um messaging limit — quantos contatos únicos você pode iniciar (business-initiated) numa janela de 24h. Isso escala por tiers, em função de qualidade e verificação de negócio.

A progressão típica vai mais ou menos assim:

• Tier inicial — na casa de 250 contatos únicos / 24h (novo número, sem verificação de negócio).
• Depois 1K → 10K → 100K contatos únicos / 24h.
• E um teto efetivamente ilimitado no topo.

Os números exatos de cada tier mudam e dependem da sua conta. Trate-os como ordem de grandeza, não como contrato — sempre confirme no WhatsApp Manager e na doc da Meta.

O mecanismo importa mais que os números:

• Subir é automático. Mantenha qualidade alta e bata um volume relevante dentro do tier atual, e a Meta promove o número sozinha.
• Descer também. Qualidade baixa pode rebaixar o tier ou restringir o número, cortando seu teto de envio bem na hora em que você mais precisa dele.
• Verificação de negócio é pré-requisito para destravar os tiers altos. Sem ela, você fica preso no degrau inicial por mais limpo que seja seu tráfego.

A leitura para builders: o limite não é uma cota fixa que você “compra”. É um privilégio que sobe com bom comportamento e some com mau comportamento.

Status do número: o caminho até o ban

O quality rating é o sintoma; o status do número é o diagnóstico. Ele costuma andar por estes estados:

• Connected — operando normalmente.
• Flagged — a qualidade caiu e o número entrou em observação. Aqui você ainda envia, mas está sendo avaliado. É a sua janela de correção.
• Restricted — o limite foi reduzido. Menos contatos únicos por 24h até a qualidade se recuperar.

E, separado disso, violações repetidas de política (não só qualidade baixa) podem escalar para ban. Qualidade ruim restringe; violar política bane. São trilhos diferentes, e os dois levam ao mesmo abismo.

A consequência prática: Flagged é o seu alarme, não Restricted. Se você só reage quando o limite já caiu, perdeu a janela barata de conserto.

O que realmente queima um número

Quase todo ban ou rebaixamento rastreia para uma destas causas:

• Mandar para quem não deu opt-in. A causa número um. Sem permissão, a pessoa bloqueia ou denuncia — e a janela móvel registra.
• Lista comprada ou contato frio. Marketing para quem nunca te chamou é o atalho mais rápido para o vermelho.
• Pico súbito de volume sem warm-up. Sair de 50 para 5.000 envios num dia parece spam para o sistema, mesmo que a lista seja limpa.
• Template spam ou categorizado errado. Conteúdo promocional disfarçado de utilidade, ou template mal-categorizado, derruba engajamento e atrai denúncia.
• Ignorar opt-out. Continuar mandando depois do “pare” é violação direta de política.

Repare no padrão: nenhuma dessas é sobre a tecnologia. Todas são sobre expectativa do destinatário. O sistema da Meta é, no fundo, um proxy para “essa pessoa queria receber isso?”.

O playbook para builders

Se você onboarda clientes ou opera múltiplos números, qualidade vira problema de engenharia de produto, não de operação manual:

• Opt-in explícito por design. Desenhe o onboarding e os fluxos para coletar e registrar o consentimento. Guarde a prova. Opt-in não é checkbox de termos — é o que separa seu número do vermelho.
• Warm-up gradual. Número novo começa devagar e sobe volume ao longo de dias/semanas, acompanhando o tier. Não force o degrau.
• Mensagem relevante e esperada. A pessoa deve reconhecer por que está recebendo aquilo. Categorize o template corretamente e respeite a janela de 24h para conversas livres.
• Opt-out fácil e respeitado. Saída de um toque, processada na hora. Barato de implementar, caríssimo de ignorar.
• Monitore qualidade em escala. Não dá para olhar número por número no WhatsApp Manager quando são dezenas. Instrumente alertas para quando qualquer número virar amarelo — Flagged é o gatilho de ação.
• Proteja o ativo do cliente. O número é dele, mas a reputação de quem construiu a integração também está em jogo. Trate cada número de cliente como você trataria o seu de produção.

Um reforço que vale o esforço: número com verificação de negócio e selo tende a sofrer menos marcação e destrava os tiers altos. Vale entender os caminhos de verificação no post sobre o selo azul no WhatsApp Business antes de prometer escala para um cliente.

Perguntas frequentes

Meu número virou amarelo. Vou ser banido? Não necessariamente. Amarelo é alerta, não sentença. É a janela para agir: pause campanhas frias, revise opt-in e relevância, reduza a cadência. Como a métrica usa janela móvel, parar a fonte do problema costuma recuperar a cor com o tempo. Vermelho ignorado é que vira restrição.

Quanto tempo leva para a qualidade se recuperar? Depende da janela móvel e do volume. Como o cálculo é deslizante, mensagens ruins “saem da conta” conforme envelhecem — desde que você não continue gerando novas denúncias. Não há botão de reset; é comportamento limpo somado ao tempo.

Posso pagar para subir de tier mais rápido? Não. O tier sobe por qualidade alta + volume relevante + verificação de negócio, de forma automática. O que você controla é qualidade e verificação; o resto é o sistema da Meta promovendo (ou rebaixando) o número.

Qual a diferença entre número Restricted e banido? Restricted é reversível: o limite caiu por qualidade baixa e volta a subir quando a qualidade se recupera. Ban é a consequência de violações de política — outro trilho, bem mais difícil de reverter. Por isso qualidade e conformidade são problemas separados, e os dois precisam de atenção.

Tiers, status e critérios da Meta mudam com frequência e variam por conta. Valide sempre na fonte oficial: Quality rating e messaging limits no WhatsApp Manager.

Conteúdo da comunidade WhatsApp Founders 🇧🇷 — independente, sem vínculo oficial com o WhatsApp ou a Meta.