ConfiguraçãoIntegrações

Integrações — /config/integracoes

Tela onde você conecta o conecta/ai aos sistemas que sua operação já usa: ERP do provedor, calendário, voz e equipamentos.

Permissão: integracoes:view.

Sistemas de gestão (ERP do ISP)

IXC Provedor
ATIVO · INTEGRAÇÃO COMPLETA

Sistema mais comum no mercado de provedores. CRUD bidirecional de clientes, faturas, chamados, status de conexão e plano contratado.

HubSoft
ATIVO

ERP completo para ISPs. Sincronização de assinantes, financeiro e ordens de serviço.

OPA Suite
ATIVO

Suite de gestão para provedores regionais. Cadastros, faturamento e atendimento integrados.

IXC ACS (TR-069)
ATIVO · DIAGNÓSTICO

Auto Configuration Server do IXC. A IA consulta sinal, MAC, modelo da CPE e pode executar reboot remoto.

Calendário

Google Calendar
ATIVO · OAUTH 2.0

Necessário para a IA agendar visitas técnicas. Lê slots livres e cria eventos no calendário primário.

Mensageria

WhatsApp Cloud API
ATIVO · OFICIAL META

Canal oficial regulado pela Meta. Atendimento ao cliente final com templates HSM, janela de 24h, áudio, imagem e webhook seguro com assinatura HMAC.

Voz

Twilio
ATIVO · TRUNK SIP

Provider global de telefonia. Trunk SIP para receber e originar ligações em qualquer DDI.

Conectar o IXC Provedor — passo a passo

  1. Em /config/integracoes, no bloco Sistema de Gestão, escolha IXC Provedor no dropdown.

  2. Preencha:

    CampoDetalhe
    URL da APIEx.: https://suaempresa.ixc.com.br (sem /webservice/v1)
    Token da APIToken gerado no painel do IXC
    Intervalo de sincronização15 min · 30 min · 1 h · 2 h

  3. Clique em “Testar conexão” — feedback inline:

    • “Conexão OK” — credenciais válidas
    • “Erro: …” — mensagem retornada pelo IXC

  4. Clique em “Salvar e conectar” — o conecta/ai registra a integração e começa a sincronizar:

    • Lista de assinantes (CRUD bidirecional)
    • Faturas em aberto (para 2ª via)
    • Status de conexão (online/offline)
    • Chamados (consulta + abertura)

O que a IA faz com o IXC ligado

Ação da IAEndpoint IXC usado
Consultar status do clienteclientes, radusuarios, radacct
Buscar fatura em abertofn_areceber
Gerar 2ª via de boletofn_areceber/{id}/pdf
Abrir chamado técnicosu_oss_chamado
Listar chamados existentessu_oss_chamado
Ver dados do plano contratadocliente_contrato_plano

Logs de sincronização

Abaixo do form de configuração, a tela mostra os últimos sync logs:

  • Data/hora
  • Resultado (success/error)
  • Quantidade de registros processados
  • Mensagem de erro (quando aplicável)

Útil pra detectar problema: se sync travou há 2h, algo aconteceu.

Token IXC — boas práticas

Token específico para o conecta/ai. Crie um usuário/token dedicado no IXC, não use o seu pessoal. Quando alguém sair da empresa, basta revogar esse token sem afetar o resto.

  • Permissões mínimas: leitura em cliente_contrato_plano, fn_areceber, escrita em su_oss_chamado
  • Renove o token a cada 12 meses por higiene
  • Se vazar, revogue imediatamente no IXC

Conectar HubSoft / OPA Suite

O fluxo é idêntico ao do IXC:

  1. Em Sistema de Gestão, escolha o provider correto no dropdown (HubSoft ou OPA Suite).

  2. Preencha URL da API e Token (obtidos no painel do respectivo sistema).

  3. Testar conexão → Salvar e conectar.

Cada provider tem capacidades ligeiramente diferentes — fale com seu Account Manager se precisar de uma feature específica de algum.

Conectar Google Calendar

  1. No bloco Google Calendar, clique em Conectar Google Calendar.

  2. O conecta/ai redireciona para o OAuth do Google (/api/integrations/google/start). Faça login com a conta Google da empresa.

  3. Aceite as permissões solicitadas:

    • Ler eventos do calendário
    • Criar eventos no calendário
    • Editar eventos criados pelo conecta/ai

    Importante: o conecta/ai não consegue mexer em eventos que ele não criou. Sua agenda pessoal continua intacta.

  4. Volta para /config/integracoes com status Conectado.

O que a IA faz com Calendar conectado

  • Listar slots disponíveis quando o cliente pede agendar visita
  • Criar evento com nome do cliente, endereço, descrição
  • Confirmar 1 dia antes via WhatsApp (campanha automática)
  • Re-agendar se o cliente pedir mudança
  • Cancelar quando o cliente desmarca

Calendário usado

A IA usa o calendário primário da conta conectada. Para separar visitas técnicas em um calendário específico:

  1. Crie um calendário “Visitas Técnicas” no Google Calendar
  2. Configure o owner como a conta conectada
  3. (Em breve) selecionar calendário específico no conecta/ai — hoje usa o primário

Desconectar

A próxima sync vai falhar e o status mudará para disconnected. Reconecte se necessário.

IXC ACS (TR-069) — diagnóstico de equipamento

Quando o IXC ACS está disponível, a IA consegue:

  • Consultar modelo, MAC e fabricante do roteador/ONU do cliente
  • Ler sinal RX/TX e detectar problema físico (cabo, fibra)
  • Executar reboot remoto sem precisar visita técnica
  • Listar dispositivos conectados ao Wi-Fi

Configurado pelo time conecta/ai durante o onboarding técnico — não é self-service hoje.

Stack de IA por trás

Para transparência total, esses são os providers que rodam a IA:

AnthropicAnthropic
OpenAIOpenAI
TwilioTwilio
GoogleGoogle
  • Anthropic (Claude) — modelo de linguagem que pensa cada turno da conversa
  • OpenAI (Whisper) — transcrição de áudios de WhatsApp e reforço em chamadas longas
  • Twilio — trunk SIP para telefonia internacional
  • Google — OAuth + Calendar API

Você não precisa contratar nada disso separadamente — está incluído no plano do conecta/ai.

Webhooks customizados

Em desenvolvimento. Webhooks customizados (POST a uma URL sua a cada evento) estarão disponíveis em uma próxima versão. Hoje há apenas o webhook de escalonamento configurável em /config/geral.

Próximo passo

→ Configurar agente
→ Identidade visual

Usuários & permissõesNotificações