ChatPRO Central de Ajuda

Score do App Tech Provider

Disponível para o perfil: Superadministrador

A seção Score do App Tech Provider avalia a saúde e a reputação dos seus números de WhatsApp Oficial (WABA) que estão conectados utilizando o App compartilhado da ChatPRO (login incorporado padrão). É um mecanismo de proteção: ele monitora a qualidade que a própria Meta atribui aos seus números e impede que números de baixa reputação coloquem em risco o aplicativo compartilhado — e, com ele, todos os demais clientes.

O score é compartilhado por chave de licença. Todas as suas instalações auto-hospedadas que utilizam a mesma licença visualizam o mesmo score e compartilham a mesma reputação. Isso inclui os números que os seus clientes/tenants conectam pelo App compartilhado sob a sua licença — eles também contam para o seu score.

Você acompanha o score em Superadmin → Tenants e Licença → Gerenciar Licença → Score do App Tech Provider, com o detalhamento número a número.

Como a Meta classifica cada número

A Meta classifica a qualidade dos números de WhatsApp com base no comportamento e nas denúncias e bloqueios feitos pelos destinatários (marcação de spam, "bloquear contato"). O ChatPRO lê e exibe essa classificação:

  • 🟢 Verde (High): alta qualidade. Baixo índice de bloqueios e denúncias.
  • 🟡 Amarelo (Medium): qualidade média. O número recebeu alguns bloqueios/denúncias e está sob aviso.
  • 🔴 Vermelho (Low): baixa qualidade. O número excedeu o limite tolerável de denúncias/spam pela Meta.

Além dessas, a Meta pode aplicar dois status mais graves: Restringido (envio limitado) e Conta Rejeitada.

Como o score é calculado

Toda licença começa com 100 pontos. O score é recalculado automaticamente a cada checagem — que acontece pelo menos uma vez por dia —, com base na classificação de cada número conectado:

Classificação Meta do número Efeito no score
🟡 Amarelo −25 pontos (cada)
🔴 Vermelho −35 pontos (cada)
🚫 Restringido pela Meta cai direto para 10
⛔ Conta Rejeitada pela Meta vai a 0

Faixas do score

Score Situação Efeito
90–100 ✅ Saudável Tudo normal
70–89 👀 Observação Alerta por e-mail
40–69 ⚠️ Alerta Envio limitado a 10% do tier do número (throttle)
0–39 🔴 Crítico Contagem regressiva para bloqueio automático

O que é o throttle de 10%?

Quando o score cai abaixo de 70, o app passa a limitar cada número a 10% do limite diário (tier) que a Meta concede a ele.

Exemplo: se a Meta permite que o número envie 1.000 mensagens por dia (tier máximo), com o throttle ativo ele fica limitado a 100 mensagens por dia — enquanto o score permanecer nessa faixa.

É uma contenção temporária: reduz o volume para frear a queda de reputação na Meta e dar tempo de recuperação, sem bloquear a operação por completo.

Exemplo de score Amarelo/vermelho:

Bloqueio automático

Quando a licença entra em estado crítico, o bloqueio é aplicado automaticamente:

  • 3 ou mais números vermelhos (ou amarelos acumulados) → bloqueio em 3 dias.
  • Número Restringido ou conta Rejeitada pela Meta → bloqueio em 1 dia.

Ninguém é bloqueado sem aviso. Antes do bloqueio, você recebe alertas por e-mail (diários quando o score está crítico) com o score atual, o resumo dos números afetados e o prazo restante até o bloqueio.

Em nível de número: quando um número conectado pelo App compartilhado fica Vermelho, ele é desconectado do nosso aplicativo (OAuth da ChatPRO) após um período, para preservar a reputação do App global. Uma vez desassociado, aquele número não consegue mais se reconectar usando o App compartilhado. E, se a sua operação acumular vários números vermelhos (score geral muito baixo), a licença perde a permissão de conectar qualquer novo número pelo nosso App.

Erro que aparece quando o número é desassociado

0|ChatPRO-backend  | warn: ::: ChatPRO ::: ChatPRO ::: WABA send blocked by gate: CHANNEL_DISASSOCIATED whatsappId=111
0|ChatPRO-backend  | warn: ::: ChatPRO ::: ChatPRO ::: Error sending message waba 7:{"message":"CHANNEL_DISASSOCIATED","statusCode":423}

Como tirar um número do score e recuperar a pontuação

Um número só deixa de pesar no score quando é desvinculado do App compartilhado da ChatPRO (Tech Provider). Enquanto ele permanecer vinculado ao nosso App, continua sendo avaliado — mesmo que você já esteja enviando mensagens por outro caminho.

Para recuperar a pontuação: Assim que um número ficar Amarelo ou Vermelho, remova-o do App compartilhado. Na próxima checagem de score — que acontece pelo menos uma vez por dia — aquele número deixa de ser considerado e a pontuação é recalculada naturalmente, devolvendo os pontos que ele estava descontando.

Atenção: "Alterar origem" não desvincula o número.

O botão Alterar origem muda apenas por onde os webhooks da Meta são entregues (proxy da ChatPRO × App Próprio). Ele não altera o vínculo de autenticação do número e, por isso, não o remove do score.

Para desvincular um número do nosso App de forma eficaz, você precisa de uma destas ações:

  • Desconectar o canal no ChatPRO; ou
  • Recriar o canal, conectando-o a um novo App (o seu App Próprio).

Depois de bloqueado: a liberação é manual

Uma vez bloqueada, a licença não consegue mais conectar canais Meta pelo App compartilhado da ChatPRO. Não existe desbloqueio automático — não adianta reinstalar, trocar de número ou reconectar.

A reabilitação segue estas regras:

  • A liberação é feita somente de forma manual pela nossa equipe, avaliada caso a caso.
  • Há uma carência mínima de 30 dias a partir do bloqueio antes que a reabilitação seja possível.
  • A revisão é solicitada respondendo ao e-mail de bloqueio com um plano de mitigação: o que causou a queda de qualidade e o que mudou para que não se repita.

O que NÃO é afetado

  • Canais configurados via App Próprio (sua própria conta Meta Developer) continuam funcionando normalmente — o bloqueio atinge apenas as conexões pelo nosso App compartilhado.
  • Os demais canais da plataforma (Baileys, Telegram, Instagram, etc.) não entram nesse score.

Como manter o score alto

  1. Opt-in sempre — envie apenas para quem aceitou receber.
  2. Cuidado com volume e frequência — picos de disparo derrubam a qualidade na Meta.
  3. Monitore bloqueios e denúncias — um número marcado como spam vira amarelo/vermelho rápido.
  4. Aja rápido em números amarelos/vermelhos — desvincule-os do App compartilhado assim que caírem. Eles param de descontar pontos e a pontuação se recupera na próxima checagem (ver "Como tirar um número do score e recuperar a pontuação", acima).
  5. Acompanhe pelo painel — em /assinatura você vê o detalhe por número.
  6. Considere migrar para App Próprio se faz disparos em volume.

Solução definitiva: App Próprio

Se a sua operação trabalha com nichos que geram muitas denúncias, ou você tem clientes que rotineiramente deixam os números em vermelho, você não poderá continuar utilizando o App compartilhado da ChatPRO. Nesse cenário, a orientação é criar a sua própria infraestrutura na Meta:

  • Configurar App Próprio (Tornar-se Tech Provider): acesse o Facebook Developers, crie o seu próprio aplicativo, passe pelo processo de aprovação da Meta e configure as credenciais no painel Superadmin do ChatPRO.
  • Vantagem: com o seu próprio App, a saúde (score) fica isolada na sua própria Business Manager, permitindo que você gerencie os números vermelhos dos seus clientes sob a sua responsabilidade, sem afetar o ecossistema global do ChatPRO e sem risco de bloqueio coletivo.

Para iniciar, clique no link "Configurar App Próprio" no canto inferior direito do painel de Score.

Sempre que houver queda de qualidade, enviaremos um e-mail com o resumo dos números e a recomendação do que fazer.

Isso foi útil?
Central de Ajuda ChatPRO · documentação técnica da plataforma