Qualidade, restrições e banimentos

Qualidade do número

Eventos monitorados

O Flow trata como sinais principais os webhooks administrativos da Meta, incluindo phone_number_quality_update, phone_number_name_update e account_update, além dos campos de qualidade, status e restrição relacionados ao Phone Number ID/WABA.

O webhook é a fonte primária de atualização. Uma reconciliação controlada consulta novamente o estado quando o evento pode ter sido perdido ou quando há divergência. O painel exibe o último estado confirmado; não promete atualização instantânea nem substitui a decisão da Meta.

Restrito não é banido

Restrito: algum recurso ou limite foi reduzido. Banido: a conta/número foi bloqueado. A Meta toma a decisão e define recurso/revisão.

Empresa não verificada ou erro de pagamento significa restrição?

Não, essas informações sozinhas não classificam o número como restrito. A verificação da empresa, o pagamento, a conexão do telefone e uma restrição imposta pela Meta são verificações diferentes. O Flow usa o rótulo de restrição quando existe uma decisão explícita da Meta para a conta ou número correto.

Uma consulta de saúde pode retornar um alerta de envio relacionado à configuração, mesmo com o telefone conectado e qualidade verde. O Flow apresenta esse aviso separadamente de restrições e banimentos. O alerta não aumenta os contadores de BAN ou RED e não comprova que todas as mensagens estejam impedidas.

Pagamento: um erro relacionado ao método de pagamento não comprova ausência de cartão, dívida ou falta de vínculo. Pode existir uma forma de pagamento cadastrada; confira o detalhe na mesma conta do WhatsApp Business e compare a data da consulta. A cobrança da Meta é independente da assinatura HookCloud.

Verificação da empresa: uma BM não verificada, isoladamente, não é banimento nem restrição. Se a Meta mostrar expressamente “Conta restrita” e solicitar a verificação, siga a instrução exibida para aquela conta. Um erro de pagamento não apaga uma restrição explícita já confirmada.

Se houver divergência entre o Flow e o Gerenciador, solicite uma nova conferência e informe o número, o horário e uma captura sem dados sensíveis. Não exclua o número, não troque o cartão nem recrie a conexão apenas para retirar um aviso indevido.

Referências: Health Status da Meta e eventos de atualização da conta.

A Meta liberou o número, mas o Flow ainda mostra banido

O card da HookCloud exibe o último estado recebido ou consultado para aquela conexão. A liberação do número na Meta e a atualização da conexão no Flow são etapas distintas. Compare o mesmo número, Phone Number ID e WABA, além da data da última sincronização: um registro antigo de banimento não confirma que a Meta ainda mantém o bloqueio.

Como atualizar a conexão após a liberação

1. Confirme a liberação no WhatsApp Manager. Confira o número correto, a WABA e eventuais restrições da conta. “Registrado” no seletor ou qualidade GREEN, isoladamente, não comprovam a reversão do banimento.
2. Atualize o painel e confira a data e o log. Recarregar a página mostra os dados já registrados na HookCloud; não renova token e não garante uma consulta nova à Meta. Não repita ações enquanto houver uma operação em andamento.
3. Se a Meta já restabeleceu esse ativo e o Flow continua com a informação antiga, você pode refazer a autorização pelo fluxo oficial do Flow. Isso não significa que o token foi necessariamente revogado nem que toda liberação exija reconexão. Se uma verificação atual já confirmou acesso e saúde disponíveis para o mesmo ativo, não repita a conexão: a divergência local deve ser investigada. Em Visão geral, selecione o modo de entrega utilizado, webhook próprio ou Chatwoot/plataforma externa, mantenha a configuração correta e clique em Conectar com a Meta. Entre com um administrador autorizado e selecione o mesmo portfólio empresarial, WABA e número. Conclua as permissões e etapas solicitadas pela Meta. Não crie outro ativo apenas para atualizar o card.
4. Aguarde o resultado da operação. Confira o card atual, IDs, autorização, webhook e o horário da sincronização. Se usar Chatwoot ou outro sistema, confira se ele utiliza as credenciais e os IDs da conexão atual; atualize-os nessa ferramenta se tiverem mudado. Não compartilhe o token no chat.
5. Se não concluir, siga o erro concreto. Falha comprovada do callback deve ser corrigida no destino do webhook; falta de autorização exige permissões corretas. Se a Meta impedir a seleção, mostrar “Não qualificado” ou mantiver uma restrição, veja o detalhe no próprio gerenciador. Se a operação concluir e o mesmo ativo continuar divergente, envie ao suporte os IDs, horário, código da operação e um print sem segredos.

Não exclua o número, a WABA ou a conta na Meta, nem desconecte previamente um número saudável, apenas para limpar o status do Flow. A reconexão passa pelas validações normais de autorização, vínculo, rota, assinatura e risco. Não garante sucesso, não remove um banimento ainda ativo na Meta e, por si só, não zera o histórico ou a janela móvel de risco da HookCloud. Uma restauração confirmada pelo sistema segue a regra específica de resolução do BAN; RED permanece sujeito à sua própria janela.

Quando a reautorização é necessária

Se um retorno atual informar token expirado ou inválido, como o erro OAuth 190, ou permissões/ativos ausentes, a integração precisa de uma autorização válida pelo fluxo oficial. Um refresh não restaura uma credencial revogada. Já um erro de objeto inacessível ou Unsupported get request, sozinho, pode envolver ID, acesso ou operação incompatível: não diagnostique automaticamente token revogado, exclusão ou novo banimento.

A HookCloud recebe eventos administrativos e realiza verificações controladas. A atualização automática depende de receber ou conseguir consultar um retorno válido da Meta; não há prazo garantido para um caso específico. A CláudIA deve explicar o último registro e orientar os passos disponíveis, sem colocar automaticamente toda divergência em revisão administrativa e sem dizer que consultou a Meta agora quando só leu o histórico.

Referências oficiais da Meta

• Webhook account_update: distingue restabelecimento da WABA e alterações de compartilhamento/autorização. Um evento da WABA não deve ser confundido com prova da saúde atual de cada número.
• Códigos de erro: distingue autenticação/token, permissões e restrições de política.
• Saúde de mensagens e chamadas: a disponibilidade envolve número, WABA, empresa e app, não apenas um rótulo visual.
• Tokens de usuário de sistema de integração empresarial: descreve autorização e invalidação; não estabelece que todo banimento revoga o token.

Fontes consultadas em 16 de setembro de 2026. O passo a passo acima é o procedimento do produto HookCloud; não é uma regra da Meta que exija reconexão depois de toda liberação.

Veja também diagnóstico de estados divergentes, credenciais e permissões e conexão oficial pelo Flow.

Banimento resolvido após confirmação da Meta

Verificar restauração na Meta: quando disponível no card banido, owner/admin pode solicitar essa consulta pelo botão de mesmo nome. A verificação é somente leitura na Meta e pode estar disponível mesmo com bloqueio interno de risco, mantendo as validações de assinatura, vínculo e credencial. Aguarde o resultado e confira a última sincronização; clicar no botão ou concluir o job não comprova, por si só, restauração e não garante desconto. Falta de permissão ou erro de autenticação exige o diagnóstico correspondente.

Quando a HookCloud recebe e valida uma confirmação de restauração da Meta para o mesmo ativo, o BAN anterior abrangido por essa confirmação deixa de compor o contador de banimentos. O incidente permanece no histórico, marcado como restaurado, com a evidência e a data da confirmação para auditoria. A retirada do contador não apaga o registro do ocorrido.

A confirmação deve vir de um evento autêntico da Meta ou de uma verificação autorizada realizada pelo sistema, com correspondência de workspace, WABA ou Phone Number ID, escopo e sequência temporal. A liberação de um telefone não comprova a liberação de toda a WABA. Um print, o relato do assinante, o status local isolado, a reconexão, a troca de plano ou a remoção de convidados não substituem essa confirmação.

RED continua com a mesma regra. A resolução do BAN não remove incidentes de qualidade RED. Se o número voltar a operar com qualidade RED, as duas situações serão tratadas separadamente. Um novo banimento posterior à restauração gera uma nova ocorrência e pode voltar a compor o contador, respeitando a janela móvel de 30 dias e a deduplicação.

Se a Meta já liberou o ativo, mas a restauração ainda não foi confirmada pelo sistema, confira o horário da última sincronização e siga o diagnóstico de atualização do status. Recarregar a página mostra os dados disponíveis; não comprova uma nova consulta à Meta nem garante desconto imediato.

Política de risco da HookCloud por plano

Os limites abaixo são internos da HookCloud. Não concedem uma franquia de infrações da Meta nem garantem que ela tolere a quantidade indicada. Qualidade RED, banimento externo e bloqueio interno são estados diferentes.

A HookCloud calcula os incidentes na janela móvel de 30 dias, com deduplicação e reconciliação dos sinais da Meta. Para BAN, entram somente ocorrências ainda não resolvidas; uma restauração confirmada para o mesmo ativo retira os incidentes anteriores abrangidos do contador e preserva sua auditoria. A regra de RED não muda. Os limiares dependem do plano confirmado para o workspace.

Starter 1 e Starter 2 chegam ao aviso final com 20 BAN ou 5 RED e ao bloqueio por quantidade com 21 BAN ou 6 RED. Pro 1 chega ao aviso final com 40 BAN ou 10 RED e ao bloqueio com 41 BAN ou 11 RED. Pro 2 chega ao aviso final com 50 BAN ou 20 RED e ao bloqueio com 51 BAN ou 21 RED. Todos usam a janela móvel de 30 dias.

O plano antigo identificado como legado mantém os limiares de 21 BAN e 6 RED para bloqueio. No Pro anterior, os limiares de Pro 2 só se aplicam quando esse benefício estiver confirmado na assinatura; sem essa confirmação, consulte as condições vigentes da conta. Não identifique os limites somente pelo preço pago.

Ao atingir um aviso, o painel orienta a revisão da operação. Ao atingir o limiar de bloqueio, novas conexões ou outras operações de risco podem ser impedidas. Fraude, spam, credencial comprometida ou violação grave podem exigir outras medidas proporcionais, independentemente desses números.

Desconectar, substituir ou reconectar um número não zera os incidentes por si só. A confirmação de restauração pela Meta resolve o BAN correspondente sem apagar sua auditoria. Mudar voluntariamente de variante aplica os limiares confirmados ao histórico existente; não remove banimentos da Meta nem libera automaticamente restrições administrativas por outro motivo.

A liberação de uma vaga comercial não elimina o risco associado ao uso. Veja substituição de números e mudança voluntária de variante. Para contestar associação incorreta, duplicidade ou dado desatualizado, utilize o suporte privado ou suporte@hookcloud.app.

Prevenção

• obtenha opt-in claro e mantenha prova;
• respeite frequência, contexto e opt-out;
• não compre listas;
• use templates coerentes;
• trate reclamações e bloqueios;
• evite automações enganosas;
• mantenha forma de pagamento e empresa em conformidade.

Decisões da Meta

A Meta decide restrições e revisões no próprio serviço. A HookCloud não garante aprovação, reversão de banimento, qualidade GREEN ou continuidade de uma permissão externa. Essa delimitação não exclui a correção de defeitos próprios nem o suporte contratado.

A HookCloud presta suporte primário à integração, investiga também seus próprios componentes e encaminha questões não resolvíveis internamente aos canais aplicáveis da Meta, quando cabível. O assinante participa das verificações sob seu controle. Esse encaminhamento não garante deferimento nem prazo de solução externa.

Banimento ou restrição de número, WABA, portfólio empresarial e perfil são situações distintas. Confirme qual ativo foi afetado antes de concluir que toda a conta ou todos os números estão bloqueados. RED é uma classificação de qualidade baixa, não sinônimo de banimento.

Consulte a matriz de responsabilidades e os Termos de Serviço.