> A integração profunda com o ERP IXC — conectar, mapear categorias, agendar visitas, escolher o que a IA pode executar e descobrir os IDs da sua instalação. # IXC (Sistema de Gestão) O IXC é o ERP mais usado por provedores no Brasil, e a integração mais profunda do conecta/ai. Conectado, o agente lê dados de assinante, consulta status de conexão, abre atendimentos e ordens de serviço, envia 2ª via e nota fiscal e agenda visitas técnicas — tudo direto no seu IXC. ## Onde fica Menu **Configuração › Integrações › IXC** — rota `/config/integracoes/ixc`. A página tem uma barra lateral com **8 abas**: Visão geral, Conexão, Categorias, Agendamento, Capacidades, Telefones, Ações IXC e Logs. ## Aba Conexão O ponto de partida. Enquanto não estiver conectado, você vê o formulário: - **Sistema** — escolha "IXC Provedor" (MK-Auth e SGP aparecem como "em breve"). - **URL da API** — o endereço do seu IXC, ex. `https://suaempresa.ixc.com.br`. - **Token da API** — o token de acesso do IXC (campo protegido). - **Intervalo de sincronização** — de quanto em quanto tempo o conecta/ai puxa dados: 15 min, 30 min, 1 h ou 2 h. 1. **Teste antes de salvar.** O botão **"Testar conexão"** valida URL + token sem gravar nada e responde "Conexão bem sucedida!" ou o erro exato da sua instalação. 2. **Salve.** Com o teste OK, clique em **"Salvar e conectar"**. A primeira sincronização começa e traz os assinantes. Depois de conectado, a mesma aba vira um **painel de status**: provider, badge (Conectado / Erro / Sincronizando / Pendente), URL, data do último sync, número de assinantes sincronizados, intervalo e o erro do último sync, se houver. As ações ficam aqui: - **Sincronizar agora** — dispara uma sincronização manual. - **Desconectar** — remove a configuração (pede confirmação). - **Histórico de sincronizações** — lista com data, "N novos / N atualizados" ou erro, e duração. > **Nota.** > O token do IXC é **cifrado** no banco (AES-256-GCM) e nunca volta ao navegador em claro. Ao reeditar, deixar o campo em branco mantém o valor atual. ## Aba Visão geral Um resumo rápido: **Categorias ativas** (`X/Y` com assunto e setor configurados), **Setor padrão** e **Status** (Conectado / Desabilitado). Se o IXC ainda não estiver conectado, mostra um convite para conectar. ## Aba Categorias Aqui você conecta as **categorias de atendimento** da IA aos **assuntos e setores** do seu IXC. A tela puxa em tempo real do IXC os assuntos, setores, funcionários e processos, então você mapeia usando os nomes que já existem na sua operação. As categorias vêm em dois grupos: - **Internas (IA resolve)** — a IA trata sozinha (ex.: 2ª via, status de conexão). - **Externas (encaminham)** — geram um atendimento para a equipe humana. Cada categoria exibe seu estado: `✓ configurada`, `⚠ falta assunto`, `⚠ falta setor` ou `Inativa`; uma tag "padrão" nas default; e "IA agenda ✓" quando é externa com agendamento direto. **Ações:** **Restaurar padrão** (reativa/recria as categorias default), **Nova categoria**, editar (engrenagem) e excluir/desativar (lixeira — categoria padrão só desativa, categoria criada por você é excluída de vez). No **modal de categoria** você define: | Campo | Para que serve | |-------|----------------| | **Nome** | Bloqueado nas categorias padrão | | **Descrição** | A IA usa este texto para decidir quando aplicar a categoria | | **Tipo** | Interno (IA resolve) ou Externo (encaminha) | | **Assunto IXC** * | Obrigatório — o assunto do chamado no IXC | | **Setor IXC** * | Obrigatório — o setor que recebe | | **Colaborador responsável** | Opcional | | **Processo IXC** | Opcional | | **Prioridade** | Baixa / Média / Alta | | **IA agenda visita direto** | Só em categorias Externas — deixa a IA marcar a visita | | **Ativa** | Liga/desliga a categoria | ## Aba Agendamento Define **como a IA agenda visitas técnicas**. São dois modelos: - **Equipe agenda** (padrão) — a IA cria o atendimento de visita e a equipe humana atribui o técnico dentro do IXC. - **IA agenda direto** — a IA mostra os horários livres ao cliente, ele escolhe e a IA reserva o técnico na hora. Este modo revela campos extras: - **Equipe** (puxada do IXC) e **Técnicos elegíveis** (marque quais; vazio = todos da equipe). - **Dias da semana permitidos** (Dom–Sáb), **Início / Fim** (horário), **Duração da visita** (15–240 min) e **Antecedência mínima** (0–48 h). > **Atenção.** > No modo **IA agenda direto**, o horário reservado é uma **reserva, não um bloqueio rígido** — a equipe pode remanejar depois no próprio IXC. Depois de configurar, clique em **Salvar**. ## Aba Capacidades Liga e desliga, uma a uma, o que a IA **pode executar** no IXC. As ações marcadas com ⚠ são **destrutivas** — mexem no serviço do cliente: | Capacidade | Destrutiva? | Padrão | |------------|-------------|--------| | Transferir atendimento | — | Ligada | | Agendar visita | — | Ligada | | Enviar nota fiscal | — | Ligada | | Desbloqueio de confiança | ⚠ | Ligada | | Liberar FUP | ⚠ | Ligada | | Forçar reauth (RADIUS) | ⚠ | Ligada | | **Reboot ONU** | ⚠ | **Desligada** | | **Reset ONU** | ⚠ | **Desligada** | | **Trocar plano** (upsell — muda o billing no ERP) | ⚠ | **Desligada** | > **Importante.** > **Reboot ONU, Reset ONU e Trocar plano começam desligados de propósito.** Só ligue depois de decidir que quer a IA fazendo isso sozinha — reset de ONU e troca de plano têm impacto real no cliente. Clique em **Salvar** para aplicar. ## Aba Telefones Nem todo assinante tem só um número no IXC. Aqui você ordena **qual campo de telefone vira o número principal** do assinante na sincronização. A lista é reordenável (↑/↓), com a ordem padrão: **WhatsApp → Celular → Fone → Telefone comercial** O primeiro campo preenchido vence; os demais entram como contatos secundários. Clique em **Salvar**. ## Aba Ações IXC O IXC usa "botões customizados" cujos IDs **mudam de instalação para instalação** (ex.: `radpop_radio_cliente_fibra_24699`). Esta aba resolve esses IDs para a sua conta: 1. **Detectar automaticamente.** O botão testa se os IDs padrão funcionam. Para cada ação — Reset ONU, Reboot ONU, Liberar redução FUP, Transferir atendimento — mostra `✓ ok` ou `✗ configure manualmente`, com um campo para você colar o ID certo. 2. **Não achou sozinho?** Abra o link **"Como achar ID"**: um passo a passo para pegar o número no seu IXC (DevTools do navegador → aba Network → clicar no botão real no IXC → copiar o número final da URL). 3. **Salvar overrides.** Grava os IDs que você ajustou à mão. ## Aba Logs Mostra os últimos 50 registros de sincronização, em formato JSON, para diagnóstico. Se o IXC não estiver conectado ou não houver eventos, exibe um estado vazio. ## Veja também - [Ferramentas nativas](/configuracoes/integracoes/tools-nativas) — as tools de IXC que o agente usa em runtime - [Agenda](/operacoes/agenda) — onde as visitas agendadas aparecem - [Status e diagnóstico](/configuracoes/integracoes/status)