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 | Como aparece | Significa | O que fazer |
|---|---|---|---|
| Conectado | Só a palavra | Configurada e operante | Nada, está tudo certo |
| Disponível | Palavra em cinza | Ainda não conectada | Clique em + Conectar |
| Atenção | Palavra com uma barra vermelha antes | Configurada, mas o último uso falhou | Abra e Reconecte / corrija |
| Em breve | Palavra em cinza | No roadmap, sem tela ainda | Aguardar, sem ação |
O estado é sempre uma palavra. A cor fica só na barra, e só no que pede a sua ação: assim, quando ela aparece, é para olhar.
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 ligado com mensagem de erro, Atenção; nenhum habilitado, Disponível; senão, Conectado.
- Telefonia: sem canal de voz, Disponível; canal ligado com erro, Atenção; algum habilitado, Conectado.
- Telegram, Instagram e Messenger: sem canal cadastrado, Disponível; algum canal ligado com erro, Atenção, com a mensagem (e quantos canais estão com erro, quando é mais de um); canais cadastrados mas nenhum habilitado, Atenção (as mensagens continuam chegando ao inbox, mas a IA não responde sozinha); senão, Conectado, que aqui quer dizer “cadastrado e habilitado”.
- Google Calendar / Drive: Conectado se o OAuth está ativo, senão Disponível.
- 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): Disponível enquanto ninguém o ativou; Atenção quando está ativado mas desligado, sem conector registrado ou sem conector online, com a frase do motivo; Conectado quando há conector online. A lista completa do que falta fica na Visão geral do Lume.
- 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.
- 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.