# Range de Números Cadastrados
## 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. 

A **Range de números** no sistema é uma ferramenta projetada para gerenciar eficientemente um intervalo de números telefônicos fornecidos pela operadora, disponíveis para alocação no sistema de telefonia ao utilizar [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]. Essa funcionalidade oferece maior controle e organização dos números atribuídos aos ramais ou serviços.

> [!NOTA] **Acesso ao Formulário**
> **Caminho:** Sistema > Plataforma Voip > Configurações > Range de números cadastrados

### 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]]
> - [[integracao voip - fale sempre - master abril 2025|Integração VoIP - Fale Sempre]]

## 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 do Formulário
O formulário de **Range de Números Cadastrados** está estruturado em uma grid, que reúne as informações de todos os registros de ranges já cadastradas. Esta grid está organizada em linhas e colunas e cada registro individual corresponde ao mesmo formulário que armazena os detalhes das ranges. O formulário **Range de Números Cadastrados** é organizado em abas para facilitar a gestão de dados, sendo elas: aba **Bloco de números entrantes** e a aba **Números para binagem.**

### Aba Bloco de números entrantes
Esta seção permite o gerenciamento dos números disponíveis para uso no sistema, onde é realizado o cadastro e edição de ranges.

| Campo             | Descrição                                                                | Obrigatório                  |
| ----------------- | ------------------------------------------------------------------------ | ---------------------------- |
| ID                | Identificador único do registro                                          | Sim (gerado automaticamente) |
| Nome              | Nome do pool de números entrantes para identificação e controle          | Sim                          |
| Numeração inicial | Primeiro número do range a ser cadastrado, definindo o início do período | Sim                          |
| Numeração final   | Último número do range a ser cadastrado, definindo o final do período    | Sim                          |
### Abas integradas com outros módulos
 - **Aba [[range de numeros cadastrados|Números para binagem]]: Esta aba está relacionada ao formulário de [[visualizar range de numeros|Visualizar Range de Números]]**. Seu objetivo é proporcionar uma visão abrangente da totalidade dos números cadastrados nas ranges, exibindo o status de cada um, que pode ser **Em Uso** ou **Disponível**. 

## Casos de uso
### [[como cadastrar range de numeros|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 menu **Sistema**;
2. Clique em **Plataforma VoIP**;
3. Selecione a pasta **Configurações**;
4. Selecione a opção **Range de números cadastrados**;
5. 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:** número inicial da numeração da range;
	- **Numeração final:** número final da numeração da range;
	- **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.
6. 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]]**.

## 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 [[integracao voip - vsc|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]]
>- [[guias tutoriais/integracoes gerais/tutorial voip/cadastro de ramais - integracoes/criacao de ramal sip - interede|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]]
>- [[criacao de ramal sip - fale sempre|Criação de Ramal SIP - Fale Sempre]]

## Fluxo de Trabalho
```mermaid
graph TD
    A[Acessar o Formulário] --> B[Selecionar Aba]
    B --> C{Ação Desejada}
    C --> |Cadastrar| D[Preencher Campos Obrigatórios]
    C --> |Editar| E[Selecionar Range Existente]
    C --> |Excluir| F[Selecionar e Confirmar Exclusão]
    D --> G[Salvar]
    E --> G
    F --> G
    G --> H[Atualização do Pool de Números]
```


## Considerações Finais
O gerenciamento eficaz da range de números é crucial para a operação eficiente do sistema VoIP. Utilize as funcionalidades do formulário de Range de Números Cadastrados para manter um controle preciso sobre os recursos telefônicos disponíveis.

## Etiquetas
#Integracoes #IntegracoesVoIP #TelefoniaFixa #VoIP #CadastroDeRange 

## 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]]
- [[como cadastrar range de numeros|Como Cadastrar Range de Números]]
- [[criacao de ramal sip - interede|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 - Summit Networks]]
- [[criacao de ramal sip - tysa|Criação de Ramal SIP - Tysa]]
- [[criacao de ramal sip - zeus|Criação de Ramal SIP - Zeus]]
- [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]]