> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/solucao-de-problemas/quality-rating-red.md). # O que fazer quando o número está com Quality Rating RED ## O que é o Quality Rating do WhatsApp O Quality Rating (classificação de qualidade) é uma nota que o Meta atribui ao seu número do WhatsApp Business API com base na experiência dos usuários com suas mensagens nos últimos sete dias. Ele reflete diretamente a reputação do seu número perante a plataforma. Existem três níveis: | Status | Cor | Significado | | ------ | ----------- | -------------------------------------------- | | Alta | 🟢 Verde | Número saudável, sem restrições | | Média | 🟡 Amarelo | Qualidade em queda, monitoramento necessário | | Baixa | 🔴 Vermelho | Número em risco de restrição ou banimento | Você verifica o status do seu número diretamente no **Meta Business Manager → Ferramentas da Conta → Números de Telefone**, na coluna "Qualidade". Dentro da Patagon AI, o campo "Qualidade" fica visível em **Agente → Geral → Configurações**, na seção de Informações do número conectado, e também na tela de **Leads → Campanhas**, onde o aviso "Não elegível para mensagem" aparece quando o número está Vermelho ou com restrições ativas. O Quality Rating é calculado a partir de sinais negativos: bloqueios pelo usuário, denúncias como spam e baixo engajamento com mensagens iniciadas pelo negócio. O Meta não divulga a fórmula exata, mas o peso principal está nos **bloqueios e denúncias**. Um número pode cair de Verde para Vermelho rapidamente se uma campanha gerar volume alto de denúncias. ## Por que o número pode ser banido ou ter o envio restringido ### Status Vermelho não é banimento imediato Estar em Vermelho significa que o Meta identificou sinais negativos significativos no seu número. Nesse estado, o número entra em um **período de observação** antes de qualquer restrição definitiva. O que acontece durante esse período: * O Meta pode **limitar o número de conversas** que seu número consegue iniciar por dia (redução do tier de mensagens) * Campanhas em massa ficam **bloqueadas**. Você não consegue criar novas campanhas na Patagon AI enquanto o número estiver Vermelho * Se os sinais negativos continuarem durante o período de observação, o Meta pode **suspender** o número, impedindo qualquer envio de mensagem iniciado pelo negócio ### O que gera sinais negativos **Bloqueios e denúncias de spam** são a causa mais comum e de maior peso. Quando um usuário bloqueia seu número ou toca em "Denunciar spam" no WhatsApp, o Meta contabiliza isso contra o seu número. Um volume alto de denúncias em pouco tempo, como acontece após uma campanha mal segmentada, pode derrubar o rating em horas. **Volume de mensagens acima do tier permitido** também é um fator. Cada número tem um limite de conversas iniciadas por dia (o "tier"), que sobe conforme a qualidade melhora. Tentar enviar além desse limite gera erros de entrega e prejudica a reputação. **Mensagens enviadas para contatos que não salvaram seu número** geram mais denúncias porque o usuário não reconhece quem está entrando em contato. O WhatsApp exibe um aviso ao receptor nesses casos, o que aumenta a probabilidade de bloqueio. **Templates de Marketing usados fora de contexto**, como enviar promoções para leads que nunca demonstraram interesse, também contribuem para denúncias. O Meta monitora a taxa de leitura e engajamento dos seus templates. ## Como recuperar o Quality Rating A recuperação não acontece por uma ação isolada. O Meta recalcula o rating continuamente com base nos últimos 7 dias de sinal. O objetivo é **parar o que está causando os sinais negativos** e aguardar o período negativo sair da janela de cálculo. ### Passo 1: Pause as campanhas em massa imediatamente Se o número caiu para Vermelho durante ou após uma campanha, interrompa novos envios. Continuar mandando mensagens enquanto o rating está baixo acelera a queda e aumenta o risco de suspensão. ### Passo 2: Identifique a causa no Meta Business Manager Acesse **Meta Business Manager → Ferramentas da Conta → Números de Telefone** e clique no número afetado. O painel mostra: * O histórico do Quality Rating (o gráfico de queda indica quando o problema começou) * Os templates com maior taxa de denúncia (em **Modelos de Mensagem**, a coluna "Qualidade" mostra o status de cada template) * Alertas ativos de restrição de tier Se um template específico aparece com qualidade baixa ou status "Pausado", ele está contribuindo ativamente para o problema. Edite ou desative esse template. ### Passo 3: Reduza o volume de mensagens iniciadas pelo negócio Durante a recuperação, concentre-se em responder conversas inbound (leads que entram por conta própria) em vez de iniciar novas. Conversas inbound não geram sinais negativos e ainda contam positivamente para o período de análise. ### Passo 4: Aguarde a janela de 7 dias O Quality Rating é calculado com base nos últimos 7 dias corridos. Se você parou os envios problemáticos, o rating começa a melhorar conforme esses dias saem da janela de cálculo. Em geral, números que param os envios problemáticos voltam ao Amarelo em 3 a 5 dias e ao Verde em 7 a 10 dias, dependendo do volume de sinais negativos acumulados. ### Passo 5: Retome campanhas com uma lista menor e mais qualificada Quando o número voltar ao Amarelo, você pode retomar campanhas, mas comece com um volume menor e uma lista mais segmentada para validar que o problema foi resolvido antes de escalar novamente. Acompanhe o Quality Rating em tempo real no Meta Business Manager durante os primeiros envios. {% hint style="warning" %} Se o número foi **suspenso** (status diferente de ativo no Meta Business Manager), é necessário entrar em contato com o suporte do Meta diretamente pelo Business Manager para solicitar revisão. A Patagon AI não consegue resolver suspensões. Esse processo é inteiramente gerenciado pelo Meta. {% endhint %} ## Boas práticas para não cair para RED ### Envie apenas para quem optou em receber Essa é a regra mais importante. Só envie mensagens proativas (templates de Marketing ou Utilidade) para contatos que explicitamente demonstraram interesse: leads que iniciaram uma conversa, preencheram um formulário ou clicaram em um anúncio recentemente. Listas compradas ou muito antigas geram alta taxa de bloqueio porque o receptor não lembra de ter tido contato com sua marca. ### Use o Atraso em Lote nas campanhas Na Patagon AI, ao criar uma campanha em **Leads → Campanhas**, configure um **Atraso em Lote** de pelo menos 5 segundos entre cada mensagem. Envios muito rápidos (próximos do limite de rate do WhatsApp) geram erros 429 e podem acionar alertas no Meta. Para campanhas grandes, considere aumentar para 10 a 15 segundos. ### Mantenha os templates relevantes para o contexto Use a **categoria correta** ao criar templates no Meta Business Manager: * **Marketing** - ofertas, promoções, novidades. Só envie para leads que já demonstraram interesse no produto. * **Utilidade** - confirmações, atualizações de pedido, lembretes de reunião. Envie para quem está no meio de um processo com você. * **Autenticação** - códigos de verificação. Não misture com conteúdo comercial. Enviar conteúdo de Marketing disfarçado como Utilidade não só gera rejeição do Meta na aprovação. Se aprovado, aumenta a taxa de denúncia porque o usuário se surpreende com a mensagem. ### Inclua sempre uma opção de opt-out clara Todo template de Marketing deve oferecer ao destinatário uma forma simples de parar de receber mensagens. O botão de opt-out padrão do WhatsApp (disponível nos templates com botões de ação rápida) é a forma mais eficaz. Quando o usuário usa o opt-out, ele não denuncia como spam, o que protege seu Quality Rating. Dentro da Patagon AI, o agente não inicia novas conversas com leads que bloquearam o número. Mas é responsabilidade do seu time honrar os pedidos de opt-out e não reincluir esses contatos em listas de campanha futuras. ### Monitore o Quality Rating semanalmente Verifique o status do número no **Meta Business Manager → Ferramentas da Conta → Números de Telefone** toda semana, especialmente na semana seguinte a qualquer campanha. Também acompanhe as métricas de entrega das campanhas na Patagon AI em **Leads → Campanhas**. Uma taxa alta de "Falhou" pode indicar problemas de qualidade antes mesmo de o rating cair. ### Calibre o volume conforme o tier do número Números novos começam com capacidade de envio limitada (geralmente 1.000 conversas iniciadas por dia). Esse limite sobe automaticamente conforme o Quality Rating permanece Verde. Forçar volume além do tier permitido não só gera erros, sinaliza comportamento anormal para o Meta. Respeite o crescimento gradual, especialmente nos primeiros 30 dias do número. ## Checklist de recuperação rápida Quando o número cair para RED, siga esta sequência: * [ ] Pausar todas as campanhas em massa na Patagon AI * [ ] Acessar Meta Business Manager → Ferramentas da Conta → Números de Telefone → verificar alertas ativos * [ ] Identificar templates com qualidade baixa em Modelos de Mensagem e desativar ou editar * [ ] Focar só em conversas inbound pelos próximos 3–7 dias * [ ] Acompanhar o Quality Rating diariamente até voltar ao Amarelo * [ ] Retomar campanhas com lista reduzida e atraso em lote maior * [ ] Se o número estiver suspenso: abrir chamado no suporte do Meta pelo Business Manager ## Artigos relacionados * [Elegibilidade para Campanhas](/desempenho-de-vendas/elegibilidade-para-campanhas.md) - o que o aviso "Não elegível para mensagem" significa e como resolver * [Como criar uma campanha](/desempenho-de-vendas/campaigns.md) - configuração de Atraso em Lote e leitura de métricas de entrega * [Como criar modelos de mensagem](/otimizacao-do-agente/message-templates.md) - categorias de template e processo de aprovação * [Como monitorar a saúde do seu número do WhatsApp](/marketing-e-atribuicao/whatsapp-number-health.md) - onde ver o Quality Rating e os limites de envio {% hint style="info" %} Se o seu número foi suspenso e você não está conseguindo resolver pelo Meta Business Manager, entre em contato com com o número afetado e uma descrição do que aconteceu antes da suspensão. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.patagon.ai/solucao-de-problemas/quality-rating-red.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.