HookCloud FlowCentral de ajuda
SuporteAbrir painel
HookCloud Flow · documentação oficial do produto

Transferências, substituições e histórico técnico

Entenda como o Flow evita duplicidades sem apagar auditoria e como escolher a conexão correta.

Versão 4.6.0Atualizada em 8 de setembro de 2026 · documentos separados, escolhas de cookies e responsabilidades na integração. Condições comerciais dos assinantes atuais preservadas.

Conexão atual x versão histórica

EstadoO que significa
current / canonicalVersão técnica atual do telefone naquele workspace.
supersededOutra versão do mesmo E.164 substituiu esta conexão.
transferredO ativo passou a outro workspace.
released/disconnectedVínculo encerrado sem ser a versão atual.
review_requiredO sistema preservou o conflito para decisão humana.

Desconexão, reconexão e gerações da conexão

“Desconectado” identifica o encerramento do vínculo na HookCloud. O histórico pode conservar o último estado da Meta e as últimas permissões validadas, com suas datas; isso não comprova acesso atual nem revogação remota. Na desconexão voluntária, autorizações compartilhadas são preservadas; a revogação depende de comprovação de que não há compartilhamento e de confirmação remota. Acompanhe o resultado separado no Log. Consulte desconexão e revogação de credenciais.

Cada autorização concluída cria uma nova geração técnica. Uma desconexão antiga só pode alterar a geração para a qual foi criada.

CenárioComportamento
Nova autorização após desconexão pendenteA reconexão assume uma nova geração e cancela ou torna obsoleto o job antigo antes que ele afete token, endpoint ou rota novos.
Token inválido durante desconexãoQuando a Meta não permite a limpeza remota, o Flow registra o aviso e conclui a limpeza local segura, evitando estado eterno de “Desconectando”.
Parar desconexãoDisponível enquanto a operação ainda não entrou em fase remota/local irreversível.
Mesmo telefone com novo Phone Number IDA linhagem do E.164 é reconciliada e desconexões antigas são separadas da identidade nova.
O histórico continua visível
Cancelar ou concluir uma desconexão não apaga automaticamente versões antigas. Isso permite explicar mudanças de WABA, Phone Number ID, App, callback e credencial.

Parceria retirada ou operação cancelada

Desconecte pela HookCloud antes de retirar a parceria ou as permissões no portfólio da Meta. Se o acesso já tiver sido removido, o encerramento local seguro não deve ser confundido com uma limpeza remota confirmada. Uma operação com falha ou cancelada precisa exibir esse resultado, sem permanecer como processamento ativo indefinidamente.

A proteção administrativa pode impedir uma operação mesmo com uma assinatura ativa. Só a equipe autorizada pode revisar essa pausa; pagamento e nova autorização não a removem automaticamente. Uma operação antiga nunca deve atuar sobre as credenciais ou a rota de uma nova conexão. Veja a orientação para desconectar e retirar a parceria.

Transferência entre workspaces

Ao reconhecer o mesmo Phone Number ID/WABA em outro workspace, o Flow pede confirmação. A origem permanece canônica até que a nova rota e o número sejam verificados. Depois, a origem vira Transferida e recebe notificação; o destino vira canônico.

Transferência protegida
O painel pode exibir até cinco minutos de estimativa visual enquanto ownership, conexão canônica e rota são confirmados. Não feche a tela nem repita a operação durante esse período.

Mesmo número com WABAs/IDs diferentes

Um telefone pode ter versões de coexistência, Cloud API, App legado, App principal, nova WABA ou novo Phone Number ID. O Flow agrupa pelo E.164 e mantém uma versão atual. As demais ficam em Substituídos, sem token ou ações remotas.

Escolher a conexão atual

  1. Abra Em processamento.
  2. Compare Phone Number ID, WABA, webhook, App e data.
  3. Clique Validar webhook desta versão.
  4. Aguarde Rota confirmada.
  5. Como owner, clique Usar esta conexão como atual.
  6. Confirme o motivo e a frase de segurança.
Não escolha no escuro
Se nenhuma versão tiver rota verificada, valide primeiro. Em conflito entre workspaces, somente a equipe HookCloud pode decidir.

Mudança de WABA, Phone Number ID ou BM

Quando a Meta gera nova identidade técnica, o Flow pode criar uma linhagem do mesmo número. A ligação só é feita depois de token válido, associação do número à nova WABA e callback confirmado. Números apenas parecidos não são unidos automaticamente.

WABA com vários números

Callback e subscription podem afetar todos os números de uma WABA. Por isso transferências parciais ou limpezas remotas podem ser bloqueadas. O sistema prefere revisão a alterar o ativo errado.

Por que o histórico não é apagado

O histórico ajuda a auditar WABA/Phone IDs antigos, Apps, callbacks, datas, transferências, desconexões e suporte. Ele não deve consumir vaga nem permitir revelar token ou executar ações remotas.

Assinantes desconectam; não excluem definitivamente
A exclusão definitiva é uma operação administrativa excepcional. No painel do assinante, o caminho correto é Desconectar, Reconectar ou solicitar análise do suporte.
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.

Histórico, vagas e cobrança

A aba Assinatura mostra o plano vigente, a capacidade paga e a previsão de adicionais na renovação. A conclusão de uma desconexão ou o reconhecimento de um banimento pode liberar uma vaga reutilizável, sem apagar o histórico de risco. Veja como substituir números, como os adicionais são ajustados e como migrar voluntariamente para o Pro.