# Como Cadastrar Range de Números

## Introdução

>[!TIP] Definição:
>**Range de números:** Uma **range de números** em VoIP é um intervalo contínuo de números telefônicos fornecido por uma operadora para criar ramais ou linhas telefônicas. Esses números são usados para identificar usuários, dispositivos ou funções específicas dentro da rede. 

O cadastro de range de números é uma funcionalidade essencial para gerenciar a numeração de telefonia fixa no sistema. Essa configuração permite definir intervalos numéricos específicos para diferentes ramais, garantindo organização e conformidade com requisitos de integrações VoIP.

> [!NOTA] **Acesso à Configuração**
> **Caminho:** Sistema > Plataforma Voip > Configurações > Range de números cadastrados > Novo

### Requisitos de Uso
A range de números cadastrados é projetada para controle de linhas de telefonia fixa ao utilizar uma integração de VoIP;

>[!Example] Plataformas de telefonia fixa compatíveis com o sistema:
> - [[integracao voip - interede|Integração VoIP - Interede]]
> - [[integracao voip - magnus billing|Integração VoIP - Magnus Billing]]
> - [[integracao voip - saperx v2|Integração VoIP - SaperX v2]]
> - [[integracao voip - sippulse|Integração VoIP - SipPulse]]
> - [[integracao voip - summit networks|Integração VoIP - Summit Networks]]
> - [[integracao voip - tysa|Integração VoIP - Tysa]]
> - [[integracao voip - vsc|Integração VoIP - VSC]]
> - [[integracao voip - zeus|Integração VoIP - Zeus]]

## Entrega de Valor
- Organização eficiente dos números de telefone fixo disponíveis;
- Controle preciso sobre a alocação de números aos clientes;
- Facilidade na identificação de números livres e ocupados;
- Otimização do processo de atribuição de números telefônicos;
- Redução de erros na gestão de recursos de telefonia fixa.

## Estrutura da Funcionalidade
O formulário de **Range de Números Cadastrados** é apresentado em uma grid que centraliza as informações de todos os registros de ranges já cadastrados. Esta grid é organizada em linhas e colunas, e cada registro corresponde ao formulário que detalha os dados da respectiva range. O formulário é dividido em abas para otimizar a gestão dos dados, com as seguintes opções: **Bloco de Números Entrantes** e **Números para Binagem**.

1. **Aba de Bloco de números entrantes:** exibe os campos de cadastro da range de número;
2. **Aba Números para binagem**: exibe os números disponíveis e à qual Pool/Range os números pertencem, bem como seus status (**Disponível** ou **Em uso**). Se relaciona com o formulário [[visualizar range de numeros|Visualizar Range de Números]].

## Como Cadastrar Range de Números
O cadastro da **range de números** consiste na definição de um intervalo de números telefônicos. Após sua criação, o sistema exibe cada número individualmente, indicando seu **status de uso**: **Disponível**, caso não esteja associado a nenhum ramal, ou **Em uso**, se estiver vinculado a um ramal existente no sistema. Para cadastrar uma range de números, siga os passos a seguir:

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.

>[!SUCCESS] Ativação:
>Após o cadastro da **range de números**, o sistema permite vincular os números do intervalo durante a criação de um [[ramal sip|Ramal SIP]]. Além disso, é possível visualizar os números cadastrados na grid de [[visualizar range de numeros|Visualizar Range de Números]], acessível pelo caminho: **Sistema > Plataforma VoIP > Configurações > [[visualizar range de numeros|Visualizar Range de Números]]**.

>[!TIP] Cancelamento automático VSC:
>Para realizar a configuração completa acerca do cancelamento automático utilizando a integração VSC, confira o manual: [[cancelamento automatico de ramais vsc|Cancelamento automático de Ramais VSC]]

## Funcionalidades Principais
- **Cadastro de ranges:** Permite adicionar novos intervalos de números ao pool;
- **Edição de ranges:** Possibilita a modificação de informações de ranges existentes.
- **Exclusão de ranges:** Permite a remoção de ranges que não são mais necessários;
- **Configuração de cancelamento automático - [[cancelamento automatico de ramais vsc|Cancelamento automático de Ramais VSC]]:** Oferece opções para definir critérios de cancelamento automático de números. Recurso disponível para integração com a plataforma de telefonia fixa VSC ([[integracao voip - vsc|Integração VoIP - VSC]]), no qual é definida a quantidade de dias em que o ramal da range será inutilizado automaticamente após cancelamento de contrato. 

>[!CAUTION] **Atenção:**
>A exclusão de uma **range de números** não impacta os ramais já cadastrados que utilizam os números desse intervalo. Além disso, a **range de números** é uma configuração exclusiva do IXC, não havendo comunicação com a plataforma de telefonia fixa integrada.

## Casos de Uso

>[!EXAMPLE] Casos de Uso:
>- [[como cadastrar range de numeros|Como Cadastrar Range de Números]]
>- [[cancelamento automatico de ramais vsc|Cancelamento automático de Ramais VSC]]
>- [[guias tutoriais/integracoes gerais/tutorial voip/cadastro de ramais - integracoes/criacao de ramal sip - interede|public/Guias Tutoriais/Integrações Gerais/Tutorial VoIP/Cadastro de Ramais - Integrações/Criação de Ramal SIP - Interede]]
>- [[criacao de ramal sip - magnus billing|Criação de Ramal SIP - Magnus Billing]]
>- [[criacao de ramal sip - saperx v2|Criação de Ramal SIP - SaperX v2]]
>- [[criacao de ramal sip - sippulse|Criação de Ramal SIP - SipPulse]]
>- [[criacao de ramal sip - summitnetworks|Criação de Ramal SIP - SummitNetworks]]
>- [[criacao de ramal sip - tysa|Criação de Ramal SIP - Tysa]]
>- [[criacao de ramal sip - vsc|Criação de Ramal SIP - VSC]]
>- [[criacao de ramal sip - zeus|Criação de Ramal SIP - Zeus]]

### Visualização de Números Disponíveis
Após realizar a criação de uma range, é possível visualizar o status de disponibilidade dos números configurados no intervalo da Pool. Para realizar esta visualização, siga os passos a seguir:

1. Acesse o formulário de [[visualizar range de numeros|Visualizar Range de Números]] através do caminho: Sistema > Plataforma VoIP > Configurações > Visualizar Range de Números;
2. Será exibida a grid de números disponíveis contendo as seguintes informações:

| Campo                 | Descrição                                                                           |
| --------------------- | ----------------------------------------------------------------------------------- |
| Pool                  | Nome do grupo ou conjunto de números a que o número pertence.                       |
| DDI + DDD             | Código de discagem internacional (DDI) e código de área (DDD) associados ao número. |
| Número                | Número de telefone específico que compõe determinada range.                         |
| Ramal                 | Número do ramal associado ao número de telefone.                                    |
| Contrato              | ID do contrato associado ao número de telefone.                                     |
| Status do contrato    | Estado atual do contrato (ex: Ativo, Inativo).                                      |
| Dias contrato inativo | Número de dias que o contrato está inativo.                                         |
| Status do Número      | Estado atual do número de telefone (ex: Em uso, Disponível).                        |

## Fluxo de Trabalho
```mermaid
graph TD
    A[Credenciamento com Plataforma de Telefonia Fixa] --> B[Integração com IXC]
    B --> C[Criação da Range de Números]
    C --> D[Preenche o Intervalo de Início e Final]
    D --> E[Visualização de Números: Disponível ou Em Uso]
    E --> F[Cadastro do Contrato do Cliente]
    F --> G[Ativar Linha SIP]
    G --> H[Controle de Acesso do Contrato e Linha]
    H --> I[Monitoramento]
```

## Considerações Finais
O cadastro e a gestão de **Range de Números** são essenciais para otimizar o uso de números em plataformas VoIP, garantindo uma administração eficaz dos recursos. Através do sistema, é possível criar intervalos de números de forma simples e gerenciar seu uso em tempo real. Através deste processo, é possível criar intervalos de números de forma flexível e controlada, garantindo que sua distribuição em [[ramal sip|Ramal SIP]] seja eficiente e organizada.

### Considerações Importantes
- **Exclusão de Range**: Como mencionado anteriormente, a exclusão de uma range de números não afeta os ramais já configurados. Isso proporciona maior segurança, permitindo ajustes no sistema sem comprometer a operação existente.
    
- **Limitações de Interação**: Vale ressaltar que a range de números é uma configuração interna do IXC e não está diretamente vinculada à plataforma de telefonia fixa integrada. Portanto, alterações feitas dentro do sistema de telefonia VoIP não se refletem automaticamente na plataforma de telefonia externa.
    
- **Monitoramento e Controle**: A possibilidade de monitorar e acompanhar os números em tempo real permite um controle mais rigoroso e ajuda a identificar rapidamente qualquer problema com a alocação de números. A interface de **Visualização de Range de Números** oferece uma visão clara de todas as configurações em um único lugar.

## Etiquetas
#Integracoes #IntegracoesVoIP #TelefoniaFixa #RamalSIP #RangeDeNumeros 

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]
- [[integracao voip - interede|Integração VoIP - Interede]]
- [[integracao voip - magnus billing|Integração VoIP - Magnus Billing]]
- [[integracao voip - saperx v2|Integração VoIP - SaperX v2]]
- [[integracao voip - sippulse|Integração VoIP - SipPulse]]
- [[integracao voip - summit networks|Integração VoIP - Summit Networks]]
- [[integracao voip - tysa|Integração VoIP - Tysa]]
- [[integracao voip - vsc|Integração VoIP - VSC]]
- [[integracao voip - zeus|Integração VoIP - Zeus]]
- [[range de numeros cadastrados|Range de Números Cadastrados]]
- [[visualizar range de numeros|Visualizar Range de Números]]
- [[ramal sip|Ramal SIP]]
- [[ramal sip x clientes|Ramal SIP X Clientes]]
- [[aba linha sip - contrato do cliente|Aba Linha SIP - Contrato do Cliente]]