# Integrações TV - Olé TV

## Introdução

>[!TIP] Definição - Olé TV
> A **[Olé TV](https://www.ole.tv.br/?utm_term=ol%C3%A9%20tv&campaignid=20591123968&adgroupid=157644183527&adid=675149643304&targetid=kwd-2278416147290&gad_source=1&gclid=Cj0KCQiAvbm7BhC5ARIsAFjwNHvqir13dzgUGX4hlAu2CfD4xZmot33qKgTBoujnAJ5bYKMHMIB2SGwaAlR9EALw_wcB)** é uma plataforma de serviços de transmissão de conteúdos de TV por assinatura e streaming através da internet. A Olé TV disponibiliza:
> - Uma plataforma de IPTV e OTT, que permite a transmissão de conteúdo digital, como canais lineares e VOD;
> - Os conteúdos podem ser assistidos em vários dispositivos, como celular, TV, tablet e notebook.

A integração **[Olé TV](https://www.ole.tv.br/?utm_term=ol%C3%A9%20tv&campaignid=20591123968&adgroupid=157644183527&adid=675149643304&targetid=kwd-2278416147290&gad_source=1&gclid=Cj0KCQiAvbm7BhC5ARIsAFjwNHvqir13dzgUGX4hlAu2CfD4xZmot33qKgTBoujnAJ5bYKMHMIB2SGwaAlR9EALw_wcB)** 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:
- 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

## Entrega de Valor
- Alinhar as necessidades dos clientes que utilizam streaming e TV por assinatura com a plataforma Olé TV;
 - 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.

### Requisitos de Uso
Para utilizar este recurso no sistema, é necessário atender as seguintes condições:
- Solicitar à Olé TV a liberação do endereço IP do sistema IXC para acesso, permitindo a troca de dados entre o sistema IXC e a Olé TV.

## Configuração da Integração

>[!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.

>[!Caution] Atenção:
>Para prosseguir com o cadastro da integração do sistema IXC Soft com a plataforma Olé TV, é necessário solicitar para a Olé TV a liberação do IP de seu sistema. Entre em contato com a equipe da Olé TV para obter as informações e orientações necessárias.

### Passo 1: Cadastro da Integração
Para estabelecer a comunicação entre o sistema e a **Olé TV** e realizar o gerenciamento da integração diretamente pelo sistema, é necessário efetuar o cadastro da integração, permitindo a troca de dados entre as plataformas envolvidas. Siga o passo a passo abaixo:

1. Acesse o formulário de [[integracoes de tv|Integrações de TV]] através do caminho: Configurações > Integrações > Integrações TV;
2. Pressione o botão **Novo**;
3. Selecione **Olé TV** no campo **Plataforma**;
4. Preencha os campos:
	- **Ambiente:** 
		- **Produção:** o ambiente de produção é compreendido como um ambiente em que o usuário possui acesso ao produto final, onde os dois sistemas estão conectados e trocam informações em um ambiente real com o produto final ativo em uso. Mantenha a opção de ambiente de Produção para manter o uso da OléTV ativo em seu sistema, possibilitando a criação efetiva de produtos e usuários TV.
		- **Homologação:** o ambiente de homologação é compreendido como um ambiente de testes, separado do ambiente de produção, sem impactar diretamente no uso final da integração como produto.
		  
	- **Token acesso:** preencha com a informação de token de acesso fornecida pela plataforma credenciada;
	- **Login TV:** refere-se à informação de usuário API, informação fornecida pela plataforma;
	- **Senha TV:** refere-se à informação de senha do usuário API, informação fornecida pela plataforma;
	
5. Clique em **Salvar** para estabelecer a comunicação entre o IXC e a plataforma e para concluir o cadastro da integração.

   
>[!CAUTION] **Importante:** 
>As informações de **Token acesso**, **Login TV** e **Senha TV** são fornecidas pela própria Olé TV e não se referem às mesmas utilizadas para acesso a plataforma da Olé TV, são exclusivas para a integração API.

### 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] Importante:
>O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.

1. Acesse o formulário de [[cadastro de produtos|Cadastro de Produtos]] através do caminho: Sistema > Cadastros > Produtos;
2. Clique no botão **Novo**;
3. Preencha os campos obrigatórios na aba **Produtos** e na aba **Planejamento**;
4. Acesse a aba **TV**;
5. No campo **Plataforma**, selecione a opção **Olé TV**;
6. Preencha o campo:
	- **ID Integração:** clique na lupa e selecione o cadastro da integração de TV da Olé TV e vincule ao campo;
	- **ID Pacote:** clique sobre o botão **Buscar pacote** e selecione um pacote para o produto que está cadastrando. Este pacote é referente ao pacote principal que será disponibilizado ao cliente;
	- **ID Pacotes Adicionais:** caso o produto principal possua um pacote adicional, clique sobre o botão **Buscar pacotes** e selecione os produtos dos quais serão associados ao produto adicional. O mesmo produto pode ser inserido mais de uma vez.
	
8. Clique em **Salvar** para validar e finalizar o cadastro do produto.

>[!TIP] **Observação:**
> Se o cliente estiver utilizando equipamento, no campo **ID Pacotes Adicionais**, o pacote **Ponto adicional** deve ser incluído.

>[!DANGER] Atenção:
>Tenha atenção ao realizar o cadastro correto de um produto Olé TV. Uma vez cadastrado, não permitirá alterações.

### 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 **TV/Streaming**, 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 Olé TV;
	- **Tipo de tecnologia TV:** defina o tipo de tecnologia do produto;
	- **Produto:** clique na lupa e selecione o produto de TV incluso no contrato;
	- **Usar e-mail principal:** se **sim**, utiliza o e-mail do cadastro do cliente. Se **não**, preencher manualmente;
	- **Login:** refere-se ao login de acesso à plataforma. Deve ser um e-mail válido;
	- **MAC Devices:** insira o serial do equipamento disponibilizado ao cliente, caso esteja utilizando-o;
	- **Account number:** campo preenchido automaticamente ao estabelecer a comunicação do login após salvá-lo. É o ID usuário TV criado na plataforma;
	- **Equipamentos:** preencha com o modelo do aparelho, selecionando o botão "Buscar equipamentos" e realizando a inserção da informação no campo;
	- **Online:** indica o status do usuário TV, se Online ou Offline.
	
3. O campo **Online** é apresentado automaticamente de acordo com o status do login na plataforma, permitindo o controle de acesso pelo sistema de acordo com as alterações no contrato;
4. Após preencher os campos, clique em **Salvar** para validar as modificações e efetivar a criação do usuário TV.

>[!SUCCESS] Finalização:
>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] Atenção:
>O usuário TV somente é **ativado** de fato a partir do **primeiro acesso** do cliente à plataforma da OléTV. Caso não tenha acessado, permanecerá como **inativo.** 

## Casos de Uso

### Ações do Contrato
A integração com a plataforma da Olé TV 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 com Base no Status do Contrato:

> [!Note] Observação:
>  As ações do contrato são pertinentes aos logins que já efetuaram o acesso à plataforma pelo menos uma vez, sendo assim, o login é efetivamente ativado. Portanto, o usuário TV precisa estar como ativo para assumir qualquer outro status, caso contrário, constará como "Aguardando ativação" na Olé TV e não irá assumir quaisquer dos status listados abaixo.

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

- **Bloqueio/aviso atraso/desativar:** bloqueia o acesso à plataforma e ao editar o usuário, o login constará como “Offline”.
- **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.
- **Aguardando assinatura:** irá constar como online, acesso liberado.

>[!DANGER] **Atenção:**
> Evite deletar um usuário TV diretamente pelo painel de controle da Olé TV. A comunicação entre as plataformas ocorre apenas de IXC Provedor para a Olé TV, 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.

## Considerações Finais
A integração Olé TV 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
#Integracoes #IntegracoesTV #IntegracaoOleTV #OleTV

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de tv|Integrações de TV]]
- [[cadastro de produtos|Cadastro de Produtos]]
- [[cadastro de contratos no sistema|Cadastro de contratos no Sistema]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[aba - tv - contrato do cliente|Aba TV - Contrato do cliente]]
- [[public/menu sistema/cadastros/pasta tv sva/login tv/usuarios tv|Usuários TV]]
- [[formulario cliente|Formulário Cliente]]