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

Primeiros passos

Do primeiro login ao teste real de mensagem, sem pular os gates de segurança.

Abrir HookCloud FlowPolítica de Privacidade
Versão 4.4.0Atualizada em 30 de agosto de 2026 · inclui CláudIA no suporte privado, memória isolada, revisão humana, limite de equipe, diagnóstico Meta, qualidade e risco reconciliados e orientação correta para status de mensagens.

1. Entre por link mágico

Acesse o login oficialUse login-flow.hookcloud.app ou o link enviado por convite.
Digite o e-mail corretoO e-mail deve ser o owner atual, membro ativo ou destinatário de convite pendente.
Abra o e-mail mais recenteLinks antigos podem expirar ou ter sido substituídos.
Confirme o workspaceO painel só libera ações depois de validar owner/membership.

2. Checklist antes de conectar

  • Business Portfolio/WABA acessível pela conta usada na Meta.
  • Número disponível para o modo escolhido.
  • Destino definido: Chatwoot/plataforma externa ou webhook HTTPS público.
  • Se usar webhook próprio: domínio público, DNS e TLS válidos, GET sem login e resposta exata de hub.challenge.
  • O POST deve aceitar JSON e responder rapidamente com HTTP 2xx.
  • Owner/admin autorizado no workspace.
  • Plano com vaga disponível ou substituição do mesmo número.

3. Conclua o Embedded Signup

Selecione o tipo de conexão e o destino das mensagens. Para Chatwoot, não informe URL; para webhook próprio, use HTTPS público. Depois clique em Conectar com a Meta e conclua todas as telas.

4. Acompanhe o processamento

O painel pode exibir Processando enquanto confirma token, WABA, número, inscrição do App e callback. Não repita a conexão nem altere o webhook durante essa etapa.

Webhook próprio: até 3 tentativas
Falhas de callback usam intervalo mínimo de cinco segundos, timeout de dez segundos por validação e cronômetro aproximado de 45 segundos. Se a falha for segura, a tentativa provisória é removida e a mensagem explica em português o que corrigir.
Se o painel pedir atualização
Atualize a tela e confira a rota antes de tentar novamente. Isso ocorre quando a Meta pode ter aplicado a alteração, mas a leitura posterior ficou incerta.

Abra o log para acompanhar eventos e códigos de suporte.

5. Faça o teste final

  1. Expanda o card da conexão.
  2. Confira o Phone Number ID e a rota.
  3. Revele o token somente se seu papel permitir.
  4. Faça uma chamada simples à API ou envie uma mensagem controlada.
  5. Confirme que o POST chega ao webhook esperado.
Teste conforme o modo
Webhook próprio: confirme o POST na URL. Chatwoot: crie a inbox, clique “Verificar Chatwoot” e teste mensagens de entrada e saída.
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.