Transferências e histórico

Conexão atual x versão histórica

Estado	O que significa
current / canonical	Versão técnica atual do telefone naquele workspace.
superseded	Outra versão do mesmo E.164 substituiu esta conexão.
transferred	O ativo passou a outro workspace.
released/disconnected	Vínculo encerrado sem ser a versão atual.
review_required	O sistema preservou o conflito para decisão humana.

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

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ário	Comportamento
Nova autorização após desconexão pendente	A 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ão	Quando 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ão	Disponível enquanto a operação ainda não entrou em fase remota/local irreversível.
Mesmo telefone com novo Phone Number ID	A 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.

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

Abra Em processamento.
Compare Phone Number ID, WABA, webhook, App e data.
Clique Validar webhook desta versão.
Aguarde Rota confirmada.
Como owner, clique Usar esta conexão como atual.
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.