Status e diagnóstico das integrações
Cada card do hub mostra um selo de status calculado por organização — o estado real da sua operação. Esta página explica como ler cada selo e o que fazer quando uma integração cai em erro.
Onde fica
O status aparece no hub (/config/integracoes) e no cabeçalho de cada página de integração. Os dois usam a mesma fonte — o que você vê no card é o mesmo que vê ao abrir a integração.
Os 4 selos
| Selo | Cor | Significa | O que fazer |
|---|---|---|---|
| Conectado | 🟢 verde | Configurada e operante | Nada — está tudo certo |
| Disponível | ⚪ cinza | Ainda não conectada | Clique em + Conectar |
| Atenção | 🔴 vermelho | Configurada, mas o último uso falhou | Abra e Reconecte / corrija |
| Em breve | 🟡 âmbar | No roadmap, sem tela ainda | Aguardar — sem ação |
O selo distingue “configurado” de “não configurado / erro”. O liga-desliga fino de uma integração (ativar/desativar) vive dentro da aba Conexão dela — não no selo.
Como o status é resolvido, por integração
- IXC — sem configuração: Disponível; com erro no último sync: Atenção; senão Conectado (com “sync há X”).
- WhatsApp Cloud — sem número: Disponível; número com mensagem de erro: Atenção; nenhum habilitado: Disponível; senão Conectado.
- Telefonia — sem canal de voz: Disponível; com erro: Atenção; algum habilitado: Conectado.
- Google Calendar / Drive — Conectado se o OAuth está ativo, senão Disponível.
- WhatsApp não-oficial (Baileys) — depende das sessões pareadas.
- Modelos de IA (LLM) — Conectado quando o provedor está ativo no servidor (gerenciado pela ConectAI).
- Acesso Remoto (Flashman) — Disponível sem configuração; Conectado quando configurado (o ativo/desativado fino fica na aba Conexão).
- Lume (acesso direto) — sempre aparece Disponível no hub: ele não tem resolver de status próprio. Veja o estado real na página dele (relays online).
- Ferramentas nativas / HTTP / MCP — sempre Conectado (são built-in / sempre disponíveis por organização).
Se, por algum motivo, a checagem de status falhar, a integração aparece como Disponível (comportamento à prova de falha) — não como erro.
Reconectar
Quando uma integração está em Atenção, abra-a e use a ação de reconexão da aba Conexão:
- IXC — corrija URL/token e Sincronizar agora (ou reteste a conexão).
- WhatsApp Cloud — edite as credenciais e revalide com a Meta; confira também a Saúde do número.
- WhatsApp não-oficial — Renovar sessão / Reconectar e escanear o QR de novo.
- Google Calendar / Drive — Reconectar pelo OAuth.
- Acesso remoto — Reconfigurar ou Desconectar e conectar de novo.
Segurança dos segredos
Tokens e senhas (IXC, WhatsApp, Flashman, relay do Lume) nunca voltam em claro — chegam mascarados e, ao editar, deixar em branco mantém o valor atual. Credenciais de IXC e roteador são cifradas no banco. Nunca cole segredos em campos de descrição ou em conversas de suporte.
Quando abrir chamado com o suporte
Abra um chamado se, depois de reconectar, a integração continuar em Atenção, ou se:
- o WhatsApp começa a falhar em volume relevante;
- o webhook não dispara para a URL configurada;
- uma sincronização (IXC) trava repetidamente.