Integração VoIP - Tysa

Introdução

Tysa

A Tysa é uma empresa brasileira especializada em soluções para telecomunicações, oferecendo uma plataforma VoIP que possibilita a prestação de serviços de telefonia fixa. O sistema oferece controle centralizado de chamadas, flexibilidade operacional e escalabilidade, permitindo uma gestão eficiente das comunicações telefônicas.

A integração do sistema com VoIP Tysa 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 Tysa 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.

  • VoIP: o termo Voice over Internet Protocol define uma tecnologia que permite a transmissão de chamadas de voz pela internet ou por redes de dados baseadas em IP, em vez de utilizar linhas telefônicas tradicionais.

Acesso à Configuração

Caminho: Configurações > Integrações VOIP > Tysa

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

  • Centralização de Dados e Processos: Integra a telefonia fixa ao ERP, unificando informações de clientes, serviços e faturamento em um único sistema, facilitando a gestão de dados.
  • Diversificação do Portfólio de Serviços: Expande as opções de serviços, permitindo que as empresas ofereçam pacotes combinados de internet e telefonia fixa.
  • Faturamento Integrado: Facilita o faturamento conjunto dos serviços de internet e telefonia fixa, simplificando o processo financeiro e garantindo maior precisão.
  • Análise Abrangente do Negócio: Oferece uma visão completa do desempenho do negócio, incluindo métricas detalhadas de telefonia e gestão contratual, o que auxilia na tomada de decisões mais informadas.
  • Controle de Uso e Relatórios de Ligações: Possibilita a emissão de relatórios detalhados sobre as ligações realizadas, proporcionando maior controle e monitoramento do uso do serviço de telefonia.

Configuração da Integração

Passo 1: 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 Tysa. 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:

  1. Acesse o formulário Integrações de Telefonia Fixa - VoIP através do caminho: Configurações > Integrações > Integrações VoIP;
  2. Pressione o botão Novo para registrar os dados API da integração;
  3. No campo Descrição, insira uma breve descrição para a identificação da plataforma;
  4. No campo Gateway, selecione a opção Tysa;
  5. Marque o campo Ativo para definir a integração como ativa, e em uso;
  6. Insira as informações fornecidas pela Tysa 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;
    • URL acesso: Insira a URL serviço que será acessado para realizar a integração;
    • Usuário acesso: Insira o usuário API fornecido pela plataforma Tysa para estabelecer a comunicação com a plataforma;
    • Senha acesso Insira a senha de acesso (senha API) fornecida pela plataforma Tysa para estabelecer a comunicação com a plataforma.
  7. Clique em Salvar para validar a criação da integração e concluir o cadastro;

Credenciais:

Todos os dados de integração são fornecidos pela plataforma Tysa.

Finalização:

Após concluir o cadastro da integração com a plataforma Tysa, é 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

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

Atenção:

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.

  1. Acesse o formulário de Range de Números Cadastrados através do caminho: Sistema > Plataforma VoIP > Configurações > Range de números cadastrados;
  2. . 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 Tysa: Campo específico para uso da integração Tysa. Preencha a quantidade de dias de inativação do número após o cancelamento do contrato.
  3. Clique em Salvar para validar e finalizar a criação da range.

2. Como Configurar Tarifação - Telefonia VoIP Tysa

A configuração de tarifação na plataforma Tysa tem como objetivo possibilitar o cálculo e a aplicação de tarifas às chamadas realizadas pelos usuários. Nesse processo, as ligações são importadas para o sistema, que analisa os dados com base no plano de cobrança e nas tarifas previamente configuradas. Isso permite que os custos das chamadas excedentes sejam devidamente contabilizados, garantindo a cobrança correta e a geração do adicional de telefonia, otimizando o controle financeiro e a gestão dos serviços prestados. Siga os passos a seguir para aplicar esta configuração:

Passo 1: Configuração de um Produto de Telefonia

Realize o cadastro de um produto de telefonia para vinculá-lo no plano de cobrança. Este produto será ilustrativo para ser utilizado como base no serviço adicional, portanto, não é necessário configurá-lo com valor. Siga os passos a seguir:

  1. Acesse o formulário de Cadastro de Produtos através do caminho: Sistema > Cadastro > Produtos;
  2. Clique no botão Novo;
  3. Na aba Produtos e na aba Planejamento, preencha os campos obrigatórios;
  4. Clique em Salvar para concluir a configuração do produto.

Passo 2: Configuração de Plano de cobrança - VoIP e Tarifas - VoIP

Com o produto cadastrado, é necessário relacioná-lo ao plano de cobrança para então realizar a geração do adicional de telefonia. Siga os passos a seguir:

  1. Acesse o formulário e Plano de cobrança - VoIP através do caminho: Sistema > Plataforma VoIP > Tarifação > Plano de tarifas;
  2. Clique no botão Novo;
  3. Preencha os campos:
    • Nome: insira um nome de identificação para o Plano de Cobrança;
    • Produto ligações: clique na lupa e selecione o produto de telefonia cadastrado;
  4. Clique em Salvar para registrar o cadastro do plano de cobrança;
  5. Direcione-se à seção Franquia, preencha o campo Produto Franquia com o mesmo produto inserido no campo Produto ligações;
  6. No campo Tarifa franquia, clique sobre a lupa e clique no botão Novo para cadastrar a tarifa da franquia;
  7. No formulário de Tarifas - VoIP, preencha os campos:
    • Plano de tarifas: preencha o campo com o plano de cobrança que está cadastrando;
    • Tipo de chamada: clique sobre o botão de seleção e indique o tipo de chamada que deseja configurar a tarifação. Os tipos de chamadas disponíveis são LDN, local, interno, VC1, VC2, VC3;
    • Franquia em segundos: insira a quantidade de minutos mensais dos quais este tipo de chamada terá. Ao cliente que exceder esta quantidade, o valor é cobrado pelo excedente. Este valor é definido pela plataforma Tysa.
  8. Clique em Salvar para concluir o cadastro da Tarifa;
  9. Retornando ao formulário de Plano de cobrança, insira a tarifa cadastrada no campo Tarifa franquia. Clique sobre a lupa e selecione a tarifa.
  10. Clique em Salvar para concluir o cadastro do Plano de Cobrança relacionado à Tarifas.

Ramal SIP:

Com o plano de cobrança devidamente configurado, poderá ser vinculado ao Ramal no ato de criação ou para atualizar este dado, através do caminho: Sistema > Plataforma VoIP > Ramais > Ramal SIP X Clientes > Novo/Editar > campo Plano de Cobrança.

Com o ramal ativo e o plano de cobrança relacionado, a Geração do Adicional de Telefonia - Filtros VoIP pode ser efetuada.

Guia instrutivo:

Para mais informações do processo de configuração de tarifação para a plataforma Tysa, acesse: Como Configurar Tarifação - Telefonia VoIP Tysa

3. Criação de Ramal SIP - Tysa

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. Para criar uma linha SIP utilizando a Integração VoIP - Tysa, siga os passos a seguir:

  1. Acesse o formulário Aba Linha SIP - Contrato do Cliente através do caminho: Sistema > Cadastros > Contratos > Aba Linha SIP;
  2. Na aba Linha SIP, clique no botão Novo;
  3. Preencha o campo Plano de Cobrança caso trabalhe com cobrança por consumo ou cobrança de excedentes;
  4. No campo Integração, clique na lupa e selecione a integração de VoIP da plataforma Tysa;
  5. Preencha os demais campos:
    • Descrição: campo de preenchimento opcional, permite inserir uma breve descrição para o ramal
    • Número para binagem: clique no botão Listar para selecionar um número de binagem da Range de Números Cadastrados ou insira manualmente;
    • Senha: clique no botão Gerar senha para gerar uma senha ao Ramal;
    • Ativo: filtro para habilitar a ativação do Ramal ou para inativá-lo.
  6. Acesse a aba Tysa para definir configurações adicionais do Ramal SIP. Preencha os campos:
    • Tipo de conta SIP: defina se é uma linha comum clicando na opção Normal ou se é um tronco SIP, clicando na opção Tronco SIP;
    • Tipo de endereçamento: defina se o endereçamento é Estático ou Dinâmico;
    • Status da linha: campo focado em definir o status da linha, entre as opções: Cancelado, Bloqueado (Total), Bloqueio parcial ou Ativo;
    • Limite de chamadas: defina o limite de chamadas da linha;
    • Endereço de IP: insira o endereço de IP utilizado pela linha, caso necessário;
    • Função da linha: defina a função da linha, entre as opções: Comum, Tronco chave ou DDR.
  7. Clique em Salvar para validar a criação do ramal SIP.

Ativação:

Após salvar a linha, ela já estará ativa. Os dados são então sincronizados simultaneamente no sistema e na plataforma Tysa, portanto, a linha coexiste em ambos os sistemas a partir da comunicação estabelecida pela integração.

4. Cadastro da Tarefa - Importar CDR Tysa

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 Tysa. Para realizar este procedimento, siga os passos a seguir:

Atenção: 

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.
  1. Acesse o formulário de Agenda de tarefas através do caminho: Ferramentas > Ferramentas > Agenda de tarefas;
  2. Clique no botão Novo para cadastrar a tarefa;
  3. No campo Tarefa, selecione a opção Importar CDR Tysa;
  4. 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á;

Exemplo: 

Para que uma tarefa execute as 7h30, insira o número 7 no campo Hora e o número 30 no campo Minuto.

  1. 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);
  2. Na seção Mês, marque a opção Todos para a tarefa executar todos os meses;
  3. 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;
  4. Após preencher os campos, clique em Salvar para validar a criação da tarefa.

Dia da semana: 

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.

Guia instrutivo:

Para acessar o material sobre como realizar a geração do adicional de telefonia, acesse: Geração do Adicional de Telefonia - Filtros VoIP.

Funcionalidades Principais

  • Estabelece a comunicação entre o sistema e a plataforma Tysa, permitindo o gerenciamento do módulo de telefonia diretamente pelo sistema IXC. Este processo permite a sincronização de configurações entre Tysa 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 Tysa;
  • Definição de limites de crédito por ramal.

Fluxo de Trabalho

graph TD
    A[Credenciamento da Plataforma] --> B[Cadastro da Integração no Sistema]
    B --> C[Criação de Range de Números]
    C --> D[Criação de Perfil VoIP]
    D --> E[Ativação de Linhas]
    E --> F[Importar Ligações]
    F --> G[Cadastro de Tarefa]
    G --> H[Faturamento]
    H --> I[Controle de Acesso]

Considerações Finais

A integração VOIP Tysa 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 Tysa de forma integrada.

Etiquetas

Integracoes IntegracaoVoIP IntegracaoVoIPTysa IntegracaoTysa Tysa

Leia Também