Glossário — HookCloud Flow

Termos principais

Termo	Definição
App principal	Aplicativo Meta atual usado para novas conexões.
App legado	Aplicativo antigo mantido para conexões históricas até reconexão.
Business ID	ID do Business Portfolio/BM.
Callback	URL que recebe a verificação e os eventos.
Canônica/current	Conexão técnica atual de um número.
Cloud API	API hospedada pela Meta para WhatsApp Business.
CláudIA	Agente de IA do suporte privado do HookCloud Flow. Não participa dos canais públicos de Networking e não executa alterações destrutivas.
Memória privada	Contexto de suporte isolado por ambiente, usuário autenticado e workspace para manter continuidade entre conversas autorizadas.
Revisão da IA	Fila administrativa de lacunas e sugestões. Aprovar registra a decisão; a mudança só existe depois de implementação e publicação separadas.
Coexistência	Modo que permite usar o app WhatsApp Business e a plataforma, quando elegível.
Connection ID	ID interno da conexão no Flow.
Embedded Signup	Fluxo oficial de autorização e onboarding da Meta.
E.164	Formato internacional normalizado do número.
Endpoint	Registro da URL de webhook e seus estados.
GET challenge	Verificação de propriedade do webhook.
Handoff/transferência	Mudança protegida de ativo entre workspaces.
Limited management	Messaging presente, management ausente ou limitado.
Phone Number ID	ID técnico usado para mensagens e rota específica.
POST	Entrega de eventos ao webhook.
Readback	Leitura da Meta após uma escrita para confirmar o estado efetivo.
Rota efetiva	Callback realmente utilizado para o Phone Number ID.
Substituída	Versão técnica antiga do mesmo número no mesmo workspace.
Transferida	Conexão anterior após mudança para outro workspace.
WABA	WhatsApp Business Account.
Workspace	Espaço isolado de assinatura, equipe, números e permissões.
Chatwoot	Plataforma de atendimento que pode usar o número oficial conectado pela HookCloud.
external_managed	Modo em que a entrega do webhook é gerenciada por uma plataforma externa.
delivery_status	Estado da entrega de eventos, separado do status da conexão Meta.
route_owner	Indica se a rota pertence à HookCloud/cliente ou à plataforma externa.
Business username	Username comercial associado ao número da empresa.
business_username_updates	Webhook administrativo da Meta para alteração do username comercial.
BSUID	Business-Scoped User ID: identificador técnico do usuário no contexto de um portfólio empresarial.
Username de usuário	Nome de exibição escolhido pela pessoa; pode mudar e não deve ser chave primária.
user_id_update	Evento usado para reconciliar mudança de BSUID, quando disponibilizado e assinado.
Presença operacional	Sinal de atividade do painel usado pelo suporte autorizado para indicar online, inativo e ação ampla em processamento.
Callback alternativo / override	Rota configurada na WABA ou no Phone Number ID para a Meta entregar campos suportados diretamente ao endpoint escolhido.
custom_verified	Estado do Flow que indica que a rota própria foi aplicada e confirmada por leitura remota.
Idempotência	Proteção para processar o mesmo evento mais de uma vez sem duplicar mensagem, lead ou automação.
message.id / wamid	Identificador original da mensagem, recomendado como chave de idempotência.
referral	Objeto que pode identificar anúncio ou ponto de entrada Click-to-WhatsApp associado à mensagem.
X-Hub-Signature-256	Header de assinatura da Meta. A validação requer o corpo bruto e o App Secret responsável pela integração.
Webhook direto	Arquitetura em que a Meta envia o POST operacional ao endpoint do assinante sem retransmissão pela HookCloud.
Desconectar	Encerrar o vínculo operacional preservando histórico e linhagem. Não equivale a excluir definitivamente.
Parar desconexão	Cancelar uma desconexão antes de a operação entrar em fase irreversível.
Exclusão definitiva	Operação administrativa excepcional, indisponível ao assinante.
Geração da conexão	Versão monotônica usada para impedir que um job antigo altere uma reconexão nova.
Verificação passiva	Leitura de rota que não escreve na Meta nem bloqueia a configuração explícita.
Teste de alcance da CláudIA	Teste HTTPS somente leitura para verificar se uma URL responde. Não valida segredo, assinatura, `hub.challenge` nem altera a rota.
recipient	Campo outbound usado para enviar mensagem a um BSUID.
to	Campo outbound usado para enviar mensagem a um telefone em E.164.
recipient_user_id	BSUID do destinatário informado em status de mensagem, quando disponível.

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.