Central de Ajuda › Primeiros passos
Como integrar o IXC Soft com a NuvoTrack
Provedor que usa IXC Soft: a NuvoTrack lê a sua base de assinantes pela API do IXC e cria os clientes no seu painel de rastreamento, com o CPF/CNPJ como login.
Se você é provedor e usa o IXC Soft, a NuvoTrack consegue ler a sua base de assinantes pela API do IXC e criar esses assinantes como clientes no seu painel de rastreamento. Assim você não precisa recadastrar ninguém à mão: quem já é seu cliente de internet ganha o acesso ao rastreamento com o CPF ou CNPJ como login.
A integração é feita do lado da NuvoTrack, lendo o IXC. Por isso, se você perguntar ao suporte do IXC, é normal ouvir que "não existe integração pronta" do lado deles: o IXC não precisa instalar nada, só liberar o acesso à API.
O que a integração faz
- Importa os seus assinantes ativos do IXC como clientes no seu painel NuvoTrack. O login de cada um é o CPF/CNPJ e a senha de primeiro acesso é a que você escolher (o cliente troca no primeiro acesso).
- Mantém sincronizado, se você quiser: assinantes novos no IXC entram no painel automaticamente.
- Respeita o seu escopo: você decide se importamos toda a base ativa, só os clientes cadastrados a partir de uma data, ou nenhum (criando o acesso só de quem contratar o rastreamento).
Os clientes criados ficam na sua conta, debaixo da sua marca. Nada fica visível para outra revenda.
O que você precisa ter em mãos
- O endereço do seu IXC, por exemplo
https://ixc.suaempresa.com.br. - Um token da API do IXC. No IXC, vá em Configurações → Usuários → API / Webservice e gere o token. Ele vem no formato
21:a1b2c3…: o número antes dos dois-pontos é o usuário da API, e o texto depois é o token. - Permissão de consulta para esse usuário da API nos webservices
cliente,cliente_contrato,fn_arecebereradusuarios. Sem a permissão, o IXC responde "não autorizado" mesmo com o token certo. - A senha de primeiro acesso dos seus clientes. Ela precisa ter pelo menos uma letra maiúscula (por exemplo
Suaempresa@123).
Como cadastrar a integração no portal
- Acesse o portal do revendedor em https://www.nuvotrack.com.br/portal e entre com o seu login.
- Abra a aba Integrações.
- Em Sistema ERP, escolha IXC Soft.
- Em URL da API, informe o endereço do seu IXC.
- Em Usuário da API, informe o número antes dos dois-pontos do token (por exemplo
21). - Em Token / Senha da API, informe só o texto depois dos dois-pontos.
- Clique em Salvar e depois em Testar Conexão. Com o teste certo, o portal mostra quantos clientes encontrou no seu IXC.
Depois do teste: a importação
Com a conexão testada, avise o suporte NuvoTrack pelo WhatsApp e informe:
- qual base importar (toda a base ativa, a partir de uma data, ou nenhuma);
- a senha de primeiro acesso;
- se quer a sincronização automática de clientes novos.
A nossa equipe faz a importação e confere o resultado no seu painel. A importação automática pelo botão Importar Clientes do ERP do portal hoje funciona só para o SGP. Para o IXC, quem importa é a nossa equipe.
Boas práticas
- Não mande o token por grupo de WhatsApp. O token dá acesso à sua base de clientes. Cadastre direto no portal.
- Se você trocar ou revogar o token no IXC, cadastre o novo no portal e teste de novo. Com o token antigo, a sincronização para.
- Prefira um usuário de API só para a NuvoTrack, com permissão apenas de consulta.
Perguntas frequentes
A NuvoTrack tem integração com o IXC Soft?
Sim. A integração é feita do lado da NuvoTrack, lendo a API do IXC: importamos os seus assinantes ativos como clientes do seu painel de rastreamento e, se você quiser, mantemos sincronizado. Por isso o suporte do IXC pode dizer que não há integração pronta do lado dele: o IXC só precisa liberar o acesso à API.
O que eu preciso pedir no IXC?
Um token da API (Configurações → Usuários → API / Webservice), no formato número:texto, com permissão de consulta nos webservices cliente, cliente_contrato, fn_areceber e radusuarios.
Onde eu cadastro o token?
No portal do revendedor (nuvotrack.com.br/portal), aba Integrações, escolhendo IXC Soft. O número antes dos dois-pontos vai em Usuário da API e o texto depois vai em Token. Depois clique em Testar Conexão.
A importação é automática?
Para o IXC, a importação é feita pela nossa equipe depois que a conexão é testada. Você decide o escopo: toda a base ativa, a partir de uma data, ou só os clientes que contratarem o rastreamento.
O cliente é bloqueado no rastreamento quando fica inadimplente no IXC?
Hoje não de forma automática para o IXC. Se precisar dessa regra, fale com o suporte para avaliarmos o seu caso.
