# Criação de Ramal SIP - SaperX v2

## Introdução

>[!tip] Atenção!
>Este conteúdo contém informações de funcionalidades presentes na **versão [[clientes beta ixc soft|Beta]]** do sistema.
>A disponibilidade do recurso atualmente em **Beta** será lançado na **versão Estável** será a partir de Abril de 2025.

---

>[!TIP] **VoIP SaperX**
>A plataforma [SaperX](https://saperx.com.br/) é uma plataforma avançada de gerenciamento e automação desenvolvida especificamente para provedores de serviços de internet (ISPs) e operadoras de telecomunicações.

A integração do sistema com a plataforma VoIP SaperX otimiza o gerenciamento do módulo de telefonia fixa. Esta funcionalidade permite uma gestão eficiente e centralizada diretamente através do IXC, eliminando a necessidade de alternar entre diferentes interfaces. Ao unificar o controle da telefonia fixa dentro do ambiente IXC, a integração simplifica processos operacionais, melhora a visibilidade dos serviços de voz e facilita a administração integrada dos recursos de telecomunicações. Entre estas funcionalidades, o sistema permite a criação do Ramal SIP diretamente pelo sistema, possibilitando também o controle de acesso da linha.

- Este documento detalha o processo de criação de um ramal SIP (Session Initiation Protocol) para a integração VoIP SaperX no sistema. O ramal SIP permite a comunicação por voz sobre IP, sendo essencial para a configuração de telefonia VoIP.

> [!NOTA] **Acesso à Configuração**
>**Caminhos**:
>- Sistema > Plataforma VoIP > Ramais > Ramal SIP - Clientes
>- Sistema > Cadastros > Contratos > Linha SIP

### Requisitos de Uso:
Para utilizar esta funcionalidade, é necessário atender as seguintes condições:
- Integração de telefonia fixa com a [[integracao voip - saperx v2|Integração VoIP - SaperX v2]].

## Entrega de Valor
- Centralização de dados e processos, otimizando tempo e recursos;
- Expande as opções de serviços;
- Facilita a gestão de faturamento conjunto dos serviços de internet e telefonia fixa;
- Promove controle de uso;
- Viabiliza relatório de ligações.

## Estrutura da Funcionalidade
A funcionalidade de **Criação de Ramal** na [[integracao voip - saperx v2|Integração VoIP - SaperX v2]] utiliza o formulário [[ramal sip|Ramal SIP]]. Este formulário está vinculado ao [[formulario contrato do cliente|Contrato do Cliente]] e à guia [[ramal sip x clientes|Ramal SIP X Clientes]]. A ativação da linha pode ser realizada por meio de dois caminhos distintos:

1. Sistema > Cadastros > Contratos > aba Linha SIP;
2. Sistema > Plataforma VoIP > Ramais > Ramal SIP - Clientes.

Esta estrutura permite uma gestão flexível e integrada dos ramais SIP.

## Como Criar Ramal SIP - SaperX
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 [[integracao voip - saperx v2|Integração VoIP - SaperX v2]], 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 SaperX v2;
5. Preencha os demais campos:
	- **Código da conta:** campo de preenchimento opcional. Pode ser preenchido com 6 dígitos. Caso não seja preenchido manualmente, o sistema preencherá automaticamente com a informação disponível na SaperX (normalmente um valor aleatório preenchido como retorno da plataforma);
	- **Código da conta (somente para versão Beta):** permite definir um valor específico (personalizado) para ser enviado à SaperX, indicando o valor que o circuito terá na plataforma. Pode ser preenchido com 6 dígitos, se preenchido será enviado à plataforma para a criação do SIP. Caso não seja preenchido manualmente, o sistema preencherá automaticamente;
	- **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;
	- **Ativo:** filtro para habilitar a ativação do Ramal ou para inativá-lo.

7. Acesse a aba **Configurações adicionais** e no campo **Limite de ligações simultâneas**, defina o limite de quantidade das ligações simultâneas que a linha pode ter;
8. Acesse a aba **Configuração SaperX** e preencha os demais campos apresentados:
	#### **Campos principais:**
	- **Plano id:** clique no botão **Buscar plano** para selecionar o plano de telefonia do ramal. Os planos são cadastrados diretamente na plataforma;
	- **Plano Internacional:** para utilizar um plano de consumo internacional, clique no botão **Buscar plano internacional** e selecione o plano correspondente;
	- **Dia do fechamento da fatura:** define o dia de fechamento da fatura no ramal do cliente;
	- **Plano descrição:** campo preenchido automaticamente ao salvar o cadastro do ramal;
	- **Tipo:** defina o tipo de cobrança no ramal do cliente (pré-pago ou pós-pago);
	- **Plano tipo:** defina a rota do ramal, se será SCM, STFC ou personalizado;
	- **Bina:** defina se a bina será **Ativa** ou **Inativa**;
	- **LC:** indique se o ramal terá permissão para ligações locais;
	- **LDN:** indique se o ramal terá permissão para ligações locais;
	- **LDI**;
	- **Libera ramal VC1;**
	- **Libera ramal VC2**;
	- **Libera ramal VC3**;
	  
8. 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.
	  
9. Clique em **Salvar** para validar a criação do ramal SIP.

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

## Casos de Uso

>[!EXAMPLE] Casos de Uso - Integração VoIP SaperX:
>- [[tarefa - importar ligacoes voip|Tarefa - Importar ligações VoIP]]
>- [[plano de cobranca - voip|Plano de cobrança - VoIP]]
>- [[geracao do adicional de telefonia - filtros voip|Geração do Adicional de Telefonia - Filtros VoIP]]

## Fluxo de Trabalho

```mermaid
graph TD
    A[Credenciamento na Plataforma SaperX] --> B[Integração do Sistema com SaperX]
    B --> C[Criação do Contrato de Telefonia Associado à Internet]
    C --> D[Criação da Linha SIP]
    D --> E[Controle de Acesso da Linha]
    E --> F{Tipo de Trabalho}
    F --> G[Ilimitado com Valor Fixo]
    F --> H[Franquia + Adicional]
    F --> I[Somente Utilização]
    G --> J[Insere Produto no Contrato e Fatura com Valor Fixo]
    H --> K[Configura Plano de Cobrança e Gera Adicional de Telefonia]
    I --> K
    K --> L[Faturamento]
    J --> L
    L --> M[Monitoramento]
```

## Considerações Finais
A integração entre o sistema e a plataforma VoIP SaperX otimiza significativamente a gestão de telefonia para provedores. Oferece sincronização automática de dados, garantindo consistência e eficiência operacional. Permite flexibilidade na administração, resposta rápida a mudanças e melhora a experiência do cliente. Esta configuração integrada não só simplifica processos internos, mas também suporta o crescimento escalável do negócio. Além disso, fortalece a posição competitiva do provedor no mercado de telecomunicações, permitindo a oferta de serviços VoIP mais robustos e confiáveis.

## Etiquetas
#Integracoes #IntegracaoVoIP #IntegracaoVoIPSaperX #SaperX 

## Leia Também
- [[integracoes|Integrações]]
- [[integracao voip - saperx v2|Integração VoIP - SaperX v2]]
- [[tarefa - importar ligacoes voip|Tarefa - Importar ligações 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]]
- [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]]