Topo do painel
| Controle | O que faz | Observação |
|---|---|---|
| Logo HookCloud / Meta Business Partner | Identifica o produto e a condição comercial exibida no painel. | Não concede automaticamente permissões sobre BMs de terceiros. |
| Documentação | Abre esta central de ajuda. | Use antes de acionar suporte para erros conhecidos. |
| Conta e e-mail | Permite ao owner solicitar troca do e-mail de acesso. | Sessões anteriores são encerradas após a mudança. |
| Sino | Lista alertas de números, cobrança, comunidade, e-mail e operações. | O contador considera itens novos/não lidos. |
| Som | Ativa ou silencia o som de notificações. | O navegador exige ao menos uma interação antes de tocar áudio. |
| Tema | Alterna modo claro/escuro. | Preferência salva no navegador. |
| Sair | Encerra a sessão atual. | Use também em dispositivos compartilhados. |
Visão geral e resumo
| Card/ação | Significado |
|---|---|
| Assinatura | Estado de acesso do workspace e provedor de cobrança. |
| Números | Quantidade contabilizada no plano. Versões substituídas ou transferidas não devem ocupar nova vaga. |
| Colaboradores | Owners, admins e members ativos, dentro do limite do workspace. |
| Alertas críticos | Restrições, banimentos, qualidade RED e falhas relevantes. |
| Conectar WhatsApp | Inicia o fluxo de nova conexão. Somente papéis autorizados veem/uso essa ação. |
| Recarregar painel | Busca novamente dados do workspace sem trocar de conta. |
Abas principais
| Aba | Botões e recursos |
|---|---|
| Números | Pesquisar, filtrar, escolher itens por página, expandir card, mostrar/copy token, WhatsApp Manager, alterar webhook, validar rota, desconectar/reconectar, log. |
| Equipe | Convidar, reenviar/revogar convite, remover membro e consultar papel. |
| Assinatura | Abrir portal de cobrança, atualizar dados ou consultar estado do provedor. |
| Academy | Abrir cursos, continuar aula, baixar material e acompanhar progresso. |
| Networking | Selecionar canal, pesquisar, responder, editar, mencionar, anexar, denunciar e abrir atendimento privado. A CláudIA não atua nos canais públicos. |
| Suporte privado | Conversar com a CláudIA ou com a equipe humana. O Admin pode ligar ou desligar a resposta automática global e pausar a IA em uma conversa específica. |
Username comercial e número copiável
No card expandido, a área de informações técnicas mostra o username comercial quando disponível e oferece o campo Número para Chatwoot, copiado em formato internacional sem espaços, traços ou parênteses.
Exemplo
O número visual
+1 555-381-1311 é copiado como +15553811311.Cronômetros das operações
O painel diferencia operações que escrevem na Meta de verificações passivas.
| Operação | Comportamento visual | Orientação |
|---|---|---|
| Nova conexão com webhook próprio | Aproximadamente 00:45, até 3 tentativas e intervalo mínimo de 5 segundos. | Não feche ou repita. Em falha segura, o card provisório é removido. |
| Verificar Chatwoot | Leitura passiva: uma tentativa manual ou até três automáticas. | Não bloqueia Configurar caixa existente, Usar webhook próprio ou Desconectar. |
| Configurar caixa existente | Aplicação + readback da URL/verify token da inbox. | Aguarde o resultado terminal. |
| Alteração de webhook existente | Preserva o endpoint anterior até a confirmação remota. | Não é o mesmo fluxo da política 3 × 5. |
| Desconexão | Usa checkpoints e pode mostrar Parar desconexão. | Cancele somente enquanto a parada estiver disponível. |
Contador zerado não significa falha automática
Uma aplicação pode aguardar a Meta; uma verificação passiva deve terminar como estado informativo sem prender os botões.
Cores e estados
| Cor/estado | Interpretação |
|---|---|
| Verde / Ativa | Conexão operacional, canônica e sem alerta crítico conhecido. |
| Amarelo / Processando ou atenção | Operação em fila, autorização limitada, rota aguardando confirmação ou qualidade YELLOW. |
| Vermelho / Falhou, restrita ou banida | Há falha terminal, restrição ou bloqueio. Abra o log antes de repetir. |
| Roxo | Em números, pode indicar versão transferida/substituída. No suporte privado, o card e os balões roxos destacam uma conversa que merece atenção humana; isso não pausa a CláudIA automaticamente. |
| Cinza / Desconectada | Não está operacional no workspace. |
Controles da CláudIA no suporte privado
| Controle/estado | Comportamento |
|---|---|
| Resposta automática global | O Admin habilita ou desabilita a CláudIA para novos atendimentos privados. A mudança não afeta os canais públicos de Networking. |
| Pausar IA nesta conversa | Suspende respostas automáticas somente naquele atendimento para a equipe humana assumir. |
| Chamar atendente humano | O assinante pode pedir atendimento humano a qualquer momento. A conversa permanece salva e visível à equipe. |
| Destaque roxo | Sinaliza atenção humana recomendada no card lateral e nas mensagens. É um alerta, não um encerramento automático da resposta por IA. |
| Revisão da IA | Aprovar uma sugestão registra a decisão e coloca a ideia na fila de melhoria. Não altera automaticamente documentação, banco, Worker ou código. |
Veja escopo, memória, imagens e limitações em CláudIA no suporte.
Por que um botão pode não aparecer
O painel aplica o princípio do menor privilégio. Owners e admins têm mais ações; members convidados normalmente ficam em consulta. Um botão também pode ficar oculto quando a conexão é histórica, está em transferência, não tem Phone Number ID confirmado ou o token não possui a permissão necessária.
Falha fechada
Se o workspace não for confirmado pelo backend, o painel operacional fica bloqueado. O usuário não deve conseguir iniciar Embedded Signup em um contexto de workspace inválido.
Botões e estados do modo Chatwoot
| Item | Significado |
|---|---|
| Aguardando plataforma externa | A conexão Meta está ativa, mas nenhuma rota externa correta foi confirmada. |
| Verificar Chatwoot | Relê a rota sem escrever. A ação é passiva e não bloqueia a configuração explícita. |
| Configurar caixa existente | Aplica Callback URL + Verify Token da inbox no Phone Number ID e confirma por readback. |
| Rota externa confirmada | O callback esperado foi detectado e a entrega está gerenciada pela plataforma. |
| Usar webhook próprio | Inicia a transição para uma URL própria. |
| Desconectar / Parar desconexão | Encerra o vínculo ou cancela a solicitação antes da fase irreversível. |
No modo externo, um webhook antigo não é considerado Chatwoot apenas por ser diferente do fallback global. A rota precisa corresponder à caixa configurada.
Escopo da automação
O painel gerencia conexão, credenciais, webhooks e observabilidade. Ele não possui construtor de funis ou bloco “Webhook/API”. Para automações, use o webhook próprio com CRM, n8n, Make ou backend externo.
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.