ConfiguraçõesIntegraçõesIXC (ERP do provedor)

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.

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:

CampoPara que serve
NomeBloqueado nas categorias padrão
DescriçãoA IA usa este texto para decidir quando aplicar a categoria
TipoInterno (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ávelOpcional
Processo IXCOpcional
PrioridadeBaixa / Média / Alta
IA agenda visita diretoSó em categorias Externas — deixa a IA marcar a visita
AtivaLiga/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).

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:

CapacidadeDestrutiva?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

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

Visão geralTelefonia (DIDs e troncos)