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.
Como pedir orientação sobre a conexão
Informe onde a tentativa parou, qual opção você escolheu e se quer manter o WhatsApp Business no celular. A CláudIA deve usar a mensagem e o código exibidos, o ativo correto e os dados autorizados do atendimento para orientar o próximo passo.
- Tela de seleção: veja número existente, novo ou virtual. A imagem é uma referência, não uma regra de aparência para todas as contas.
- Coexistência: a opção depende do fluxo e da elegibilidade. A Meta pode pedir a digitação e confirmação do telefone do Business App; não existe uma regra universal de seleção pela lista.
- Portfólio ausente ou código 1690114: confira identidade, ativos e permissões. Não crie nem apague empresas em sequência.
- “Não qualificado”: peça o detalhe/código antes de concluir que houve banimento.
- Estados diferentes: compare Phone Number ID, WABA e horário da última leitura; siga o diagnóstico Meta × HookCloud.
- Webhook: só atribua o problema à configuração do endpoint quando houver evidência correspondente. Falha interna ou comunicação inconclusiva exige outro diagnóstico.
Consulte as fontes oficiais Meta revisadas em 09/09/2026. Se o diagnóstico continuar inconclusivo, peça atendimento humano e envie somente as informações necessárias, sem códigos secretos.
Quando a desconexão não termina
A CláudIA pode consultar o registro da operação do número identificado no atendimento e verificar se há uma pausa administrativa vigente. Ela distingue uma tentativa cancelada ou com falha de uma operação em andamento, e diferencia o encerramento local da confirmação de limpeza na Meta.
O log de conexão não é um erro de disparo de mensagem: esse diagnóstico não exige wamid ou JSON de entrega. Dados que já constam do atendimento não precisam ser pedidos novamente. Se a falha exige uma ação da equipe, o encaminhamento é registrado pelo canal de atendimento, sem prometer disponibilidade imediata.
A CláudIA não remove pausas administrativas, não revoga tokens, não exclui números e não cancela nem repete uma desconexão pelo chat. Ela não deve atribuir a causa ao assinante por um erro isolado de acesso. Para evitar a perda de acesso durante a limpeza, desconecte pelo Flow antes de remover a parceria na 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.
Quando a Meta libera um número e o Flow ainda mostra banido
A CláudIA diferencia o último estado salvo do estado atual na Meta e consulta a referência exata do número no workspace. Ela informa a data da sincronização e da validação da credencial quando disponível. Não afirma que todo banimento revoga token, não conclui que uma credencial continua válida apenas porque uma leitura antiga estava válida e não confunde print de “Registrado” ou qualidade GREEN com confirmação de liberação.
Quando o titular informa que a Meta já restabeleceu o mesmo ativo e o Flow permanece desatualizado, a CláudIA orienta a conferência do mesmo ativo e o passo a passo de atualização pelo próprio assinante. Quando for necessário refazer a autorização, ela explica o fluxo: Visão geral, configuração do webhook próprio ou Chatwoot/plataforma externa, Conectar com a Meta, seleção do mesmo portfólio/WABA/número e conclusão da operação. Não pede para aguardar revisão administrativa como primeiro passo e não executa a reconexão em nome do usuário. Também não torna a reconexão obrigatória após toda liberação: se uma leitura atual já confirmou acesso e saúde do mesmo ativo, orienta investigar a divergência local, sem repetir o onboarding.
Um erro atual de token inválido/expirado ou permissão ausente exige reautorização. Um banimento ainda vigente precisa ser tratado nos canais da Meta; reconectar, por si só, não o remove nem reinicia a janela de risco da HookCloud. Quando o contexto técnico confirmar uma restauração validada pela HookCloud a partir da Meta, a CláudIA explica que o BAN anterior abrangido fica resolvido e sai do contador, com o histórico preservado. RED mantém a regra vigente; um BAN posterior à restauração pode contar novamente. Um relato, print, status local isolado, troca de plano ou reconexão não comprovam essa resolução. Não instrua a exclusão do ativo ou a desconexão prévia de um número saudável. Se houver erro concreto ou divergência após uma reconexão concluída, a CláudIA orienta o diagnóstico correspondente e, quando necessário, o suporte técnico com IDs e horário, sem solicitar segredos nem prometer prazo.
Explicação dos contadores de risco
A CláudIA diferencia o inventário atual dos incidentes considerados na janela de 30 dias. Uma WABA banida conta uma vez quando há evidência de banimento da própria WABA que abrange os números; estar na mesma WABA ou no mesmo horário não prova essa abrangência. Banimentos independentes de telefones podem ser contados separadamente. Ela não declara o contador incorreto, nem promete desconto ou resolução, sem evidência técnica suficiente.
O desconto de BAN restaurado exige confirmação validada no servidor para o ativo e a sequência temporal corretos. A CláudIA não altera contadores nem a regra de RED e não diz ter executado uma correção. Consulte BAN resolvido após restauração.
Orientação sobre OBA
Entidades governamentais: novas contratações e operações pela HookCloud estão em validação com atendimento humano da Meta. Antes de contratar para esse uso ou iniciar novo cadastro, operação relacionada a OBA ou migração pela HookCloud, aguarde o posicionamento formal e a publicação das condições aplicáveis. Consulte a condição temporária para entidades governamentais. A espera não impede o uso dos canais independentes da Meta ou do provedor atual.
A CláudIA explica o guia de OBA, seus requisitos e os canais oficiais. O titular ou administrador autorizado prepara, envia e acompanha seu pedido na Meta.
Para OBA, a CláudIA não oferece consultoria individual, coleta de documentos ou credenciais, análise personalizada de elegibilidade, submissão, abertura ou intermediação de chamado na Meta, recurso ou acompanhamento pela HookCloud. Não promete prioridade, prazo ou aprovação e não transforma a dúvida em revisão administrativa de OBA. Isso não altera o suporte aos serviços efetivamente prestados pelo Flow.
Sobre o uso governamental, a CláudIA informa a condição temporária publicada, sem confirmar habilitação, aprovação ou data e sem determinar suspensão de contas atuais. O suporte técnico regular permanece. O cliente paga a Meta com seu próprio método de pagamento; a HookCloud não oferece linha de crédito. Essa condição específica não se aplica a empresas privadas.
Atendimento humano e sinalização da conversa
Você pode escrever “chamar atendente humano” no atendimento privado. Quando a solicitação de encaminhamento é confirmada, a conversa recebe sinalização para a equipe. Essa confirmação significa que o pedido foi registrado; não comprova que um atendente esteja disponível ou que já tenha assumido o caso.
O horário regular é de segunda a sexta-feira, das 9h às 18h, no horário de Brasília. Fora desse horário, registre o pedido no mesmo chat. Aos sábados e domingos, o atendimento humano é excepcional para casos específicos de incidentes na HookCloud, servidores, manutenção ou indisponibilidade de serviços integrados, como Supabase, OpenAI, Cloudflare e Meta. Não há promessa de plantão permanente ou resposta imediata.
Dúvidas comuns de uso, configuração e integração podem ser orientadas pela CláudIA e pela documentação; sua análise humana segue o horário regular. A descrição de um erro não prova que existe uma queda geral. Veja os horários, exemplos e canais de suporte.
O destaque roxo também pode indicar risco, incerteza ou necessidade de decisão humana. Ele não interrompe automaticamente a IA: um atendente pode assumir e pausar as respostas automáticas. Se o encaminhamento não for confirmado, não presuma que a equipe já foi sinalizada; você pode tentar novamente ou usar suporte@hookcloud.app.
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.