Integração do IXC ACS com IXC Provedor

Introdução

A integração entre o IXC ACS e o IXC Provedor permite que os dois sistemas se comuniquem automaticamente, mantendo dados sincronizados e reduzindo atividades manuais. Com essa integração ativa, o gerenciamento de dispositivos se torna mais centralizado, confiável e eficiente.

Por meio desse vínculo, informações como dispositivos, status e associação com logins de clientes passam a ser compartilhadas entre as plataformas, apoiando a automação de tarefas operacionais do dia a dia.

Objetivo da integração

Estabelecer uma comunicação bidirecional entre o IXC ACS e o IXC Provedor para sincronização de dados e controle centralizado dos dispositivos.

Entrega de valor

A integração do IXC ACS com o IXC Provedor oferece benefícios diretos para a operação:

Redução de custos operacionais
Menor necessidade de ações manuais
Gestão mais eficiente dos dispositivos
Maior confiabilidade das informações
Automação de processos repetitivos
Centralização do monitoramento da rede

Passo a passo da integração:

A integração é realizada em duas etapas principais, envolvendo configurações no IXC Provedor e no IXC ACS.

No IXC Provedor

Configure o Cliente API
Clique aqui para saber como configurar
Copie as informações de Client ID e Client Secret
- Esses dados ficam disponíveis no menu Integrações
- Eles serão utilizados para autenticar o IXC ACS no IXC Provedor

No IXC ACS

Acesse Menu Ferramentas > Integrações com sistemas e clique em Nova integração
Habilite a integração
Informe a URL do seu IXC Provedor
No campo Client ID, cole o valor copiado do IXC Provedor
No campo Client Secret, cole o valor correspondente e clique em Salvar
Após salvar, clique em Sincronizar para iniciar a troca de dados entre os sistemas

Como funciona a sincronização

O processo de sincronização segue algumas regras importantes:

Quando a sincronização é executada pelo IXC ACS, o sistema consulta o IXC Provedor e recebe apenas os dispositivos que possuem login vinculado e ativo.
Quando um novo dispositivo é adicionado ao ACS, seus dados são enviados ao IXC Provedor. Caso seja possível, o Provedor retorna o login vinculado a esse dispositivo.
Quando um dispositivo é excluído manualmente no ACS, o ACS envia um webhook ao IXC Provedor para que o dispositivo também seja removido da integração do lado deles. Nesse caso, o dispositivo deixa de ser contabilizado na integração em ambos os sistemas.
Quando ocorre a exclusão em massa de dispositivos no ACS, conforme os critérios definidos nas configurações do servidor, os dados de integração desses dispositivos são removidos apenas no ACS. Nessa situação, nenhum webhook é enviado ao IXC Provedor. A remoção dos dispositivos no lado do Provedor não acontece automaticamente e só será realizada quando o próprio provedor executar o processo de sincronização.
O IXC ACS executa uma rotina automática de sincronização diariamente durante a madrugada, validando dispositivos atualizados ou novos dispositivos que possuam login vinculado. Essa rotina tem o mesmo comportamento da sincronização manual.

Verificação da integração

Para verificar se a integração está funcionando corretamente:

Acesse a integração no IXC ACS e clique em Sincronizar
O retorno indicará apenas os dispositivos com login ativo e vinculado no IXC Provedor

Diferenças nos números de dispositivos entre os sistemas podem ocorrer conforme explicado nas regras de sincronização.

Funcionalidades habilitadas pela integração

Com a integração ativa, os seguintes recursos ficam disponíveis:

Sincronização automática de dispositivos entre IXC ACS e IXC Provedor
Comunicação bidirecional entre os sistemas
Uso do speedtest com informações do plano contratado
- Ao realizar um speedtest, o ACS consulta o IXC Provedor e exibe a banda contratada do cliente, permitindo comparar com a velocidade entregue.
Pesquisa de dispositivo
É possível realizar a pesquisa de dispositivos utilizando o CPF, a razão social ou o telefone do cliente, desde que esses dados estejam vinculados ao dispositivo no IXC Provedor.

Dúvidas frequentes:

🔥

Por que o número de dispositivos sincronizados é diferente entre o ACS e o IXC Provedor?
Isso pode acontecer quando:
Dispositivos foram excluídos manualmente no ACS
Foi executada a rotina de exclusão em massa no ACS e a sincronização ainda não rodou no IXC Provedor
Existem dispositivos sem login vinculado
Por que a integração não está funcionando ou apresenta erro ao sincronizar?
Algumas causas comuns:
Client ID, Client Secret ou chave pública incorretos ou com espaços adicionais
URL do IXC Provedor informada incorretamente
Problemas de rede entre os sistemas
Se o erro persistir, é recomendado acionar o suporte para validação.

Considerações finais

A integração entre o IXC ACS e o IXC Provedor é fundamental para um gerenciamento mais eficiente e automatizado da rede. Quando configurada corretamente, ela reduz erros manuais, melhora a visibilidade dos dispositivos e garante maior confiabilidade operacional. Manter as configurações revisadas e acompanhar as sincronizações ajuda a garantir que a integração continue atendendo às necessidades do provedor.