# Cancelamento automático de Ramais VSC

## Introdução

>[!TIP] VSC
>A plataforma [VSC](https://www.voipgroup.com/produtos/softswitch-VSC-plataforma-voip-billing-voip-para-operadoras-STFC-e-SCM) é uma solução de comunicação VoIP (Voice Over Internet Protocol) projetada para fornecer serviços de telefonia por meio da internet. Oferece funcionalidades para integrar a gerenciar chamadas, voltada para ISPs. A plataforma é integrada com ferramentas avançadas para controle e monitoramento de chamadas, gestão de rotas de comunicação e uso de tecnologia de SIP Trunking para otimizar o roteamento de chamadas e melhorar a qualidade do serviço.

O **cancelamento automático de ramais** na plataforma VSC refere-se a um processo automatizado para desativar ramais SIP que não estão mais em uso, devido à inatividade/cancelamento do contrato. O cancelamento automático de ramais é uma funcionalidade projetada para gerenciar eficientemente os recursos de telefonia VoIP em uma empresa.

- Este documento descreve o processo de configuração e uso do cancelamento automático de ramais na [[integracao voip - vsc|Integração VoIP - VSC]].

> [!NOTA] **Acesso à Configuração**
> **Caminho:** Sistema > Plataforma VoIP > Configurações > Range de números cadastrados > Cancelamento automático VSC

### Requisitos de Uso
É necessário o uso da [[integracao voip - vsc|Integração VoIP - VSC]] para operar este recurso.

## Entrega de Valor
- Otimização do uso de recursos de telefonia;
- Redução de custos operacionais;
- Melhoria na segurança ao desativar ramais não utilizados;
- Automação de processos administrativos.

## Estrutura da funcionalidade
A funcionalidade de [[cancelamento automatico de ramais vsc|Cancelamento automático de Ramais VSC]] é baseada principalmente em duas configurações:
- Cadastro de uma [[range de numeros cadastrados|Range de Números Cadastrados]];
- Configuração do parâmetro de **Cancelamento automático VSC**;
- Configuração da [[tarefa - cancelamento automatico de ramais vsc|Tarefa - Cancelamento automático de Ramais VSC]].

### Princípios de funcionamento
A funcionalidade está estruturada principalmente no formulário de [[range de numeros cadastrados|Range de Números Cadastrados]]. Ao realizar o cadastro de uma Range, deve ser configurado o parâmetro **Cancelamento automático VSC**, definindo a quantidade de dias de cancelamento do ramal após o cancelamento do contrato. Ao ocorrer o cancelamento do contrato do qual o Ramal está atrelado à esta range de numero, passada a quantidade de dias definida no parâmetro de cancelamento automático, a [[tarefa - cancelamento automatico de ramais vsc|Tarefa - Cancelamento automático de Ramais VSC]] identifica o ramal com o contrato desativado e realiza o cancelamento do ramal, alterando seu status para **Inativo**. Em seguida, este cancelamento é registrado nos [[logs telefonia|Logs Telefonia]].

## Configuração da funcionalidade
Para configurar o uso da ferramenta de Cancelamento automático de Ramais para a [[integracao voip - vsc|Integração VoIP - VSC]], siga os passos abaixo:
### Passo 1: Cadastro e Parametrização de Range de Números
Realize a criação de uma range de números e parametrize a quantidade de dias após o cancelamento do contrato, da qual o ramal será cancelado na sequência. Siga os passos abaixo:

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 no botão **Novo** para configurar uma nova range;
3. Na aba **Bloco de números entrantes**, preencha os campos:
	- **Nome:** insira uma breve descrição para o nome de identificação na range de números;
	- **DDI + DDD:** insira o código de discagem internacional (DDI) e o código de discagem direta (DDD). Exemplo: para o Brasil, o DDI é 55, e o DDD será o código de área regional;
	- **Numeração inicial:** indique a numeração inicial do bloco de números;
	- **Numeração final:** indique a numeração final do bloco de números;
	- **Cancelamento automático VSC:** insira a quantidade de dias que, após o cancelamento do contrato, o ramal será inativado. Exemplo: 5 dias após.
	
4. Clique em **Salvar** para validar as configurações;
5. Se necessário, acesse a aba **Números para Binagem** ao lado direito para conferir os números cadastrados no sistema.

### Passo 2: Configuração da [[tarefa - cancelamento automatico de ramais vsc|Tarefa - Cancelamento automático de Ramais VSC]]
Com a quantidade de dias de inativação parametrizada, é necessário ativar a funcionalidade através da tarefa de **Cancelamento automático de Ramais VSC**. A tarefa irá identificar os ramais que possuem contratos inativos e então irá requisitar a inativação do Ramal SIP. 
Para configurá-a, siga os passos a seguir:

>[!TIP] **Atenção:** 
> É recomendada a execução diária desta tarefa, para que quando executar, ela identifique os contratos cancelados recentemente.

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 **Cancelamento automático de Ramais 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á;
   
> **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.

>[!SUCCESS] **Finalização:**
>Após o cadastro da tarefa, a execução será iniciada. Ao identificar contratos inativos com ramais ativos, o sistema inativará esses ramais, ajustando o status para **Inativo** com base na quantidade de dias definida no parâmetro **Cancelamento automático de Ramais VSC** na Range.

Os registros de linhas canceladas ficarão armazenadas na grid de [[logs telefonia|Logs Telefonia]], apresentando todos os ramais cancelados automaticamente pela funcionalidade de [[cancelamento automatico de ramais vsc|Cancelamento automático de Ramais VSC]].

>[!INFO] Informação:
> Para que o cliente perca o acesso a utilização do ramal até que ocorra o cancelamento automático, há possibilidade de configurar a [[tarefa - bloquear linha sip vsc contrato inativo|Tarefa - Bloquear Linha SIP VSC Contrato Inativo]]. Esta tarefa irá bloquear o consumo da linha até que ocorra o cancelamento.

## Funcionalidades Principais
- Cancelamento automático de ramais SIP VSC atrelados à contratos inativos;
- Registro de cancelamento na grid de [[logs telefonia|Logs Telefonia]].

## Fluxos de Trabalho

```mermaid
flowchart TD
    A[Configuração da Range de Números] --> B[Configuração do parâmetro de Cancelamento automático de Ramais VSC]
    B --> C[Configuração da tarefa]
    C --> H[Ativação do Ramal SIP com número de binagem da Range configurada]
    H --> D[Cancelamento de contrato que possui Ramal SIP]
    D --> E[Tarefa executa e identifica contratos inativos com Ramal SIP]
    E --> F[Tarefa cancela Ramais SIP identificados]
    F --> G[Ramal SIP assume status de Inativo]

```

## Considerações Finais
O **cancelamento automático de ramais VSC** oferece uma solução eficiente para gerenciar recursos de telefonia, melhorando a segurança e reduzindo custos operacionais. É essencial revisar periodicamente as configurações para garantir que estejam alinhadas com as necessidades da empresa.

## Etiquetas
#Integracao #Integracoes #IntegracaoVoIP #VoIP #RamaisVSC #VSC

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]
- [[integracao voip - vsc|Integração VoIP - VSC]]
- [[visualizar range de numeros|Visualizar Range de Números]]
- [[range de numeros cadastrados|Range de Números Cadastrados]]
- [[tarefa - cancelamento automatico de ramais vsc|Tarefa - Cancelamento automático de Ramais VSC]]
- [[criacao de ramal sip - vsc|Criação de Ramal SIP - VSC]]