# Configuração para Criação de Ramal (Perfil VoIP) - Tysa
## Introdução

>[!TIP] **Tysa**
>A **[Tysa](https://www.tysa.com.br/)** é uma empresa brasileira especializada em soluções para telecomunicações, oferecendo uma plataforma VoIP que possibilita a prestação de serviços de telefonia fixa. O sistema oferece controle centralizado de chamadas, flexibilidade operacional e escalabilidade, permitindo uma gestão eficiente das comunicações telefônicas.

O formulário de **Configuração para Criação de Ramal** (Perfil VoIP) é uma ferramenta projetada para a gestão e personalização de ramais cadastrados no sistema. Neste documento, será abordada a criação de um **Perfil VoIP** ao utilizar uma integração com a plataforma  **[Tysa](https://www.tysa.com.br/)**.

O **Perfil VoIP** permite a definição de parâmetros específicos para cada ramal a partir de uma configuração padrão. Essa função tem como objetivo **padronizar** as **configurações** dos **ramais**, para que, ao realizar a criação do ramal SIP no sistema, seja possível inserir um perfil padrão pré-estabelecido, com as informações pré definidas das configurações do ramal.

> [!NOTA] **Acesso ao Formulário**
> **Caminho:** Sistema > Plataforma Voip > Configurações > Configuração para Criação de Ramal

### Requisitos de Uso
Para utilizar este recurso, é necessário atender as seguintes condições:
- Deve possuir a [[integracao voip - tysa|Integração VoIP - Tysa]] previamente cadastrada no sistema.

>[!TIP] Guia instrutivo:
>Para verificar mais informações sobre a integração, acesse: [[integracao voip - tysa|Integração VoIP - Tysa]]

## Entrega de Valor
- Personalização e padronização de ramais;
- Controle sobre as funcionalidades de cada ramal;
- Otimização do fluxo de processos internos;
- Facilidade na configuração e manutenção de ramais.

## Estrutura do Formulário
O formulário de **Configuração para Criação de Ramal** está estruturado em uma grid, que reúne as informações de todos os registros de cadastros de perfis. Esta grid está organizada em linhas e colunas e cada registro individual corresponde ao mesmo formulário que armazena os detalhes dos perfis. 

O formulário de **Configuração para Criação de Ramal** se relaciona com sua aba correspondente, da qual detém campos necessários e específicos para a configuração do perfil de cada gateway de telefonia fixa ([[integracoes de telefonia fixa - voip|Integração VoIP]]).

> [!caution] Atenção: 
> Nesta documentação, a configuração do perfil VoIP é específica para a plataforma  **[Tysa](https://www.tysa.com.br/)**.
 
### Aba Configuração para Criação de Ramal 
O formulário está estruturado principalmente na aba **Configuração para Criação de Ramal**, onde os usuários podem definir as opções para cada ramal. Esta seção é crucial para a personalização das configurações de VoIP de acordo com as necessidades específicas de cada tipo de ramal ativado.

#### Campos Principais
- **ID**: Identificador único do perfil VoIP, gerado automaticamente pelo sistema.
- **Gateway**: Campo dinâmico de seleção para o tipo de gateway VoIP a ser utilizado. 

## Configuração do Perfil VoIP Tysa

> [!Success] Criação do ramal:
> A configuração do Perfil VoIP para a integração Tysa permite que, ao vincular o perfil VoIP na criação de um novo ramal, a aba **Tysa** já seja preenchida com as pré-definições do perfil.

Para realizar o cadastro do perfil VoIP, siga os passos descritos abaixo:

1. Acesse menu **Sistema** e, em seguida, selecione a opção **Plataforma Voip**;
2. Clique na pasta **Configurações** e, após, clique em **Configurações para Criação de Ramal**;
3. Selecione o botão **Novo**;
4. Preencha o campo de **Nome** para a identificação do perfil;
5. No campo **Gateway**, selecione a opção **Voip - Tysa**;
6. Preencha os demais campos dinâmicos, descritos a seguir, que são liberados ao selecionar o gateway:

| Campos                | Descrição                                                                                       |
| --------------------- | ----------------------------------------------------------------------------------------------- |
| Integração            | Insira o cadastro da integração com a plataforma Tysa.                                          |
| Função da linha       | Seleção da função da linha: DDR, Tronco Chave, Comum.                                           |
| Endereço de IP        | Campo para inserir o endereço IP associado ao ramal.                                            |
| Limite de chamadas    | Insira o limite de número de chamadas simultâneas permitidas para o ramal.                      |
| Status da linha       | Status operacional da linha, podendo ser: Ativo, Bloqueio (Total), Bloqueio Parcial, Cancelado. |
| Tipo de Endereçamento | Método de endereçamento do IP: Dinâmico ou Estático.                                            |
| Tipo de Conta SIP     | Defina o tipo de conta SIP: Tronco Sip ou Normal.                                               |

7. Após finalizar o preenchimento dos campos que julgar necessário, clique em **Salvar** para validar e finalizar a criação do perfil VoIP.

## Casos de Uso

### [[criacao de ramal sip - tysa|Criação de Ramal SIP - Tysa]]
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. Para criar uma linha SIP utilizando a [[integracao voip - tysa|Integração VoIP - Tysa]], 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 cobrança por consumo ou cobrança de excedentes;
4. No campo **Integração**, clique na lupa e selecione a integração de VoIP da plataforma Tysa;
5. Preencha os demais campos:
	- **Descrição:** campo de preenchimento opcional, permite inserir uma breve descrição para o ramal
	- **Número para binagem:** clique no botão **Listar** para selecionar um número de binagem da [[range de numeros cadastrados|Range de Números Cadastrados]] ou insira manualmente;
	- **Senha:** clique no botão **Gerar senha** para gerar uma senha ao Ramal;
	- **Ativo:** filtro para habilitar a ativação do Ramal ou para inativá-lo.
	  
6. Acesse a aba **Tysa** para definir configurações adicionais do Ramal SIP. Preencha os campos:
	- **Tipo de conta SIP:** defina se é uma linha comum clicando na opção "Normal" ou se é um tronco SIP, clicando na opção "Tronco SIP";
	- **Tipo de endereçamento:** defina se o endereçamento é "Estático" ou "Dinâmico";
	- **Status da linha:** campo focado em definir o status da linha, entre as opções: Cancelado, Bloqueado (Total), Bloqueio parcial ou Ativo;
	- **Limite de chamadas:** defina o limite de chamadas da linha;
	- **Endereço de IP:** insira o endereço de IP utilizado pela linha, caso necessário;
	- **Função da linha:** defina a função da linha, entre as opções: Comum, Tronco chave ou DDR.
	  
7. 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 Tysa, portanto, a linha coexiste em ambos os sistemas a partir da comunicação estabelecida pela integração.


## Fluxo de Trabalho

```mermaid
graph TD
    A[Acessar menu Sistema] --> B[Acessar Plataforma VoIP]
    B --> C[Acessar formulário de Configuração para Criação de Ramal]
    C --> D[Clicar no botão Novo] 
    D --> E[Preencher campos obrigatórios e adicionais]
    E --> F[Configurar limites de chamadas e permissões]
    F --> G[Salvar o perfil]
    G --> H[Realizar novo cadastro de ramal SIP]
    H --> I[Vincular perfil ao ramal SIP]
    I --> J[Fim]
```

## Considerações Finais
A criação de um perfil VoIP com configurações predefinidas para o cadastro de ramais SIP na plataforma Tysa é uma etapa essencial para garantir eficiência e padronização no gerenciamento dos serviços de telefonia. Um perfil bem configurado simplifica o processo de cadastro de novos ramais, reduzindo erros operacionais e otimizando o tempo de implantação. Certifique-se de revisar todas as definições, como planos de tarifação, codecs suportados, regras de autenticação e permissões, para alinhar o perfil às necessidades específicas da operação. Com isso, é possível garantir uma experiência robusta, segura e alinhada às políticas da organização.

## Etiquetas
#Integracoes #IntegracoesVoIP #IntegracaoVoIPTysa #Tysa
## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]
- [[integracao voip - tysa|Integração VoIP - Tysa]]
- [[criacao de ramal sip - tysa|Criação de Ramal SIP - Tysa]]
- [[tarefa - importar cdr tysa|Tarefa - Importar CDR Tysa]]
- [[como configurar tarifacao - telefonia voip tysa|Como Configurar Tarifação - Telefonia VoIP Tysa]]
- [[plano de cobranca - voip|Plano de cobrança - VoIP]]
- [[tarifas - voip|Tarifas - VoIP]]