<!-- Fonte: https://help.conectaai.io/configuracoes/integracoes · conecta/ai Central de Ajuda -->
> O hub onde você conecta o conecta/ai aos sistemas do seu provedor — WhatsApp, IXC, telefonia, Google, roteadores e as ferramentas do agente.

# Integrações

Uma loja de integrações. É aqui que você conecta o conecta/ai aos sistemas que a sua operação já usa — do ERP à telefonia, do WhatsApp aos roteadores dos clientes — e vê, num relance, o que está ligado e o que falta.

## Onde fica

Menu **Configuração › Integrações** — rota `/config/integracoes`. Cada integração conectável abre a própria página em `/config/integracoes/{nome}`.

## Como a loja funciona

A tela é uma vitrine com **cards** organizados por categoria. No topo há uma **barra de busca** ("Buscar integração...") que filtra por nome e descrição, e **chips de categoria** para você olhar só um grupo por vez:

  **Tudo**
  **Comunicação**
  **Sistemas de Gestão**
  **Rede e Equipamentos**
  **Calendário**
  **IA / LLM**
  **Ferramentas do agente**
  **Pagamentos**
  **Notificações**
  **Armazenamento e Backup**

Cada card mostra o logo, o nome, a categoria, uma descrição curta e um **selo de status**. Dentro de cada categoria os cards vêm ordenados por status — primeiro os conectados, depois os disponíveis. Clicar num card conectável leva à página de configuração dela.

## Os 4 status de um card

O status é calculado **por organização**, no servidor — ou seja, reflete o estado real da _sua_ operação, não um valor genérico.

| Selo | Cor | O que significa |
|------|-----|-----------------|
| **Conectado** | 🟢 verde | Integração configurada e operante (mostra "sync há X min" quando aplicável) |
| **Disponível** | ⚪ cinza | Ainda não conectada — clique em **+ Conectar** |
| **Atenção** | 🔴 vermelho | Configurada, mas o último uso falhou — clique em **Reconectar** |
| **Em breve** | 🟡 âmbar | No roadmap, sem tela de configuração ainda (só "🔔 Me avisar") |

> **Nota.**
> O selo distingue **"configurado" de "não configurado / erro"**. O liga-desliga fino de uma integração (por exemplo, ativar/desativar o acesso remoto) mora **dentro** da página dela, na aba **Conexão** — não no selo do card.

## Quem pode ver e editar

Duas permissões controlam esta área:

- **`integracoes:view`** — ver o hub e o estado das integrações. Toda tela exige, no mínimo, esta permissão.
- **`integracoes:edit`** — criar e editar tools (HTTP/MCP), templates HSM e a rotina de backup.

Segredos (tokens, senhas) chegam ao navegador **mascarados** e nunca são reexibidos em claro. Cada ISP vê apenas as próprias integrações. Veja [Grupos e permissões](/configuracoes/grupos-e-permissoes).

## Integrações disponíveis

  - [](https://help.conectaai.io/configuracoes/integracoes/ixc) — } title="IXC (ERP)">
Integração profunda com o ERP: assinantes, atendimentos, status de conexão, 2ª via, NFSe e visitas.
  - [](https://help.conectaai.io/configuracoes/integracoes/telefonia) — } title="Telefonia">
Números de entrada (DIDs) e troncos SIP do atendimento por voz.
  - [](https://help.conectaai.io/configuracoes/integracoes/whatsapp-cloud) — } title="WhatsApp Cloud API">
Canal oficial da Meta: credenciais, perfil, qualidade/tier e templates.
  - [](https://help.conectaai.io/configuracoes/integracoes/whatsapp-baileys) — } title="WhatsApp não-oficial">
Sessão por QR code (Baileys) para grupos e uso interno.
  - [](https://help.conectaai.io/configuracoes/integracoes/google-calendar) — } title="Google Calendar">
OAuth para sincronizar as visitas técnicas com a agenda da equipe.
  - [](https://help.conectaai.io/configuracoes/integracoes/google-drive) — } title="Backup no Google Drive">
Backup cifrado da operação no Drive da empresa, com rotina automática.
  - [](https://help.conectaai.io/configuracoes/integracoes/llm) — } title="Modelos de IA (LLM)">
Os provedores em cascata com fallback — gerenciados pela ConectAI.
  - [](https://help.conectaai.io/configuracoes/integracoes/acesso-remoto) — } title="Acesso remoto a roteadores">
A IA opera o roteador do cliente via Flashman (TR-069) ou relay on-prem (Lume).
  - [](https://help.conectaai.io/configuracoes/integracoes/tools-nativas) — } title="Ferramentas nativas">
Catálogo das ações built-in do agente, por domínio.
  - [](https://help.conectaai.io/configuracoes/integracoes/http-tools) — } title="Ferramentas HTTP">
Transforme endpoints HTTP dos seus sistemas em ferramentas do agente.
  - [](https://help.conectaai.io/configuracoes/integracoes/mcp) — } title="Servidores MCP">
Registre um servidor MCP e a IA descobre as ferramentas sozinha.
  - [](https://help.conectaai.io/configuracoes/integracoes/templates-hsm) — } title="Templates HSM">
Mensagens aprovadas pela Meta para iniciar conversa fora das 24h.
  - [](https://help.conectaai.io/configuracoes/integracoes/status) — } title="Status e diagnóstico">
Como ler o estado de cada integração e o que fazer em caso de erro.

## No roadmap (aparecem como "Em breve")

E-mail SMTP, SMS, MK-Auth, SGP, Acesso Remoto IXC ACS, Outlook Calendar, Stripe, Asaas, Slack e Telegram aparecem na loja para você saber que estão a caminho, mas ainda **não têm tela de configuração** — o card só mostra o aviso "Te avisamos quando lançar".

## Veja também

- [Ferramentas do agente](/ambiente-ia/tools) — como as tools chegam ao seu agente
- [Status e diagnóstico](/configuracoes/integracoes/status)