# Criação de Ramal SIP - VSC

## Introdução

>[!TIP] **VSC**  
A **[VSC](https://www.VSC.com.br/)** é uma empresa brasileira especializada em soluções VoIP para telefonia fixa, proporcionando controle centralizado, flexibilidade operacional e escalabilidade para uma gestão eficiente das comunicações telefônicas.

A integração do sistema com a plataforma [VSC](https://www.VSC.com.br/) 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.

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

### Requisitos de Uso:
Para realizar a ativação de uma linha SIP no sistema, é necessário atender as seguintes condições:
- Possuir integração de telefonia fixa com a [[integracao voip - vsc|Integração VoIP - VSC]] em uso no sistema;
- [[tarefa - importar batches vsc|Tarefa - Importar Batches VSC]] para a importação dos planos de telefonia fixa ao sistema.

## 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 - vsc|Integração VoIP - VSC]] utiliza o formulário [[ramal sip|Ramal SIP]]. Este formulário está vinculado ao [[formulario contrato do cliente|Formulário 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 - 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.

### Passo 1: Cadastro da [[tarefa - importar batches vsc|Tarefa - Importar Batches VSC]]
A tarefa **Importar Batches VSC** é uma funcionalidade para empresas que utilizam a [[integracao voip - vsc|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|Ramal SIP]] no sistema. Para realizar a configuração da tarefa, siga os passos abaixo:

>[!NOTE] Importante:
> 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.

1. Acesse o formulário de [[agenda de tarefas|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 Batches VSC**;
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á;
   
>[!quote]  **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**;
8. Após preencher os campos, clique em **Salvar** para validar a criação da tarefa;
9. Selecione a tarefa e clique no botão **Executar tarefa** para iniciar a importação dos planos para o sistema.

### Passo 2: Cadastro do Ramal SIP

>[!INFO] Perfil VoIP: 
Para otimizar e padronizar configurações, você pode usar o recurso de Perfil VoIP, que permite estabelecer configurações pré-definidas para facilitar o cadastro de ramais SIP. Para cadastrar um Perfil VoIP e usá-lo na ativação de Ramais SIP, acesse: [[perfil voip - vsc|Perfil VoIP - VSC]]

Após o cadastro e execução da [[tarefa - importar batches vsc|Tarefa - Importar Batches VSC]], é possível prosseguir com a ativação da linha com os planos importados. Para criar uma linha SIP utilizando a [[integracao voip - vsc|Integração VoIP - VSC]], 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 a cobrança de excedentes;
4. No campo **Integração**, clique na lupa e selecione a integração de VoIP da plataforma VSC;
5. 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|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.

6. Acesse a aba **Configurações adicionais** e no campo **Use Area Code**, defina se o uso do código de áea é obrigatório para todas as ligações;
7. Acesse a aba **Configuração VSC** e preencha os demais campos apresentados (caso não utilize o [[perfil voip - vsc|Perfil VoIP - VSC]]):
	#### **Campos principais:**
	- **ID Batch:** preenchido automaticamente ao selecionar o plano do ramal;
	- **Batch:** clique no botão **Buscar batch** para selecionar o plano do ramal;
	- **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;
	- **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 numeros cadastrados|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. 
	  
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 VSC, 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 VSC:
>- [[integracao voip - vsc|Integração VoIP - VSC]]
>- [[tarefa - importar batches vsc|Tarefa - Importar Batches VSC]]
>- [[tarefa - importar ligacoes vsc|Tarefa - Importar Ligações VSC]]
>- [[plano de cobranca - voip|Plano de cobrança - VoIP]]
>- [[geracao do adicional de telefonia - filtros voip|Geração do Adicional de Telefonia - Filtros VoIP]]
>- [[perfil voip - vsc|Perfil VoIP - VSC]]

## Fluxo de Trabalho

```mermaid
graph TD
    A[Credenciamento na Plataforma VSC] --> B[Integração do Sistema com VSC]
    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 VSC 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 #IntegracoesVoIP #IntegracaoVoIPVSC #VSC 

## Leia Também
- [[integracoes|Integrações]]
- [[integracao voip - vsc|Integração VoIP - VSC]]
- [[perfil voip - vsc|Perfil VoIP - VSC]]
- [[tarefa - importar batches vsc|Tarefa - Importar Batches VSC]]
- [[tarefa - importar ligacoes vsc|Tarefa - Importar Ligações VSC]]
- [[aba linha sip - contrato do cliente|Aba Linha SIP - Contrato do Cliente]]
- [[ramal sip|Ramal SIP]]
- [[ramal sip x clientes|Ramal SIP X Clientes]]
- [[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)]]