# Integração VoIP - Zeus

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

>[!TIP] **VoIP Zeus**
>A plataforma [Zeus](https://www.tipbrasil.com.br/telefonia/) é uma plataforma desenvolvida pela [TIP Brasil](https://www.tipbrasil.com.br/mvno/), focada em soluções para gestão de telefonia fixa. Permite que provedores integrem e gerenciem serviços de telefonia fixa para os clientes.

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

> [!NOTA] **Acesso à Configuração**
> **Caminho:** Configurações > Integrações VOIP > Zeus

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

1. No menu principal, navegue até **Configurações**;
2. Selecione **Integrações**;
3. Clique em **Integrações VOIP**;
4. Pressione o botão **Novo**;
5. No campo **Descrição**, insira uma breve descrição para a identificação da plataforma;
6. Marque o campo **Ativo** para definir a integração como **ativa**, e em uso;
7. No campo **Gateway**, selecione a opção **Zeus**;
8. Insira as informações fornecidas pela Zeus 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;
	- **Forma de Importação Zeus**: Método de importação dos dados no sistema Zeus, podendo ser baseado em faturamento ou registros de chamadas (CDR). Ao definir como faturamento, o sistema realizará a importação das ligações de forma agrupada. Ao definir a importação como CDR, a importação ocorre com o registro individual de chamadas, importando cada chamada, uma a uma;
	- **Dia de Corte**: Data utilizada como referência para cálculo/fechamento de ciclos de faturamento;
	- **IP de Acesso**: Endereço IP utilizado para a conexão/autenticação com o gateway;
	- **Utiliza Período de Importação**: Indica se o período de importação será aplicado. Se Sim, o sistema vai considerar o período da ligação para importar; Se Não, o sistema considerará apenas a data da ligação. (Uma ligação efetuada em 31/10/2024 em que o período de faturamento é 11/2024 pode ser importada em Outubro ou Novembro, de acordo com o parâmetro)
	
9. Clique em **Salvar** para validar a criação da integração e concluir o cadastro;

>[!CAUTION] Credenciais:
>Todos os dados de integração são fornecidos pela plataforma Zeus.

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

## Casos de Uso

### 1. Configuração de [[perfil voip - zeus|Perfil VoIP - Zeus]]
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.

1. Acesse o formulário de [[configuracao para criacao de ramal (perfil voip)|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;
2. Selecione o botão **Novo** para realizar o cadastro de um novo perfil;
3. Preencha o campo de **Nome** para a identificação do perfil;
4. No campo **Gateway**, selecione a opção **Zeus**;
5. Preencha os demais campos dinâmicos apresentados, liberados ao selecionar o gateway:
	- **Integração**: Insira o cadastro da integração com a plataforma Zeus;
	- **Plano Zeus**: Clique no botão **Buscar Plano Zeus** e selecione um plano a ser associado ao ramal neste perfil;
	- **Grupo**: Clique no botão **Buscar grupo** e selecione um grupo a ser associado ao ramal neste perfil;
	- **Vencimento (Zeus)**: Determine uma data de vencimento para o plano;
	- **Limite de Créditos Ex**: Insira o limite de créditos especificado para o perfil;
	- **Tech Prefix**: Defina o prefixo técnico que aplica restrições de chamadas, como impedir chamadas ao atingir o limite de crédito. Escolha entre as opções disponíveis;
	- **Bloquear Ligações VC1 Zeus**: Marque esta opção para ativar o bloqueio de ligações VC1 no sistema Zeus;
	- **Bloquear Ligações a Cobrar Zeus**: Marque esta opção para ativar o bloqueio de ligações a cobrar no sistema Zeus;
	- **Bloquear Ligações LDN Zeus**: Marque esta opção para ativar o bloqueio de ligações LDN (Longa Distância Nacional) no sistema Zeus;
	- **Bloquear Ligações LDI Zeus**: Marque esta opção para ativar o bloqueio de ligações LDI (Longa Distância Internacional) no sistema Zeus;
	- **Não Perturbe**: Defina se o modo **Não Perturbe** está ativado, com as opções "Sim" ou "Não".
	  
7. 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 numeros cadastrados|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.

>[!CAUTION] 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 numeros cadastrados|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 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.
	  
3. Clique em **Salvar** para validar e finalizar a criação da range.


### 3. [[criacao de ramal sip - zeus|Criação de Ramal SIP - Zeus]]
Para realizar o cadastro de um ramal SIP, siga os passos a seguir:

1. Acesse o formulário **[[aba linha sip - contrato do cliente|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 Zeus;
5. Preencha os demais campos:
	- **Bid Type:** defina se o ramal será terminal (integração direta com o usuário final) ou se será trunk (tronco SIP, transmite múltiplas chamadas simultaneamente);
	- **Descrição:** campo opcional. Permite inserir uma breve descrição para o Ramal SIP;
	- **Número para binagem:** insira manualmente o número de binagem ou clique em listar para incluir um número de [[range de numeros cadastrados|Range de Números Cadastrados]]; (Em caso de ramal trunk, os números devem ser inseridos na aba DID)
	- **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 - zeus|Perfil VoIP - Zeus]] previamente configurado, para que a aba **Configuração Zeus** seja preenchida automaticamente;
	- **Ativo:** filtro para habilitar a ativação do Ramal ou para inativá-lo.
	  
6. Acesse a aba **Configuração Zeus** e preencha os demais campos apresentados (caso não utilize o [[perfil voip - zeus|Perfil VoIP - Zeus]]):
	#### **Campos principais**:
	- **Plano Zeus**: Permite buscar e selecionar um plano a ser associado ao perfil, clicando no botão **Buscar Plano Zeus**.
	- **Grupo**: Permite buscar e selecionar um grupo ao qual o ramal será associado, clicando no botão **Buscar grupo**.
	- **Data de Ativação**: Define a data de ativação do serviço ou plano.
	- **Vencimento (Zeus)**: Determina o dia de vencimento do plano ou serviço.
	- **Limite de Créditos Ex (200)**: Define o limite de créditos disponível para o perfil.
	
	#### **Configurações de Tech Prefix**:
	- Permite configurar ações automáticas para diferentes situações, incluindo:
	  - **Não realizar chamadas ao atingir o limite de crédito**.
	  - **Bloquear chamadas em caso de cliente desativado/portado**.
	  - **Bloquear IP do cliente que entrou na blacklist**.
	  - **Bloquear o cliente quando o número de tentativas de chamadas LDI ultrapassa 10 em um ciclo (30 segundos)**.
	  - **Nenhuma ação**.
	
	#### **Opções de Bloqueio**:
	- **Bloquear ligações VC1 Zeus**: Ativa o bloqueio de ligações VC1 no sistema Zeus.
	- **Bloquear ligações a cobrar Zeus**: Ativa o bloqueio de ligações a cobrar no sistema Zeus.
	- **Bloquear ligações LDN Zeus**: Ativa o bloqueio de ligações de Longa Distância Nacional (LDN) no sistema Zeus.
	- **Bloquear ligações LDI Zeus**: Ativa o bloqueio de ligações de Longa Distância Internacional (LDI) no sistema Zeus.
	  
	#### **Outras Configurações**:
	- **Não Perturbe**: Configura se o modo "Não Perturbe" está ativado, com opções "Sim" ou "Não".
	
7. Clique em **Salvar** para validar a criação do ramal SIP.


### 4. Cadastro da [[tarefa - importar ligacoes zeus voip|Tarefa - Importar Ligações Zeus VoIP]]
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 Zeus. Para realizar este procedimento, siga os passos a seguir:

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 ligações VoIP**;
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**.

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

>[!INFO] **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)|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.

>[!TIP] Guia instrutivo:
>Para acessar o material sobre como realizar a geração do adicional de telefonia, acesse: [[geracao do adicional de telefonia - filtros voip|Geração do Adicional de Telefonia - Filtros VoIP]].


## Fluxo de Trabalho
```mermaid
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 Zeus 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 Zeus de forma integrada.

## Etiquetas
#Integracoes #IntegracaoVoIP #VOIP #Zeus

## Leia Também
- [[integracoes|Integrações]]
- [[integracao voip - zeus|Integração VoIP - Zeus]]
- [[perfil voip - zeus|Perfil VoIP - Zeus]]
- [[criacao de ramal sip - zeus|Criação de Ramal SIP - Zeus]]
- [[tarefa - importar ligacoes zeus voip|Tarefa - Importar Ligações Zeus VoIP]]
- [[aba linha sip - contrato do cliente|Aba Linha SIP - Contrato do Cliente]]
- [[ramal sip|Ramal SIP]]
- [[plano de cobranca - voip|Plano de cobrança - VoIP]]
- [[geracao do adicional de telefonia - filtros voip|Geração do Adicional de Telefonia - Filtros VoIP]]
- [[relatorio voip ligacoes|Relatório VoIP Ligações]]