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:
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”) |
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.
Integrações disponíveis
IXC (ERP)
Integração profunda com o ERP: assinantes, atendimentos, status de conexão, 2ª via, NFSe e visitas.
LerTelefonia
Números de entrada (DIDs) e troncos SIP do atendimento por voz.
LerWhatsApp Cloud API
Canal oficial da Meta: credenciais, perfil, qualidade/tier e templates.
LerWhatsApp não-oficial
Sessão por QR code (Baileys) para grupos e uso interno.
LerGoogle Calendar
OAuth para sincronizar as visitas técnicas com a agenda da equipe.
LerBackup no Google Drive
Backup cifrado da operação no Drive da empresa, com rotina automática.
LerModelos de IA (LLM)
Os provedores em cascata com fallback — gerenciados pela ConectAI.
LerAcesso remoto a roteadores
A IA opera o roteador do cliente via Flashman (TR-069) ou relay on-prem (Lume).
LerFerramentas nativas
Catálogo das ações built-in do agente, por domínio.
LerFerramentas HTTP
Transforme endpoints HTTP dos seus sistemas em ferramentas do agente.
LerServidores MCP
Registre um servidor MCP e a IA descobre as ferramentas sozinha.
LerTemplates HSM
Mensagens aprovadas pela Meta para iniciar conversa fora das 24h.
LerStatus e diagnóstico
Como ler o estado de cada integração e o que fazer em caso de erro.
LerNo 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 — como as tools chegam ao seu agente
- Status e diagnóstico