# Integrações MVNO Telefonia Móvel  

## Introdução

>[!TIP] Definição - MVNO e Telefonia Móvel
> Um **serviço de telefonia móvel** é um sistema de comunicação que possibilita chamadas de voz, envio de mensagens de texto (SMS) e acesso à internet por meio de dispositivos móveis, como celulares e smartphones. Esses serviços utilizam redes sem fio, conectando os dispositivos a torres de celular ou estações base que compõem a infraestrutura de telecomunicações.
> <br>
>O **MVNO** (Mobile Virtual Network Operator), ou Operadora Móvel Virtual em português, é uma empresa de telecomunicações que oferece serviços de telefonia móvel sem possuir sua própria infraestrutura de rede.

A funcionalidade de **Integração de Telefonia Móvel/MVNO** é uma solução indispensável para provedores de internet que combinam serviços de telefonia móvel com pacotes de internet. Essa ferramenta permite a configuração, manutenção e gerenciamento eficaz das conexões entre o sistema da empresa e diversas plataformas de telefonia móvel.

> [!NOTA] **Acesso ao Formulário:**
> **Caminho:** Configurações > Integrações > Integração MVNO/Telefonia Móvel

### Requisitos de Uso
Para utilizar uma integração de MVNO no sistema, é necessário realizar o credenciamento com uma das plataformas das quais o IXC possui compatibilidade, sendo elas:

>[!example] MVNOs que são compatíveis com o sistema:
>- [[integracao de telefonia movel - americanet|Integração de Telefonia Móvel - Americanet]]
>- [[integracao de telefonia movel - braz movel|Integração de Telefonia Móvel - Braz Móvel]]
>- [[integracao de telefonia movel - contel|Integração de Telefonia Móvel - Contel]]
>- [[integracao de telefonia movel - eai|Integração de Telefonia Móvel - Eaí]]
>- [[integracao de telefonia movel - surf (class-systems)|Integração de Telefonia Móvel - Surf (Class-Systems)]]
>- [[integracao de telefonia movel - telecall|Integração de Telefonia Móvel - Telecall]]
>- [[integracao de telefonia movel - tgn|Integração de Telefonia Móvel - TGN]]
>- [[integracao de telefonia movel - tip brasil|Integração de Telefonia Móvel - TIP Brasil]]
>- [[integracao de telefonia movel - tip ta telecom|Integração de Telefonia Móvel - TIP Tá Telecom]]

## Estrutura do Formulário
O formulário de **Configuração MVNO** está estruturado em uma grid, que reúne as informações de todas as integrações de MVNO cadastradas. Esta grid está organizada em linhas e colunas e cada registro individual corresponde ao mesmo formulário que armazena os detalhes das integrações.

Ao cadastrar ou editar uma integração específica, o sistema apresenta o formulário de **Configuração MVNO**, contendo as principais informações relacionadas à comunicação do MVNO com o sistema.

Para realizar a **configuração de uma plataforma MVNO**, é necessário efetuar o credenciamento com uma plataforma compatível, para ser possível efetuar o gerenciamento diretamente pelo sistema. Após concluir o processo de credenciamento da plataforma, você terá a opção de registrá-la no sistema. Isso permitirá estabelecer uma conexão direta, possibilitando que o gerenciamento seja feito diretamente através do IXC. O cadastro da plataforma pode ser realizado a partir do formulário **Configuração MVNO.**

### Aba Configuração MVNO
A aba **Configuração MVNO** contém os campos necessários para configurar as informações específicas do MVNO selecionado.
#### Campos Principais

| Campo | Descrição                                                                                                                                                      |
| ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID    | Identificador único da configuração (gerado automaticamente)                                                                                                   |
| MVNA  | Entidade intermediária entre as operadoras móveis tradicionais (MVNOs). O botão de seleção apresenta as integrações das quais o sistema possui compatibilidade |
Os demais campos relacionados à configuração MVNO são **dinâmicos**, isto é, são apresentados conforma a integração com o MVNA é selecionada.

>[!CAUTION] **Atenção**:
>Acesse o material individual de configuração, para cada plataforma, para efetuar a integração com o MVNO.

### Aba [[produtos ixc - mvno|Produtos IXC - MVNO]]
O formulário de **Configuração MVNO** se relaciona com o formulário [[produtos ixc - mvno|Produtos IXC - MVNO]], onde é possível visualizar ou realizar alterações e cadastros de produtos MVNO.
#### Campos Principais
| Campo               | Descrição                                                                       |
| ------------------- | ------------------------------------------------------------------------------- |
| ID                  | Identificador único do produto, gerado automaticamente                          |
| ID integração       | ID do cadastro da [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]]                          |
| ID plano integração | Identificador do plano de integração utilizado, buscado na plataforma integrada |
| ID produto IXC      | Identificador do produto associado ao IXC                                       |
| Ativo               | Indica se o produto está ativo (Sim ou Não)                                     |

### Princípios de Funcionamento
O uso do **formulário Configuração MVNO** está relacionado ao uso de uma **integração de MVNO**, portanto, é necessário que exista uma plataforma de MVNO **previamente configurada no sistema** para que o processo de uso deste formulário ocorra com êxito. 
As etapas de uso da integração consistem nos seguintes processos:

1. Configuração da integração de MVNO da plataforma credenciada;
2. Cadastro dos produtos de MVNO associados à integração;
3. Vinculo dos produtos de MVNO ao contrato do cliente;
4. Criação e ativação da linha MVNO através do formulário de [[linha telefonia movel mvno|Linha Telefonia Móvel MVNO]]. Nesta etapa ocorrerá a ativação da linha, que disponibilizará o consumo conforme o plano configurado.

### Casos de Uso

### Integração com Plataforma MVNO

>[!CAUTION] Atenção:
Acesse os manuais de configuração individuais de cada plataforma para efetuar o procedimento adequado.

O cadastro da integração é fundamental para possibilitar a gestão completa da integração no sistema, uma vez que estabelece a comunicação entre as plataformas e sincroniza o uso dos recursos disponíveis.

1. Acesse o formulário de [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]] através do caminho: Configurações > Integrações > Integração MVNO/Telefonia Móvel;
2. Pressione o botão **Novo**;
3. Selecione o MVNA que irá utilizar. Entre eles, estão: Americanet, Brazmóvel, Contel, EAI, Surf (Class-systems), Telecall, TGN e TIP;
4. Em seguida, preencha os demais campos apresentados, que serão exibidos conforme a plataforma selecionada;
5. Após preencher os campos, clique em Salvar para estabelecer a comunicação entre as plataformas.

>[!INFO] Atenção: 
Os dados a serem preenchidos para a integração são fornecidos pela plataforma credenciada, portanto, caso necessário, contate o MVNO em questão.

>[!SUCCESS] Finalização:
Após concluir o cadastro da integração, demais recursos relacionados ao uso da integração serão disponibilizados. Entre eles:
> - Criação do produto de MVNO;
> - Ativação de linhas MVNO;
> - Gerenciamento e controle de consumo de linhas.

## Funcionalidades Principais

### Dinamismo nos Campos
- O formulário apresenta campos que se adaptam dinamicamente com base na seleção do MVNA, proporcionando uma experiência de configuração intuitiva.
### Validação de Campos
- O sistema realiza validações dos campos obrigatórios e da integridade dos dados antes da submissão do formulário.

## Fluxo de Trabalho

```mermaid
graph TD
    A[Acesso ao Formulário] --> B[Seleção do MVNA]
    B --> C{Campos Dinâmicos}
    C --> D[Preenchimento dos Dados]
    D --> E[Validação]
    E --> F{Dados Válidos?}
    F -->|Sim| G[Salvar Configuração]
    F -->|Não| D
    G --> H[Configuração Concluída]
```

## Considerações Finais
A integração de uma **MVNO (Operadora Móvel Virtual)** no sistema representa um passo significativo para empresas que buscam otimizar suas operações de telecomunicações e melhorar a eficiência operacional. Esta integração oferece uma série de benefícios, incluindo uma gestão mais eficaz dos serviços móveis, melhor controle de custos e uma visão abrangente das operações de telecomunicações da empresa. A correta configuração do MVNO é crucial para garantir a alocação adequada de recursos e parametrizações específicas. Recomenda-se uma revisão cuidadosa de todas as informações antes de finalizar o processo de configuração.

## Etiquetas
#Integracoes #IntegracoesMVNO #TelefoniaMovel #LinhasMVNO 

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]]
- [[produtos ixc - mvno|Produtos IXC - MVNO]]
- [[relatorio mvno|Relatório MVNO]]
- [[dados adicionais mvno|Dados Adicionais MVNO]]
- [[status de portabilidade de linhas mvno|Status de Portabilidade de Linhas MVNO]]
- [[trocar titularidade - mvno|Trocar titularidade - MVNO]]
- [[aba linha mvno - contrato do cliente|Aba Linha MVNO - Contrato do Cliente]]
- [[consulta manual de portabilidade - mvno|Consulta manual de portabilidade - MVNO]]
- [[tarefa - consultar portabilidade|Tarefa - Consultar Portabilidade]]
- [[integracao de telefonia movel - americanet|Integração de Telefonia Móvel - Americanet]]
- [[integracao de telefonia movel - braz movel|Integração de Telefonia Móvel - Braz Móvel]]
- [[integracao de telefonia movel - contel|Integração de Telefonia Móvel - Contel]]
- [[integracao de telefonia movel - eai|Integração de Telefonia Móvel - Eaí]]
- [[integracao de telefonia movel - surf (class-systems)|Integração de Telefonia Móvel - Surf (Class-Systems)]]
- [[integracao de telefonia movel - telecall|Integração de Telefonia Móvel - Telecall]]
- [[integracao de telefonia movel - tgn|Integração de Telefonia Móvel - TGN]]
- [[integracao de telefonia movel - tip brasil|Integração de Telefonia Móvel - TIP Brasil]]
- [[integracao de telefonia movel - tip ta telecom|Integração de Telefonia Móvel - TIP Tá Telecom]]