Onde a CláudIA funciona
A CláudIA responde somente nos atendimentos privados. O chat geral permanece reservado ao Networking entre assinantes e às respostas humanas da equipe HookCloud.
O Admin pode ligar ou desligar as respostas automáticas para novos atendimentos privados e também pausar a IA em uma conversa específica. O assinante pode pedir um atendente humano a qualquer momento.
Contexto e memória
Para evitar respostas pergunta por pergunta, a CláudIA usa o trecho recente da conversa privada, registros privados relevantes já resolvidos e uma memória resumida do atendimento. O isolamento considera o usuário autenticado, o workspace e o ambiente; conversas de assinantes ou workspaces diferentes não devem ser misturadas.
Somente o conteúdo autorizado do atendimento privado serve de contexto. Mensagens do chat público não são usadas para resposta automática.
Fontes de conhecimento
- documentação oficial do HookCloud Flow;
- páginas oficiais do produto e da política de privacidade;
- cursos, módulos e aulas publicados e autorizados na Academy Flow;
- orientações oficiais da Meta/WhatsApp relacionadas ao produto;
- dados técnicos e diagnósticos do workspace que o usuário pode consultar.
Quando existir uma aula pertinente, a CláudIA pode indicar o curso, módulo ou aula correspondente. Links de documentação devem apontar para documentacao-flow.hookcloud.app.
Diagnósticos permitidos
Em modo somente leitura, a CláudIA pode relacionar a dúvida a um Connection ID, Phone Number ID ou número identificado, consultar o último estado conhecido da conexão, autorização, qualidade, risco e rota do callback e, quando a pergunta exigir, executar verificações controladas.
| Verificação | O que confirma | O que não confirma |
|---|---|---|
| Credencial Meta | Resultado atual ou histórico da validação autorizada. | Não renova nem substitui token revogado. |
| Alcance do callback | Se a URL pública respondeu ao teste HTTPS controlado. | Não prova o challenge completo, o verify token nem a assinatura do POST. |
| Status global da Meta | Consulta a fonte oficial em Meta Status. | Não substitui o diagnóstico do número específico. |
Um estado local CONNECTED não garante que a credencial Meta continue válida. Se a autorização foi revogada, é necessária uma nova conexão pelo fluxo oficial da Meta.
Imagens anexadas
A CláudIA pode analisar até três imagens por pergunta nos formatos PNG, JPEG, WEBP ou GIF, com até 4 MB por imagem. Use prints para mostrar a mensagem de erro, mas oculte token, PIN, OTP, senha, dados de cartão e informações pessoais desnecessárias.
Limites de atuação
A CláudIA orienta e diagnostica; ela não altera conexão, callback, credencial, assinatura, documentação, banco de dados ou código. Também não executa disparos de mensagens.
O Flow não é disparador, CRM nem caixa de entrada e não possui histórico dos envios feitos por sistemas externos. Localize no sistema que enviou a mensagem o evento recebido no POST do callback, em entry[].changes[].value.statuses[], correlacione pelo wamid e verifique status e errors.
Atendimento humano e alerta roxo
Quando a CláudIA identifica maior risco, incerteza ou necessidade de decisão humana, o atendimento recebe destaque roxo no balão e na lista lateral. Esse alerta chama a atenção do Admin, mas não interrompe automaticamente a tentativa de ajudar. O atendente pode assumir e pausar a IA manualmente.
Revisão da IA
Quando uma dúvida revela lacuna de conhecimento, a CláudIA pode criar uma sugestão minimizada para revisão administrativa. O card reúne o tema, a justificativa e uma proposta de melhoria.
Aprovar apenas registra a decisão, o revisor, a observação e coloca a ideia na fila. A documentação, o banco, o Worker e o código só mudam após implementação e validação separadas. Marque como implementada somente depois da alteração real.
Privacidade e uso responsável
Perguntas, respostas, contexto privado, anexos e metadados necessários podem ser processados para prestar suporte, preservar continuidade, segurança, auditoria e melhorar a base de conhecimento. Consulte a Política de Privacidade para categorias, fornecedores, retenção e direitos.
No atendimento privado, escreva “chamar atendente humano”. Se preferir e-mail, informe o e-mail do owner, Workspace ID, Connection ID, horário aproximado e o código de suporte para suporte@hookcloud.app. Nunca envie o token completo.