# Integrações TV 

## Introdução

>[!tip] Atenção!
>Este conteúdo contém informações de funcionalidades presentes na **versão [[clientes beta ixc soft|Beta]]** do sistema.
>A disponibilidade do recurso, atualmente em **Beta**, será lançado na **versão Estável** será a partir de Abril de 2025.

---

> [!TIP] Definição:
>Integração é o processo de conectar diferentes softwares à um sistema, para que ocorra a troca de informações e funcione de forma coordenada e centralizada. 

O módulo de Integrações TV é uma ferramenta crucial para provedores de serviços que combinam ofertas de TV com pacotes de internet. Este recurso permite a configuração, manutenção e gerenciamento eficiente das conexões entre o sistema da empresa e diversas plataformas de TV.

O formulário de **Integrações de TV** do sistema IXC Soft é uma ferramenta essencial para gerenciar e configurar integrações com plataformas de serviços de TV e Streaming. Esta funcionalidade permite uma operação eficiente e personalizada para cada parceiro de negócios.

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

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

>[!EXAMPLE] Plataformas de TV que integram ao sistema:
>- [[private/arquivados/integracoes gerais/integracoes tv - apptec|Integrações TV - Apptec]]
>- [[integracoes tv - combate|Integrações TV - Combate]]
>- [[integracoes tv - globosat play|Integrações TV - GloboSat Play]]
>- [[integracoes tv - hubneo|Integrações TV - HubNeo]]
>-  [[integracoes tv - hubneo directvgo|Integrações TV - HubNeo DirecTvGo]]
>- [[integracoes tv - ittv|Integrações TV - ITTV]]
>- [[integracoes tv - ministra|Integrações TV - Ministra]]
>- [[integracoes tv - ministra (v2)|Integrações TV - Ministra (v2)]]
>- [[integracoes tv - multtv|Integrações TV - MultTV]]
>- [[integracoes tv - nxplay|Integrações TV - NxPlay]]
>- [[integracoes tv - oletv|Integrações TV - OléTV]]
>- [[integracoes tv - panaccess|Integrações TV - Panaccess]]
>- [[integracoes tv - playhub|Integrações TV - PlayHub]]
>- [[public/menu configuracoes/integracoes/integracoes tv/integracoes tv - sattv go|Integrações TV - SatTV Go]]
>- [[configuracao integracao tv smart tube|Integrações TV - SmartTube]]
>- [[integracoes tv - sky+ multtv sa|Integrações TV - Sky+ MultTv SA]]
>- [[integracoes tv - telecine|Integrações TV - TeleCine]]
>- [[integracoes tv - watch tv|Integrações TV - Watch TV]]
>- [[integracoes tv - watch espn|Integrações TV - Watch ESPN]]
>- [[integracoes tv - youcast|Integrações TV - YouCast]]

## Entrega de Valor
- Permite oferecer serviços de TV integrados à internet;
- Automatiza processos de bloqueio e cancelamento de assinaturas de TV;
- Centraliza o gerenciamento de clientes de TV e internet em uma única plataforma;
- Permite o gerenciamento de usuários e produtos relacionados aos serviços de TV.

### Conceitos Fundamentais

> [!TIP]  Definições:
>- **Integração TV**: Conexão estabelecida entre o sistema e uma plataforma de TV para gerenciamento de serviços.
>- **Plataforma de TV**: Serviço de streaming ou TV por assinatura integrado ao Sistema.
>- **Usuário TV**: Cliente final que utiliza os serviços de TV oferecidos através da integração.

## Estrutura do Formulário
O módulo **Integrações TV** é estruturado em dois componentes principais: uma **grid** de visualização e um **formulário** de cadastro. A **grid** de visualização exibe uma visão geral de todas as integrações TV cadastradas, organizada em linhas e colunas para fácil leitura e análise. Ela apresenta informações-chave sobre cada integração, permitindo uma rápida identificação e acesso aos detalhes, facilitando assim a navegação e o gerenciamento das integrações existentes.

O formulário de **cadastro** oferece uma interface dedicada para adicionar novas integrações ou editar as existentes. Este formulário captura dados essenciais para estabelecer a comunicação efetiva entre os sistemas, incluindo campos para configuração dos parâmetros técnicos necessários à integração. Ele permite uma configuração detalhada e personalizada para cada plataforma de TV.

### Aba Integrações TV
A aba **Integrações** permite o cadastro da integração de TV com base nos dados API fornecidos pela plataforma credenciada, dos quais irão autorizar a autenticação e acesso da aplicação para ocorrer a comunicação entre o sistema e a plataforma de TV. Isso possibilita o gerenciamento da plataforma diretamente pelo sistema, como o cadastro de planos, a ativação de usuários e gerenciamento de contratos.

Esta aba consiste na apresentação de campos dinâmicos apresentados de acordo com cada tipo de integração, isto é, os campos variam conforme a plataforma credenciada. 

#### Campos Principais

| Campo          | Descrição                                                                                                                                                                                                         | Obrigatório |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| **ID**         | Identificador único para a integração.                                                                                                                                                                            | Sim         |
| **Tipo**       | Tipo de integração (selecionável via menu suspenso).                                                                                                                                                              | Sim         |
| **Descrição**  | Campo para descrever a integração de forma detalhada. Exemplo: incluir o nome da plataforma para identificação                                                                                                    | Não         |
| **Plataforma** | Seção específica para integração do tipo **TV**, onde se escolhe a plataforma correspondente. Após selecionar uma das plataformas neste campo, são disponibilizados demais campos respectivos à opção selecionada | Não         |

>[!NOTA] Configuração:
>Para cadastrar uma integração de TV, prossiga com a configuração específica para a plataforma selecionada, confira o manual individual para cada plataforma.

## Casos de Uso

### Configuração de Nova Integração

1. Acesse o formulário de **Integrações TV** através do caminho: Configurações > Integrações > Integrações TV;
2. Clique no botão **Novo**;
3. Selecione a plataforma desejada (ex: Olé TV, Watch TV);
4. Preencha os dados de autenticação apresentados pelo sistema com as informações fornecidas pela plataforma;
6. Salve a configuração clicando no botão **Salvar**.

>[!TIP] Manual:
>Confira os manuais individuais de integração para cada plataforma para a utilização adequada da funcionalidade.

### Deleção de Integrações de TV

> [!tip] **Beta:**  
> A funcionalidade de impedimento de deleção de integrações de TV está disponível apenas para clientes na versão Beta. A partir de **abril de 2025**, ela será liberada para todos os usuários.

O sistema **não permite** a deleção de integrações de TV que possuam logins vinculados. Isso ocorre porque, ao deletar a integração, o sistema perde a comunicação com a plataforma, tornando impossível a remoção dos logins de TV. Portanto, a integração de TV só poderá ser deletada quando **não houver mais logins de TV associados** a ela.

> [!CAUTION] **Atenção (versão Estável):**  
> A deleção de uma integração de TV **não é recomendada** se ainda existirem logins de TV relacionados. Esse processo interrompe a comunicação entre as plataformas, impactando diretamente a usabilidade da integração no sistema e impedindo qualquer ajuste nos usuários de TV, incluindo a deleção.

## Funcionalidades Principais

### Controle de Acesso do Usuário TV
Sincroniza o status dos assinantes entre o sistema e a plataforma de TV, baseado nas ações do contrato
- **Comportamentos (ações do contrato):**
    - **Ativação:** Libera acesso à plataforma de TV ao ativar o contrato
    - **Bloqueio:** Interrompe o acesso em caso de inadimplência
    - **Liberação:** Restaura o acesso após pagamento
    - **Cancelamento:** Cancela o acesso na plataforma de TV
    - **Deleção:** Remove o usuário da plataforma de TV
      
>[!CAUTION] Atenção:
>Confira as ações disponíveis para cada integração de TV. As ações do contrato podem variar conforme a integração de TV.
### Gerenciamento de Planos
- Permite vincular produtos do sistema a planos específicos da plataforma de TV;
- Facilita a oferta de pacotes combinados de internet e TV.


## Fluxo de Trabalho

```mermaid
graph TD
    A[Configurar Integração] --> B[Vincular Planos]
    B --> C[Adicionar Produto TV em Contrato]
    C --> D[Definir Usuário TV]
    D --> E{Status do Contrato}
    E -->|Ativo| F[Liberar Acesso]
    E -->|Bloqueado| G[Bloquear Acesso]
    E -->|Cancelado| H[Remover Acesso]

```

## Considerações Finais
O formulário de Integrações TV é uma ferramenta poderosa para gerenciar conexões com plataformas de TV, permitindo uma oferta de serviços mais ampla e integrada. Esta estrutura oferece uma abordagem eficiente para o gerenciamento de integrações TV, combinando uma visão abrangente na grid com a capacidade de configuração detalhada no formulário. Isso resulta em um fluxo de trabalho otimizado para administradores e técnicos, facilitando tanto a supervisão geral quanto o ajuste preciso das integrações de TV no sistema.

## Etiquetas
#Integracoes #IntegracoesTV #TV 

## Leia Também
- [[integracoes|Integrações]]
- [[cadastro de produtos|Cadastro de Produtos]]
- [[gestao de contratos no sistema|Gestão de Contratos no Sistema]]
- [[private/arquivados/integracoes gerais/integracoes tv - apptec|Integrações TV - Apptec]]
- [[integracoes tv - combate|Integrações TV - Combate]]
- [[integracoes tv - globosat play|Integrações TV - GloboSat Play]]
- [[integracoes tv - hubneo|Integrações TV - HubNeo]]
- [[integracoes tv - hubneo directvgo|Integrações TV - HubNeo DirecTvGo]]
- [[integracoes tv - ittv|Integrações TV - ITTV]]
- [[integracoes tv - ministra|Integrações TV - Ministra]]
- [[integracoes tv - ministra (v2)|Integrações TV - Ministra (v2)]]
- [[integracoes tv - multtv|Integrações TV - MultTV]]
- [[integracoes tv - nxplay|Integrações TV - NxPlay]]
- [[integracoes tv - oletv|Integrações TV - OléTV]]
- [[integracoes tv - panaccess|Integrações TV - Panaccess]]
- [[integracoes tv - playhub|Integrações TV - PlayHub]]
- [[public/menu configuracoes/integracoes/integracoes tv/integracoes tv - sattv go|Integrações TV - SatTV Go]]
- [[configuracao integracao tv smart tube|Integrações TV - SmartTube]]
- [[integracoes tv - sky+ multtv sa|Integrações TV - Sky+ MultTv SA]]
- [[integracoes tv - telecine|Integrações TV - TeleCine]]
- [[integracoes tv - watch tv|Integrações TV - Watch TV]]
- [[integracoes tv - watch espn|Integrações TV - Watch ESPN]]
- [[integracoes tv - youcast|Integrações TV - YouCast]]
- [[aba - tv - contrato do cliente|Aba TV - Contrato do cliente]]
- [[public/menu sistema/cadastros/pasta tv sva/login tv/usuarios tv|Usuários TV]]