# Integrações TV - Ministra (v2)
Este guia aborda a integração entre os serviços Ministra e o Sistema, permitindo uma gestão eficiente e centralizada de serviços de streaming e TV para provedores de internet.

>[!TIP] O que é a Ministra?
> A Ministra (v2) é uma plataforma de serviços de televisão por protocolo de internet (IPTV), vídeo sob demanda (VoD) e OTT, que disponibiliza conteúdos de televisão ao vivo, programas de televisão e filmes, os quais são fornecidos de maneira exclusiva pelo provedor de serviços.

## Introdução
A integração Ministra com o Sistema visa otimizar a oferta de serviços de comunicação e multimídia, centralizando informações e fornecendo uma solução completa para provedores de internet. Esta integração permite:

- Compatibilidade com a plataforma Ministra v2;
- Gerenciamento facilitado de serviços de TV e streaming;
- Centralização de informações do provedor;
- Gestão eficiente de clientes e receitas;
- Controle automatizado de inadimplência.

> [!NOTA] Acesso ao Formulário
> Caminho: Configurações > Integrações > Integrações TV


>[!TIP] Credenciais:
>Assim que o seu provedor (ISP) realizar o credenciamento junto a plataforma citada, serão fornecidos os dados necessários para realizar a integração com o ERP IXC Soft. A partir destes dados, é possível realizar o cadastramento da integração no IXC, conforme o material a seguir.

## Entrega de valor
- Alinhar as necessidades dos clientes que utilizam streaming e TV por assinatura com a plataforma Ministra;
 - Centralizar as informações do provedor em um único local e facilitar o gerenciamento de inadimplentes, gestão de clientes e faturamento mensal.
- Simplificação do processo de ativação e manutenção de clientes;
- Otimização do controle de inadimplência.

## Configuração da Integração

### Passo 1: Acesso ao formulário de Integrações
Neste passo, é efetuado o cadastro da integração. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma Ministra.

1. No menu principal, navegue até **Configurações**;
2. Selecione **Integrações**;
3. Clique em **Integrações TV**;
4. Pressione o botão **Novo**;
5. Selecione **Ministra** no campo **Plataforma**;
6. Preencha os campos:
	- **IP Integração:** este campo se refere à URL fornecida pela plataforma credenciada. Ela é responsável por "liberar o acesso" do sistema IXC Soft à plataforma PlayHub para estabelecer a comunicação entre as plataformas envolvidas;
	- **Login TV:** refere-se à informação do usuário API na Ministra, informação fornecida pela plataforma;
	- **Senha TV:** refere-se à informação de senha do usuário API na Ministra, informação fornecida pela plataforma;
	- **ID filial:** selecione a filial da qual a integração pertence. Filial da qual os dados serão considerados, de acordo com a filial do contrato do cliente.

7. Clique em **Salvar** para estabelecer a comunicação entre o IXC e a plataforma e para concluir o cadastro da integração.

### Passo 2: Configuração do produto de TV
O cadastro do produto de TV é essencial para a gestão do produto no contrato, faturamento e também para permitir a ativação do usuário TV, pois o produto se relaciona com a integração pelos pacotes disponibilizados pela plataforma.

>[!INFO] O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.

1. No menu principal, navegue até **Sistema**;
2. Selecione **Cadastros**;
3. Clique em **Produtos**;
4. Pressione o botão **Novo**;
5. Preencha os campos obrigatórios na aba **Produtos** e na aba **Planejamento**;
6. Acesse a aba **TV**;
7. No campo **Plataforma**, selecione a opção **Ministra**;
8. Preencha os campos:
	- **ID integração:** clique sobre a lupa e selecione a integração cadastrada para a Ministra;
	- **Tarifas:** clique sobre o botão **Buscar tarifas**. O sistema irá apresentar os planos que foram disponibilizados pela plataforma Ministra v2. Selecione o plano correspondente ao produto que está cadastrando.
	
9. Clique em **Salvar** para validar e finalizar o cadastro do produto.

### Passo 3: Produto no contrato
Para realizar a gestão do contrato efetivamente, é necessário vincular o produto de TV ao contrato. Esta ação permite realizar a geração do faturamento, emitir notas fiscais e também efetuar ativação do usuário TV associado à integração. Esta ativação pode ocorrer diretamente pelo contrato ou por [[formulario planos de venda|Formulário Planos de Venda]].

1. No menu principal, navegue até **Sistema**;
2. Selecione **Cadastros**;
3. Clique em **Contrato**;
4. Pressione o botão **Editar** para acessar o contrato;
5. Navegue até a aba **Produtos** e clique no botão **Novo**. Defina o tipo do produto como **TV/Streaming** e no campo **Produto/Serviço**, clique na lupa e selecione o produto de TV cadastrado. Clique em **Salvar** para validar as configurações.

### Passo 4: Ativação do usuário TV
A ativação do usuário TV consiste em criar as credenciais de acesso para o usuário final obter acesso à plataforma.

1. Ainda no contrato do cliente, navegue até a **aba TV**;
2. Clique no botão **Novo** e preencha os campos apresentados:
	- **Plataforma:** no botão de seleção, selecione a opção Ministra (novo);
	- **API:** selecione a opção **Alterar na API e no IXC** para ter comunicação com a plataforma. Ao utilizar a opção **Ignorar API e alterar apenas no IXC**, não obtém comunicação com a Watch e, portanto, não envia a requisição de criação de usuário à plataforma, criando somente no sistema;
	- **Tipo de tecnologia TV:** defina o tipo de tecnologia do produto;
	- **Produto/Serviço:** clique sobre a lupa e selecione o produto de TV vinculado ao contrato;
	- **Login:** refere-se ao login de acesso à plataforma. Deve ser um e-mail válido;
	- **Senha:** clique em **Gerar senha** para gerar uma senha aleatória ou preencha manualmente;
	- **Account number:** campo preenchido automaticamente ao estabelecer a comunicação do login após salvá-lo. É o ID usuário TV criado na plataforma;
	- **Online:** preenchido de acordo com o status de acesso do contrato. Se **online**, indica que está ativado e consumindo. Se **offline**, está bloqueado.
	
3. Após preencher os campos, clique em **Salvar** para validar as modificações e efetivar a criação do usuário TV.

Após realizar a ação de todos os passos, o usuário TV estará pronto para uso. O controle de acesso é feito diretamente pelas ações do contrato (bloqueio e liberação).

>[!Caution] **Lembrete:** depois de criado o login, o sistema não permitirá sua edição.

## Casos de Uso

### Ações do contrato
A integração com a plataforma da Ministra valida ações sobre o contrato, impactando no acesso do usuário TV, permitindo o controle de acesso pelo sistema e espelhando na plataforma credenciada.
#### Controle de acesso do usuário TV a partir do status do contrato:

A integração com a plataforma Ministra valida as seguintes ações sobre o contrato, impactando no acesso do usuário TV. Estas ações incluem:

- **Bloqueio manual ou automático:** em casos de bloqueio automático ou manual devido inadimplência, o login TV terá seu acesso interrompido.

- **Liberação automática:** ocorre sob pagamento, no momento em que o contrato é ativado, liberando o acesso à plataforma.

- **Liberação manual:** o login volta a constar como online e libera o acesso à plataforma.
  
>[!DANGER] **Atenção:**
>Evite deletar um usuário TV diretamente pelo painel de controle da Ministra. A comunicação entre as plataformas ocorre apenas de IXC Provedor para a Ministra, portanto, alterações feitas na plataforma não serão consideradas no IXC Provedor.  
> 
> Em caso de deleção do usuário TV, o sistema perderá a comunicação com a plataforma e não permitirá mais alterações no usuário TV através do IXC.

## Conclusão
A integração Ministra v2 com o sistema oferece uma solução robusta para provedores de internet, simplificando a gestão de serviços de TV e streaming. Esta tecnologia melhora a eficiência operacional, reduz erros de informação e proporciona uma experiência superior aos clientes.

## Etiquetas
#IntegracaoTV #Ministrav2 

## Para mais informações sobre funcionalidades específicas, consulte:
- [[integracoes|Integrações]]
- [[integracoes de tv|Integrações de TV]]