Integração VoIP - VSC
Introdução
A VSC (VoIP SoftSwitch) é uma plataforma de software avançada para gerenciamento de redes de telefonia VoIP, oferecendo controle centralizado de chamadas, flexibilidade e escalabilidade.
A integração do sistema com VoIP VSC estabelece uma comunicação eficiente utilizando a tecnologia Voice over Internet Protocol (VoIP). A integração otimiza a infraestrutura de comunicação, reduzindo custos e aumentando a flexibilidade dos serviços de voz. Ao aproveitar as redes de dados existentes para tráfego de voz, a integração VoIP VSC oferece uma alternativa eficiente às soluções de telefonia tradicionais, permitindo a gestão de recursos avançados de comunicação e melhor gerenciamento de chamadas diretamente pelo sistema IXC Soft.
Caminho: Configurações > Integrações VOIP > VSC
Requisitos de Uso
A contratação de um módulo é necessária para a liberação da integração no sistema IXC. Para realizar a contratação do módulo, entre em contato conosco mediante um atendimento direcionado ao departamento Administrativo Financeiro.
Entrega de Valor
- Diversificação do portfólio de serviços;
- Melhoria na retenção de clientes;
- Gerenciamento centralizado em um único local;
- Oferta de soluções de comunicação completas.
Configuração da Integração
Cadastro da Integração
Neste passo, é efetuado o cadastro da integração. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma VSC. Esse processo é essencial para disponibilizar recursos como: criação de range de números, ativação de ramal SIP, geração do serviço adicional de telefonia, entre outras. Para realizar o cadastro da integração, siga os passos a seguir:
Acesse o formulário Integrações de Telefonia Fixa - VoIP através do caminho: Configurações > Integrações > Integrações VoIP;
Pressione o botão Novo para registrar os dados API da integração;
No campo Descrição, insira uma breve descrição para a identificação da plataforma;
Marque o campo Ativo para definir a integração como ativa, e em uso;
No campo Gateway, selecione a opção VSC;
Insira as informações fornecidas pela VSC nos campos:
Período de Importação CDR: Define a frequência de importação dos registros de chamadas, podendo ser diária ou mensal;
Gerar adicional de telefonia excedente:
- Por tempo de ligação: ao trabalhar com a cobrança de excedentes, é possível realizar a cobrança através do valor da franquia em minutos. Para realizar este processo, marque este parâmetro;
- Por ligação: na modalidade por ligação, as chamadas são importadas com os valores previamente definidos na VSC, gerando um serviço adicional exclusivo para os excedentes. Para realizar a cobrança nesta modalidade, marque este parâmetro.
URL de Acesso: Insira a URL do serviço que será acessado para realizar a integração;
Distri ID: Informe o identificador único fornecido pela VSC;
Distri Password: Insira a senha correspondente ao ID fornecido pela VSC;
Usuário de Acesso: Informe o nome de usuário utilizado para autenticação no sistema;
Senha de Acesso: Insira a senha correspondente ao usuário informado;
Rota WS Ligações VSC: insira o caminho da rota do serviço web utilizado para a integração com a VSC.
Comportamento do bloqueio parcial: Este parâmetro consiste em definir o tipo de consumo que o ramal SIP terá em casos de bloqueio parcial, isto é, quando houver alteração do contrato para o status Financeiro em atraso. Ao selecionar Somente receber chamadas, o ramal SIP permanece ativo sem poder realizar ligações. Ao selecionar Manter ramal ativo, o ramal permanece totalmente habilitado (realiza e recebe chamadas).
Comportamento do bloqueio total: Este parâmetro define o comportamento do ramal ao haver bloqueio total do contrato. Ao selecionar Permitir somente chamadas recebidas, o ramal se mantém ativo para receber chamadas. Ao selecionar Desativar totalmente o ramal, a linha será desabilitada, isto é, não realiza e nem recebe chamadas.
Clique em Salvar para validar a criação da integração e concluir o cadastro;
Por padrão do sistema, os parâmetros já possuem uma configuração pré-definida. Os comportamentos abaixo representam esse padrão e podem ser alterados conforme a preferência do usuário.
- Comportamento do bloqueio parcial: Somente receber chamadas
- Comportamento do bloqueio total: Desativar totalmente o ramal
Após salvar o cadastro da integração, a alteração do campo Gateway é desabilitada permanentemente. Você só poderá editar a descrição e as credenciais da API.
Todos os dados de integração são fornecidos pela plataforma VSC.
Após concluir o cadastro da integração com a plataforma VSC, é possível avançar para as demais configurações, ajustando-as conforme as necessidades e métodos de trabalho da empresa. Essas configurações permitem uma gestão eficiente dos serviços e recursos fornecidos pela operadora, incluindo funcionalidades importantes como: cadastro de range de números para o controle de números fornecidos pela operadora, cadastro de produto de telefonia fixa, ativação do ramal SIP, geração do adicional de telefonia e importação das ligações.
Essas configurações são essenciais para aproveitar ao máximo os recursos da integração, assegurando um gerenciamento eficiente, centralizado e alinhado às demandas operacionais. Ajuste cada etapa conforme os requisitos específicos de sua operação para otimizar os serviços prestados aos clientes.
Casos de Uso
Os casos de uso apresentados neste documento são ferramentas e recursos que se tornam disponíveis a partir do cadastro da integração VoIP. Cada funcionalidade foi projetada para oferecer maior controle, flexibilidade e eficiência na gestão dos serviços de telefonia, permitindo que sua operação atenda às necessidades específicas da empresa e de seus clientes.
É importante que você avalie cuidadosamente o seu método de trabalho e os objetivos da sua operação para determinar a melhor forma de utilizar estes recursos. Considere as seguintes diretrizes ao planejar o uso das ferramentas:
1. Configuração de Perfil VoIP - VSC
O Perfil VoIP permite a definição de parâmetros específicos para cada ramal a partir de uma configuração padrão. Essa função tem como objetivo padronizar as configurações dos ramais, para que, ao realizar a criação do ramal SIP no sistema, seja possível inserir um perfil padrão pré-estabelecido, com as informações pré definidas das configurações do ramal.
Para realizar o cadastro do perfil, siga os passos:
Acesse o formulário de Configuração para Criação de Ramal (Perfil VoIP) através do caminho: Sistema > Plataforma VoIP > Configurações > Configuração para Criação de Ramal;
Selecione o botão Novo;
Preencha o campo de Nome para a identificação do perfil;
No campo Gateway, selecione a opção VSC;
Preencha os demais campos dinâmicos, descritos a seguir, que são liberados ao selecionar o gateway:
- Allow Collect Calls: marcar caso queira permitir coletar as chamadas;
- Remove Country Code: marcar caso queira remover o código do país (DDI);
- IDD Prefix: insira o prefixo para discagem direta internacional;
- NDD Prefix: insira o prefixo para discagem direta nacional;
- Inbound Calls Limit: neste campo poderá definir a quantidade de chamadas entrantes;
- Outbound Calls Limit: neste campo poderá definir a quantidade de chamadas saintes;
- User code: campo opcional. Ao clicar no botão Listar, pode selecionar um número de binagem previamente cadastrado através da Range de Números Cadastrados. Caso não preencher este campo, será preenchido automaticamente com o ID do ramal na plataforma da VSC;
- Billing: método de faturamento aplicado ao ramal.
- Recharge Settings: configuração de recarga automática: Sim ou Não;
- Dia da Recarga Padrão: dia fixo para a recarga automática.
Após finalizar o preenchimento dos campos que julgar necessário, clique em Salvar para validar e finalizar a criação do perfil VoIP.
2. Criação de Range de Números Cadastrados
A range de números pode ser utilizada para realizar o controle dos números fornecidos pela operadora. A partir do uso da Range de Números, o sistema apresenta todos os números do período e seus respectivos status de uso, se Disponível ou se Em uso, facilitando a organização de disponibilidade de números aos clientes.
Caso opte por não trabalhar com Range de Números, não será possível realizar o controle de status de números pelo sistema.
Acesse o formulário de Range de Números Cadastrados através do caminho: Sistema > Plataforma VoIP > Configurações > Range de números cadastrados;
. Clique sobre o botão Novo e preencha os campos conforme apresentados:
- Nome: descrição da range, facilitando sua localização e organização;
- DDI + DDD: defina o DDI e o DDD padrão dos números de telefonia fixa;
- Numeração inicial: insira o número inicial da numeração da range, determinando o início do período;
- Numeração final: insira o número final da numeração da range, determinando o final do período;
- Cancelamento automático VSC: Campo específico para uso da integração VSC. Preencha a quantidade de dias de inativação do número após o cancelamento do contrato.
Clique em Salvar para validar e finalizar a criação da range.
3. Criação de Ramal SIP - VSC
O cadastro do Ramal SIP no sistema consiste na criação de uma linha telefônica, definindo suas características e limitações específicas para uso do cliente. Essa configuração personalizada assegura que a linha telefônica atenda às necessidades do cliente e às políticas de serviço do provedor, otimizando o controle e a gestão do serviço de telefonia VoIP.
3.1 Cadastro da Tarefa - Importar Batches VSC
A tarefa Importar Batches VSC é uma funcionalidade para empresas que utilizam a Integração VoIP - VSC, de telefonia fixa, no sistema. Esta tarefa permite realizar a importação dos Batches (planos) para criação de Ramal SIP no sistema. Para realizar a configuração da tarefa, siga os passos abaixo:
Os batches devem ser criados na plataforma da VSC para que posteriormente sejam importados ao IXC. Em caso de dúvidas relacionadas à geração dos batches na plataforma, entre em contato com o suporte da VSC.
- Acesse o formulário de Agenda de Tarefas através do caminho: Ferramentas > Ferramentas > Agenda de tarefas;
- Clique no botão Novo para cadastrar a tarefa;
- No campo Tarefa, selecione a opção Importar Batches VSC;
- Preencha o horário em que a tarefa executará a partir dos campos de Minuto e Hora. No campo Minuto, indique o minuto em que a tarefa executará, correlacionando ao campo de hora. No campo Hora, indique o horário em que a tarefa executará;
Para que uma tarefa execute as 7h30, insira o número 7 no campo Hora e o número 30 no campo Minuto.
- Na seção Dia do mês, insira no campo Valor o intervalo que desejar para que o sistema execute a tarefa em dias específicos. Marque a opção Todos para a tarefa executar todos os dias do mês (irá respeitar o intervalo de semana caso não deva executar todos os dias);
- Na seção Mês, marque a opção Todos para a tarefa executar todos os meses;
- Na seção Dia da semana, insira no campo Valor o intervalo que desejar, indicando que a tarefa irá executar em dias específicos. Exemplo: 1-5 (segunda à sexta-feira). Para que o sistema execute a tarefa todos os dias da semana, marque a opção Todos;
- Após preencher os campos, clique em Salvar para validar a criação da tarefa.
- Selecione a tarefa e clique no botão Executar tarefa para iniciar a importação dos planos para o sistema.
3.2 Cadastro do Ramal SIP
A partir do cadastro e execução da Tarefa - Importar Batches VSC, é possível prosseguir com a ativação da linha com os planos importados. Para criar uma linha SIP utilizando a Integração VoIP - VSC, siga os passos a seguir:
Acesse o formulário Aba Linha SIP - Contrato do Cliente através do caminho: Sistema > Cadastros > Contratos > Aba Linha SIP;
Na aba Linha SIP, clique no botão Novo;
Preencha o campo Plano de Cobrança caso trabalhe com cobrança por consumo ou cobrança de excedentes;
No campo Integração, clique na lupa e selecione a integração de VoIP da plataforma VSC;
Preencha os demais campos:
- Tipo linha SIP: defina se o ramal será uma portabilidade ou não, caso seja portabilidade utilize a opção Portabilidade Entrada;
- Senha: clique no botão Gerar senha para gerar uma senha ao Ramal;
- Perfil VoIP: selecione um Perfil VoIP - VSC previamente configurado, para que a aba Configuração VSC seja preenchida automaticamente;
- Ativo: filtro para habilitar a ativação do Ramal ou para inativá-lo.
Acesse a aba Configurações adicionais e no campo Use Area Code, defina se o uso do código de área é obrigatório para todas as ligações;
Acesse a aba Configuração VSC e preencha os demais campos apresentados (caso não utilize o Perfil VoIP - VSC):
- ID Batch: preenchido automaticamente ao selecionar o plano do ramal;
- Batch: clique no botão Buscar batch para selecionar o plano do ramal;
- Allow Collect Calls: marcar caso queira permitir coletar as chamadas;
- Permite logar com IP: define se o ramal poderá autenticar com o IP. Marcar caso queira permitir que o cliente logue com IP;
- Habilitar IVR: habilita a funcionalidade de IVR. Marcar caso queira permitir que o cliente tenha acesso a esta funcionalidade;
- Remove Country Code: marcar caso queira remover o código do país (DDI);
- DDI: insira o código de discagem direta internacional (DDI), isto é, o código utilizado para fazer ligações para outros países;
- DDD: insira o código de discagem direta à distância, isto é, o código para discagem interurbana regional;
- IDD Prefix: insira o prefixo para discagem direta internacional;
- NDD Prefix: insira o prefixo para discagem direta nacional;
- Inbound Calls Limit: neste campo poderá definir a quantidade de chamadas entrantes;
- Outbound Calls Limit: neste campo poderá definir a quantidade de chamadas saintes;
- User code: campo opcional. Ao clicar no botão Listar, pode selecionar um número de binagem previamente cadastrado através da Range de Números Cadastrados. Caso não preencher este campo, será preenchido automaticamente com o ID do ramal na plataforma da VSC;
- Billing: método de faturamento aplicado ao ramal.
- Recharge Settings: configuração de recarga automática: Sim ou Não;
- Dia da Recarga Padrão: dia fixo para a recarga automática.
Acesse a aba DIDs para cadastrar um DID ao ramal SIP. Clique no botão Novo e preencha o campo:
- Número de binagem: através do campo Número de binagem, define-se o número do cliente. Clique no botão Listar para relacionar um número ao cliente;
- Cidade: campo preenchido automaticamente.
Clique em Salvar para validar a criação do ramal SIP.
Os campos Permite logar com IP e Habilitar IVR só são aplicados à plataforma quando você edita a linha SIP. Isso ocorre devido a uma regra específica da plataforma VSC.
Após salvar a linha, ela já estará ativa. Os dados são então sincronizados simultaneamente no sistema e na plataforma VSC, portanto, a linha coexiste em ambos os sistemas a partir da comunicação estabelecida pela integração.
4. Cadastro da Tarefa - Importar Ligações VSC
Ao trabalhar com a importação de ligações e cobrança de excedentes, é necessário realizar o cadastro da tarefa de importação de ligações para a integração VoIP VSC. Para realizar este procedimento, siga os passos a seguir:
A rotina deve ser configurada de acordo com a forma de importação definida dentro da integração.
- Caso a importação seja mensal, a rotina precisa ser executada apenas 1 vez no mês;
- Caso a rotina seja diária, a rotina precisa ser executada todos os dias.
- Acesse o formulário de Agenda de tarefas através do caminho: Ferramentas > Ferramentas > Agenda de tarefas;
- Clique no botão Novo para cadastrar a tarefa;
- No campo Tarefa, selecione a opção Importar ligações VSC;
- Preencha o horário em que a tarefa executará a partir dos campos de Minuto e Hora. No campo Minuto, indique o minuto em que a tarefa executará, correlacionando ao campo de hora. No campo Hora, indique o horário em que a tarefa executará;
Para que uma tarefa execute as 7h30, insira o número 7 no campo Hora e o número 30 no campo Minuto.
- Na seção Dia do mês, insira no campo Valor o intervalo que desejar para que o sistema execute a tarefa em dias específicos. Marque a opção Todos para a tarefa executar todos os dias do mês (irá respeitar o intervalo de semana caso não deva executar todos os dias);
- Na seção Mês, marque a opção Todos para a tarefa executar todos os meses;
- Na seção Dia da semana, insira no campo Valor o intervalo que desejar, indicando que a tarefa irá executar em dias específicos. Exemplo: 1-5 (segunda à sexta-feira). Para que o sistema execute a tarefa todos os dias da semana, marque a opção Todos;
- Após preencher os campos, clique em Salvar para validar a criação da tarefa.
Para a importação mensal, o sistema considerará o dia da semana em que o dia do mês selecionado ocorrer. Exemplo: caso selecione o dia 1 do mês e marcar Todos para o dia da semana, a tarefa ocorrerá no dia 1 de cada mês, independentemente de ser uma segunda-feira, terça-feira, etc.
Após a configuração da tarefa, ela seguirá executando automaticamente e irá identificar os clientes que possuem ligações a serem importadas e as registra no Registro de Chamadas (CDR), no módulo de Plataforma VoIP.
5. Geração do Serviço Adicional de Telefonia
O sistema permite realizar a geração de um serviço adicional no contrato do cliente ao trabalhar com a cobrança dos valores excedentes de ligações efetuadas fora do plano de telefonia contratado.
Para acessar o material sobre como realizar a geração do adicional de telefonia, acesse os materiais disponíveis:
6. Cancelamento de Contrato e Ramal SIP
Ao realizar o cancelamento de um contrato que possui serviços de telefonia VoIP vinculados, o sistema inativa automaticamente o ramal SIP associado. Essa ação ocorre tanto em cancelamentos manuais quanto em cancelamentos automáticos por inadimplência.
Cancelamento automático:
- O provedor possui a parametrização ativa para cancelamento automático de contratos inadimplentes
- Ao atingir o número de dias de atraso definido na configuração, o sistema identifica o contrato como inadimplente
- O contrato é cancelado automaticamente
- Se existir um ramal SIP vinculado ao contrato, o sistema localiza a associação e realiza a inativação automática do ramal no momento do cancelamento
Para saber como configurar o cancelamento automático de contratos, acesse: Cancelamento Automático de Contrato Inadimplente
Cancelamento manual:
- O provedor solicita o cancelamento do contrato através do caminho: Sistema > Cadastros > Contratos > Status > Cancelar contrato / Cancelar contrato e gerar financeiro remanescente / Cancelar contrato e financeiro / Cancelar contrato e financeiro não vencido
- O contrato é cancelado através da ação manual
- Se existir um ramal SIP vinculado ao contrato, o sistema localiza a associação e realiza a inativação automática do ramal no momento do cancelamento.
Funcionalidades Principais
- Estabelece a comunicação entre o sistema e a plataforma VSC, permitindo o gerenciamento do módulo de telefonia diretamente pelo sistema IXC. Este processo permite a sincronização de configurações entre VSC e o sistema;
- Criação e gerenciamento de ramais SIP;
- Controle de contrato de internet e telefonia pelo IXC;
- Controle de acesso das linhas/Ramais SIP pelo IXC;
- Integração com planos e grupos do VSC;
- Definição de limites de crédito por ramal.
Fluxo de Trabalho
Considerações Finais
A integração VOIP VSC oferece uma solução robusta para unificar a telefonia IP com o Sistema. Ao configurar corretamente os perfis e ramais, é possível aproveitar todos os recursos de VOIP do VSC de forma integrada.