Números e status — HookCloud Flow

Categorias da aba Números

Categoria	Inclui
Ativos	Conexões canônicas e operacionais.
Em processamento	Onboarding, validação, transferência, revisão assistida ou operação pendente.
Restritos	Números com limitação conhecida.
Banidos	Ativos bloqueados pela Meta.
Desconectados	Conexões encerradas local/remotamente.
Substituídos	Versões técnicas antigas do mesmo telefone no workspace.
Transferidos	Número movido para outro workspace.
Encerrados	Registros terminados por cobrança, risco ou ação administrativa.

Card compacto e expansão

O card recolhido mostra o número, nome verificado, última sincronização e status. Clique no resumo ou no sinal de expansão para ver IDs, permissões, webhook, token, histórico e ações. O painel preserva card e log abertos durante atualizações automáticas.

Campos do card expandido

Campo	Significado
Connection ID	Identificador interno da conexão no Flow.
Phone Number ID	Identificador técnico usado no endpoint `/messages`.
WABA ID	Conta do WhatsApp Business que contém o número.
Portfólio empresarial	Nome do Business Portfolio proprietário da WABA, quando a Meta permite a sincronização.
Business ID	Business Portfolio/BM relacionado.
Nome verificado	Nome retornado pela Meta para o número.
Qualidade	GREEN, YELLOW, RED ou desconhecida.
App Meta	App principal ou legado usado pela credencial.
Concedidas/ausentes	Escopos disponíveis e limitações do token.
Callback e rota	URL esperada, readback e escopo efetivo.
Última sincronização	Momento da consulta mais recente.
Modo de entrega	Webhook próprio ou plataforma externa.
Estado da entrega	Aguardando, externa confirmada, conflito ou webhook verificado.
Número para Chatwoot	Número normalizado em E.164, copiável como `+15553811311`, sem espaços ou traços.
Username comercial	Nome público do número, quando enviado pela Meta.
Status do username	Reservado, Ativo, Removido ou em análise.
Prontidão BSUID	Orientação para validar o sistema de atendimento em cenários sem telefone.

Estado local, autorização e última confirmação

O card reúne dados locais e o último estado confirmado pela Meta. Por isso, CONNECTED descreve a conexão conhecida pelo Flow, mas não garante sozinho que o token ainda está ativo, que todas as permissões continuam válidas ou que o callback responde.

confira a data da última sincronização;
leia o estado de autorização da credencial e os escopos ausentes;
consulte qualidade, restrição e risco do Phone Number ID correto;
se houver aviso de credencial revogada ou reautorização necessária, faça uma nova conexão oficial;
use o teste de rota somente para diagnóstico: alcance HTTP não equivale à validação completa do webhook.

Username comercial e identidade

Quando a Meta envia uma atualização, o card mostra o username comercial, o estado e a data da última alteração.

Reservado

Nome reservado, ainda sujeito à liberação e visibilidade da Meta.

✓

Ativo

Username aprovado e associado ao número comercial.

Removido

Nome removido; o histórico técnico pode manter o último valor.

Entenda a diferença entre username e BSUID →

Botões do card

Botão	Efeito	Disponibilidade
Mostrar/Copiar token	Revela temporariamente o token Meta.	Owner/admin autorizado; nunca em conexão histórica ou credencial inválida.
WhatsApp Manager	Abre o gerenciamento oficial do ativo.	O usuário também precisa de acesso na Meta.
Alterar webhook	Troca a rota efetiva da conexão e confirma por readback.	Somente conexão atual e sem operação incompatível.
Validar rota	Consulta callback/App sem escrever.	Diagnóstico.
Reaplicar webhook	Regrava e confirma a rota própria.	Quando a validação apontar divergência.
Atualizar status	Busca dados do número, WABA, qualidade e portfólio na Meta.	Pode ficar limitado sem management.
Configurar caixa existente	Aplica a URL e o verify token de uma inbox existente do Chatwoot no Phone Number ID e confirma a rota.	Modo Chatwoot/plataforma externa; permanece disponível durante verificação passiva.
Verificar Chatwoot	Faz uma leitura passiva da rota sem alterar callback.	Não bloqueia Configurar caixa existente, Usar webhook próprio ou Desconectar.
Usar webhook próprio	Migra a entrega para uma URL HTTPS própria.	Quando o destino passar a ser CRM, n8n, Make ou backend próprio.
Desconectar	Encerra o vínculo operacional com segurança e preserva o histórico técnico.	Owner/admin; não equivale a excluir o registro.
Parar desconexão	Cancela a solicitação enquanto nenhuma etapa irreversível tiver começado.	Somente enquanto o painel indicar que a parada ainda é segura.
Reconectar	Inicia novo Embedded Signup e cria uma nova geração técnica da conexão.	Conexão desconectada ou autorização inválida, quando permitido.
Excluir definitivamente	Remove registros técnicos em uma operação administrativa excepcional.	Não disponível ao assinante. Somente administração HookCloud, após verificações de segurança.
Usar esta conexão como atual	Resolve duplicidade no mesmo workspace após validar a rota.	Somente owner e fluxo assistido.
Log da conexão	Mostra eventos, jobs, tentativas, resultados e código de suporte.	Todos os papéis com acesso de leitura.
Copiar número para Chatwoot	Copia o telefone em formato internacional, sem espaços, traços ou parênteses.	Quando o número estiver disponível.

Desconectar não é excluir

O assinante não pode excluir um número definitivamente

No painel do assinante, a ação disponível é Desconectar. A exclusão definitiva não é um recurso de autoatendimento e só pode ser executada pela administração HookCloud em situações excepcionais, depois de conferir ownership, jobs, histórico, WABA compartilhada, credenciais e rotas.

Ação	O que acontece	Histórico
Desconectar	Encerra o vínculo operacional, tenta retirar a rota quando a credencial permite e conclui a limpeza local segura.	Preservado para auditoria, suporte e reconexão.
Parar desconexão	Cancela o job antes da fase remota/local irreversível.	Permanece como operação cancelada no log.
Reconectar	Uma nova autorização assume a conexão e invalida desconexões antigas que pertençam à geração anterior.	A linhagem anterior continua consultável.
Exclusão definitiva	Operação administrativa de exceção; não é oferecida ao assinante.	Pode remover registros técnicos conforme a prévia administrativa.

Não apague o número na Meta para “limpar o card”

Excluir o número no WhatsApp Manager pode mudar Phone Number ID, WABA, histórico e elegibilidade. Use Desconectar ou procure o suporte quando o estado não terminar corretamente.

Processamento, verificação passiva e cronômetro

Conectar, aplicar uma rota, trocar webhook e desconectar podem depender de respostas da Meta. O cronômetro é uma estimativa visual e não encerra sozinho uma operação remota.

Operação	Bloqueia ações concorrentes?	Comportamento
Verificar Chatwoot	Não	É uma leitura passiva. A verificação manual faz uma leitura; a automática tenta no máximo três vezes e termina como “Aguardando plataforma externa” quando a rota não foi detectada.
Configurar caixa existente	Sim, durante aplicação/readback	Escreve a rota da inbox no Phone Number ID e confirma o callback efetivo.
Webhook próprio	Sim, durante aplicação/readback	Preserva as proteções do fluxo e confirma a rota antes do sucesso.
Desconectar	Sim, durante as etapas seguras	O botão Parar desconexão aparece enquanto ainda for possível cancelar sem inconsistência.

Contador em 00:00

Atualize o painel somente quando a mensagem orientar. Uma verificação passiva não deve manter os demais botões bloqueados; uma aplicação explícita deve chegar a um resultado terminal antes de ser repetida.

Log da conexão

O log diferencia Registro/Auditoria, Processando, Concluído e Falhou. Abra detalhes técnicos somente quando necessário. Copie o código de suporte, não o token.

Pesquisa e paginação

Pesquise por telefone, nome verificado, WABA ou Phone Number ID. Escolha a quantidade de cards por página. A pesquisa não muda o workspace nem a conexão canônica.

Ainda precisa de ajuda?

Envie o e-mail do owner, Workspace ID, Connection ID, horário aproximado e o código de suporte exibido no painel para suporte@hookcloud.app. Nunca envie o token completo.