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 Loja › 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.

Filiais atendidas

Quando a mesma base IXC atende mais de uma empresa, cada uma com a sua organização no conecta/ai, cada organização escolhe aqui as filiais que são suas. A lista vem do IXC na hora; marcar todas é o mesmo que não escolher, e é o padrão.

Com filiais escolhidas:

• a sincronização só importa clientes dessas filiais;
• a IA só encontra clientes dessas filiais, na busca por CPF ou por telefone;
• contratos de outras filiais não aparecem.

A filial do cliente é a do contrato; sem contrato, a do cadastro. Quem tem cadastro nas duas empresas é encontrado pelo cadastro da filial desta organização.

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.

Quando alguma categoria sem assunto ou sem setor já impediu atendimentos de chegar ao IXC, um aviso acima dos cartões diz quantos foram nos últimos 7 dias e em quais categorias, com o link para a aba Categorias. Sem perda nesse período, o aviso não aparece.

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.

No topo da aba fica Quando a IA registra o atendimento no seu sistema: toda conversa (o padrão) ou só quando precisa de visita técnica. É a mesma opção da ferramenta Abrir chamado, em Ferramentas nativas, e vale nos dois lugares. Trocar exige a permissão de editar integrações; sem ela, a opção aparece, mas não troca.

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.

Atendimentos que não chegaram ao IXC. Quando a IA atende e a categoria escolhida está sem assunto ou sem setor, o atendimento não é registrado no IXC: o cliente é atendido, mas o seu ERP fica sem o histórico. Isso vale para o registro do atendimento, para o chamado de suporte e para a ordem de serviço da visita. Nesse caso, o topo desta aba mostra quantos atendimentos ficaram de fora nos últimos 7 dias e em quais categorias. Configure o assunto e o setor dessas categorias para os próximos entrarem no IXC; os que já passaram não são registrados depois.

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:

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. Como ninguém marcou hora, a IA diz ao cliente o dia e o turno que ele pediu (manhã ou tarde) e que a equipe confirma o dia e a hora; ela não informa horário. O mesmo vale quando a O.S. não chegou ao 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). Técnico, aqui, é o colaborador ativo cadastrado na equipe no seu IXC, em Suporte › Cadastros › Equipe › Colaboradores da Equipe. Quem não estiver vinculado a uma equipe ali não aparece na lista nem recebe visita, e um técnico que está em mais de uma equipe vale para todas elas.
  • Dias da semana permitidos (Dom a Sáb), Início / Fim (horário), Duração da visita (15 a 240 min) e Antecedência mínima (0 a 48 h).

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:

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.

Cliente com mais de um contrato

Quando o cliente tem dois ou mais contratos ativos, a IA mostra cada um pelo endereço de instalação, com bairro, cidade e complemento, e não só pelo número e pelo plano. O endereço é o do próprio contrato; quando o contrato não tem endereço próprio, vale o do cadastro do cliente.

• O atendimento e a O.S. que a IA abre vão para o contrato que o cliente escolheu, com a filial e o login desse contrato. A mensagem da O.S. leva o endereço de instalação por escrito.
• Para agendar visita, a IA pergunta antes qual contrato, mostrando os endereços. Nada é gravado no IXC até o cliente escolher. Vale no WhatsApp, no Telegram, no chat do site, no app e no telefone.
• O IXC continua abrindo o atendimento no endereço do login. Por isso o endereço de instalação vai escrito na mensagem da O.S.

Contrato encerrado chega à IA como cancelado

Quando a IA consulta o contrato do cliente, o contrato que o IXC encerrou (cancelado, ou inativo com a internet desativada, os mesmos que o IXC lista como contratos perdidos) chega a ela como cancelado, e não como suspenso. Assim o ex-cliente não é atendido como cliente bloqueado. No diagnóstico de conexão, contrato suspenso ou cancelado leva a IA a passar o atendimento para a equipe.

• Contrato inativo com a internet em outro estado continua chegando como suspenso: sem prova de encerramento, o sistema fica com a leitura mais cautelosa.
• Quando o cliente tem um contrato encerrado e outro que o IXC não encerrou, vale o que não foi encerrado: um cancelado antigo não esconde a suspensão do contrato vivo.

Essa é a mesma régua da situação Ex-cliente em Contatos.

Contrato aguardando assinatura

Quando o IXC marca a internet do contrato como Aguardando Assinatura, o cliente está sem acesso porque falta o titular assinar o contrato. Não é débito nem falha de rede, e a IA trata assim:

• Diz ao cliente que o contrato aguarda a assinatura do titular, em vez de dizer que a internet está liberada.
• Não agenda visita técnica, não abre chamado técnico, não reinicia nem reseta a ONU, não derruba a conexão e não faz liberação em confiança nesse contrato. Essas ações são recusadas antes de chegar ao IXC.
• Não recebe o link de assinatura do contrato: ele é pessoal do titular e só aparece para o próprio assinante, no app da sua empresa (veja O que o assinante resolve no app).

Vale tanto para o contrato ativo que espera assinatura quanto para a venda nova (pré-contrato) que ainda não foi assinada. A venda nova só entra na lista de contratos do cliente quando ele não tem outro contrato ativo. Em Contatos, o cliente com contrato ativo aguardando assinatura aparece como Cliente, bloqueado.

Veja também

• Ferramentas nativas: as tools de IXC que o agente usa em runtime
• Agenda: onde as visitas agendadas aparecem
• Status e diagnóstico