# Usuários TV (Beta)

## Introdução

>[!tip] Atenção!
>Este conteúdo está presente na **versão [[clientes beta ixc soft|Beta]]** do sistema.
>A disponibilidade desta funcionalidade na **versão Estável** será a partir de Abril de 2025.

---

>[!TIP] **Definição - Usuário TV:**
>Um usuário TV é definido como um indivíduo que consome conteúdo audiovisual através de credenciais de acesso, utilizando um aparelho de televisão ou dispositivo móvel, dependendo da tecnologia de transmissão ou do tipo de serviço utilizado. A tecnologia utilizada pode variar, como streaming, transmissão digital ou TV por assinatura.

O usuário TV é um conjunto de credenciais de acesso que permite a utilização de serviços de streaming, IPTV, VoD e outras plataformas integradas ao sistema através das [[integracoes de tv|Integrações de TV]]. Este recurso viabiliza o acesso do cliente aos conteúdos disponibilizados e permite um gerenciamento eficiente através do contrato, unificando dados de internet e SVAs em uma única interface.

> [!NOTA] **Acesso ao Formulário:**
> **Caminhos:**
> 
> - Sistema > Cadastros > TV/SVA > Usuários TV
> 
> - Sistema > Contratos > aba TV

### Requisitos de Uso
Para utilizar o formulário de **Usuário TV**, é necessário fazer uso de uma integração de TV compatível com o sistema.

>[!EXAMPLE] Plataformas de TV que integram ao IXC Soft:
>- [[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]]
>- [[integracao tv smart tube|Integração TV - Smart Tube]]
>- [[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
O **Formulário de Usuário TV** é uma ferramenta complementar usada em conjunto com as integrações de TV no sistema. Este formulário é essencial para o cadastro do login de TV do cliente, permitindo a ativação e o acesso ao serviço especificado no contrato.
- Promove o gerenciamento eficiente de usuários de TV (ao utilizar uma integração de TV) de forma unificada e simplificada, centralizando as informações do cliente em um único lugar;
- Permite ativar, realizar o controle de acesso e cancelamento do usuário TV em um único ambiente;

>[!INFO] Espelhamento:
>Os usuários de TV são cadastrados no sistema e a partir da integração, são espelhadas na plataforma integrada. Portanto, os dados irão coexistir no sistema e na plataforma integrada ao que se refere a ativação do usuário e controle de acesso.

## Estrutura do Formulário
O formulário **Usuários TV** organiza todos os registros cadastrados em uma grid central, exibindo detalhes completos de cada usuário, independentemente da plataforma integrada. Ele permite cadastrar, editar e excluir usuários, além de gerenciar manualmente o controle de acesso.

Ao acessar o formulário de cadastro, são apresentados campos específicos que detalham as informações do usuário TV, facilitando a gestão e a personalização do acesso.

### Campos Principais
Abaixo são apresentados os campos principais para a configuração e gestão do acesso:

| Campos                       | Descrição                                                                                                                                             |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ID**                       | Registro de identificação único do usuário TV, gerado automaticamente pelo sistema ao cadastrar o login                                               |
| **ID do contrato**           | ID do contrato relacionado ao usuário TV                                                                                                              |
| **Plataforma**               | Plataforma integrada do qual o login TV foi ou será associado. Campo essencial para estabelecer a comunicação com a plataforma                        |
| **Tipo de tecnologia da TV** | Campo informativo sobre qual o tipo de tecnologia de TV este login utilizará, como IPTV, Streamig, entre outros                                       |
| **Senha**                    | Refere-se à senha de acesso, combinada ao usuário, utilizada como credencial de acesso à plataforma                                                   |
| **Login**                    | Refere-se ao usuário utilizado como credencial de acesso à plataforma                                                                                 |
| **Data de criação**          | Indica a data da qual o usuário TV foi criado no sistema. É registrada a partir do momento em que é salvo o login no sistema. Não é um campo editável |

### Campos Dinâmicos
Os campos dinâmicos consistem em elementos que são exibidos na interface conforme condições específicas.No caso de integração com plataformas de TV, estes campos são apresentados de acordo com a plataforma selecionada, pois cada uma requer informações particulares para a ativação do usuário.

| Campos                    | Descrição                                                                                                                             |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Account ID**            | Número de identificação do login na plataforma, preenchido como retorno da API                                                        |
| **Account number**        | Número de identificação do login na plataforma, preenchido como retorno da API                                                        |
| **Birthday**              | Data de nascimento do cliente para controle de conteúdo                                                                               |
| **Dispositivos**          | Define a quantidade de dispositivos permitidos para acesso com este login                                                             |
| **ID login plataforma**   | Número de identificação do login na plataforma, preenchido como retorno da API                                                        |
| **MAC Devices**           | Numeração MAC do equipamento para autenticação do login                                                                               |
| **Online**                | Indica se o login está online ou offline                                                                                              |
| **Pin**                   | Código PIN para acesso aos conteúdos                                                                                                  |
| **Portal**                | Define o portal utilizado pelo login                                                                                                  |
| **Produtos/Serviço**      | Associa o login TV a um produto específico, determinando o acesso do cliente à plataforma/plano                                       |
| **Status**                | Indica se o login está ativo ou inativo                                                                                               |
| **Usar e-mail principal** | Permite utilizar o e-mail cadastrado no campo **E-mail principal** da aba **Contato** para integrações que exigem validação de e-mail |

>[!CAUTION] Atenção:
>A exibição dos campos é dinâmica e depende da plataforma selecionada. Nem todos os campos estarão disponíveis em todas as integrações, pois cada plataforma possui requisitos específicos para sua configuração.

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

1. Configuração da integração de TV da plataforma credenciada;
2. Cadastro dos produtos de TV associados à integração;
3. Vinculo dos produtos de TV ao contrato do cliente;
4. Criação do usuário TV através do formulário **Usuário TV**. Nesta etapa ocorrerá a ativação do login, que disponibilizará o acesso à plataforma.

## Funcionalidades Principais

>[!NOTA] **Importante:**
>As funcionalidades **podem variar** conforme a integração, de acordo com a plataforma definida no campo **Plataforma**.

### Cadastro de Credenciais
O sistema permite realizar a inclusão de dados de acesso do usuário, isto é, as credenciais das quais o usuário irá utilizar para realizar o acesso à plataforma. Alguns campos referente à inclusão dos dados do login incluem Login, Senha, Profile name, Pin, entre outros.

### Seleção do Produto de TV
Permite a seleção de produtos disponíveis de acordo com o contrato do qual está sendo vinculado o produto. Este será o produto ou pacote do qual o cliente terá acesso na plataforma. 
**Campo responsável:** "Produto/Serviço".
Disponível para as seguintes integrações:
- [[integracoes tv - eitv|Integrações TV - EiTV]]
- [[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 - watch tv|Integrações TV - Watch TV]]

### Buscar Portal
Função para localizar portais associados ao usuário. 
**Campo responsável:** Portal.
Disponível para as seguintes integrações:
- [[integracoes tv - youcast|Integrações TV - YouCast]]
- [[integracoes tv - panaccess|Integrações TV - Panaccess]]

### Buscar Equipamentos
Associa ao usuário TV um equipamento quanto existe a necessidade de autenticação do aparelho. Campo responsável: Equipamentos.
Disponível para a integração com a plataforma [[integracoes tv - oletv|Integrações TV - OléTV]]

### Associação ao SmartCards
Ao utilizar a integração com a Panaccess, a aba [[smartcard panaccess|SmartCard Panaccess]] fica associada ao formulário de Usuários TV, permitindo o vínculo do usuário TV Panaccess ao SmartCard.

> [!INFO] **Informação:**
> O formulário de SmartCards, associado ao usuário TV, é de uso exclusivo para a integração **Panaccess**.

### Ativar e Desativar
Ao utilizar integrações de TV que utilizam o controle de status do login para estabelecer o acesso do cliente, o sistema permite gerenciar o acesso do usuário TV independentemente do contrato, oferecendo controle individual sobre sua ativação e inativação.

### Data de Criação
Permite emitir relatórios e verificar o período de ativação de usuários TV.

## Fluxo de Trabalho

```mermaid
graph TD
    A[Início] --> B[Configuração da integração de TV da plataforma credenciada]
    B --> C[Cadastro dos produtos de TV associados à integração]
    C --> D[Vínculo dos produtos de TV ao contrato do cliente]
    D --> E[Criação do usuário TV através do formulário 'Usuário TV']
    E --> F[Ativação do login]
    F --> G[Disponibilização do acesso à plataforma]
    G --> H[Fim]
```

## Considerações Finais
A gestão de usuários de TV é fundamental para o controle eficiente dos acessos de TV associados aos contratos no sistema. Esta funcionalidade oferece uma visão centralizada, permitindo que administradores e equipes de suporte monitorem, gerenciem e otimizem a experiência dos usuários de TV de maneira eficaz. Ao consolidar informações e ferramentas de gestão, este recurso facilita a rápida identificação de problemas, implementação de melhorias e manutenção de um serviço de alta qualidade, contribuindo para aumentar a satisfação do cliente e fortalecer a posição da empresa no mercado de serviços de TV.

- Sempre verifique a consistência dos dados antes de salvar um novo usuário ou atualizar um existente.
- A sincronização de dados é crucial para manter a integridade das informações em todo o sistema.
- Utilize as funções de busca e filtro para gerenciar eficientemente grandes volumes de usuários.

## Etiquetas
#Integracoes #IntegracaoTV #UsuarioTV 

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de tv|Integrações de TV]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[aba - tv - contrato do cliente|Aba TV - Contrato do cliente]]
- [[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ção TV - Smart Tube]]
- [[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 - youcast|Integrações TV - YouCast]]