<!-- Fonte: https://help.conectaai.io/configuracoes/integracoes/status · conecta/ai Central de Ajuda -->
> Como cada integração calcula o próprio status, o que significam Conectado, Disponível, Atenção e Em breve, e como reconectar quando algo falha.

# 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 |

> **Nota.**
> 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

> **Atenção.**
> 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.

→ [Falar com suporte](/suporte)

## Veja também

- [Integrações (hub)](/configuracoes/integracoes)
- [WhatsApp Cloud API](/configuracoes/integracoes/whatsapp-cloud) · [IXC](/configuracoes/integracoes/ixc)
