# Tarefa - Cancelamento automático de Ramais VSC

## Introdução
A tarefa **Cancelamento automático de Ramais VSC** é uma funcionalidade para empresas que utilizam a [[integracao voip - vsc|Integração VoIP - VSC]], de telefonia fixa, no sistema. Esta tarefa permite que ramais inativos sejam cancelados automaticamente após o cancelamento e inativação do [[formulario contrato do cliente|Contrato do Cliente]].

> [!NOTA] **Acesso à Configuração**
> **Caminho:** Ferramentas > Ferramentas > Agenda de Tarefas > Cancelamento automático de Ramais VSC

### Requisitos de Uso
É necessário utilizar a integração de telefonia fixa com a plataforma [[integracao voip - vsc|VSC]] no sistema para utilizar a tarefa de **Cancelamento automático de Ramais VSC**.

## Entrega de Valor
- Automatização do cancelamento de ramais;
- Centralização das informações de cancelamento de telefonia no sistema.

## Estrutura do Formulário
O formulário de Agenda de tarefas está organizado em uma única aba, que permite o cadastramento da tarefa de **Cancelamento automático de Ramais VSC** e configuração da sua execução periódica.

## Funcionalidades Principais
- Realizar o cancelamento de ramais de forma automatizada após o cancelamento de contratos que possuem um [[ramal sip|Ramal SIP]] associado.

## Configuração da Tarefa

### Funcionamento da Tarefa
A tarefa **Cancelamento automático de Ramais VSC** opera em conjunto com a configuração de **[[cancelamento automatico de ramais vsc|Cancelamento automático de Ramais VSC]]**.

Primeiro, cadastra-se uma **Range** e configura-se o parâmetro **Cancelamento automático VSC**, definindo o número de dias para o cancelamento do ramal após o término do contrato. Em seguida, é criado um **[[ramal sip|Ramal SIP]]** com o número de binagem da Range. Quando o contrato vinculado ao ramal é cancelado e o tempo definido no parâmetro é atingido, a **[[tarefa - cancelamento automatico de ramais vsc|Tarefa - Cancelamento automático de Ramais VSC]]** identifica o ramal com contrato desativado, cancela-o e altera seu status para **Inativo**. O cancelamento é então registrado na grid de **[[logs telefonia|Logs Telefonia]]**.

### Configuração

>[!INFO] Informação:
>Para utilizar esta tarefa, certifique-se de que a configuração de [[cancelamento automatico de ramais vsc|Cancelamento automático de Ramais VSC]] está parametrizada no sistema.

Para realizar a configuração da tarefa, siga os passos abaixo:
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** 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á;
   
>[!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**;
5. Após preencher os campos, clique em **Salvar** para validar a criação da tarefa.

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 de ramais SIP VSC atrelados à contratos inativos;
- Registro de cancelamento na grid de [[logs telefonia|Logs Telefonia]].

## Fluxo de Trabalho

```mermaid
graph 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 --> D[Cancelamento de contratos que possuem 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
A tarefa de Cancelamento automático de Ramais VSC é uma ferramenta poderosa para manter o Sistema atualizado com informações precisas sobre o uso dos serviços de telefonia. Ao configurar corretamente esta rotina, as empresas podem garantir uma gestão eficiente de seus recursos de VoIP, melhorar a qualidade do atendimento ao cliente e otimizar seus processos de faturamento.

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

## Leia Também
- [[agenda de tarefas|Agenda de Tarefas]]
- [[integracoes|Integrações]]
- [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]
- [[integracao voip - vsc|Integração VoIP - VSC]]
- [[logs telefonia|Logs Telefonia]]
- [[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]]
- [[tarefa - bloquear linha sip vsc contrato inativo|Tarefa - Bloquear Linha SIP VSC Contrato Inativo]]