# Integração TV Smart Tube

## Introdução

>[!TIP] Definição - Smart Tube:
>A [Smart Tube](https://smartlabs.tv/smarttube/), desenvolvida pela [SmartLabs](https://smartlabs.tv/), é uma plataforma especializada no gerenciamento e distribuição de serviços de TV através de diversas redes, incluindo IPTV e OTT. A plataforma disponibiliza um extenso portfólio de conteúdos, como TV ao vivo e VoD (Vídeo sob Demanda), oferecendo uma solução completa para empresas que buscam modernizar seus serviços de TV.

A integração entre a plataforma **Smart Tube** e o Sistema foi desenvolvida para aprimorar a gestão de serviços de telecomunicações e conteúdo digital, oferecendo uma plataforma unificada para provedores de internet. 

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

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

## Estrutura do Formulário
O formulário de **Integração TV Smart Tube** está organizado em uma guia composta por três abas principais, cada uma projetada para atender aspectos específicos relacionados às informações da integração:

- **Configuração Smart Tube:** Aba principal de configuração que permite realizar o registro dos dados API para a integração e então estabelecer a comunicação entre as plataformas para troca de dados.
- **[[produtos smart tube|Produtos Smart Tube]]:** Focada em registrar e classificar os produtos de TV relacionados à integração com a plataforma.
- **[[devices limit (limite de dispostivos) smart tube|Devices Limit (Limite de Dispostivos) Smart Tube]]:** Permite adicionar, editar ou excluir limites de dispositivos, garantindo um controle eficaz sobre a integração e operação do sistema.

### Aba Configuração Smart Tube
A aba **Configuração Smart Tube** permite o cadastro dos dados API sobre a integração, conforme os campos disponíveis. Esta aba organiza as informações essenciais para o gerenciamento da plataforma no sistema.

| **Campo**          | **Descrição**                                                                   |
| ------------------ | ------------------------------------------------------------------------------- |
| **IP**             | IP de acesso à plataforma.                                                      |
| **Porta**          | Porta de acesso à Smart Tube.                                                   |
| **Prefix**         | Prefixo utilizado para o cadastro do login dos usuários TV, informação inicial. |
| **Próximo Number** | Número que o sistema deve considerar para a geração de logins dos usuários TV.  |
### Aba [[produtos smart tube|Produtos Smart Tube]]
A aba [[produtos smart tube|Produtos Smart Tube]] está integrada ao formulário [[integracao tv smart tube|Integração TV Smart Tube]], permitindo a configuração e gestão de produtos vinculados à plataforma Smart Tube. Esta aba apresenta uma grid organizada em linhas e colunas, onde cada linha corresponde a um registro de produto. Os produtos são classificados em três categorias:

- **Pacote de canais**: conjunto básico de canais incluído na assinatura padrão do cliente.
- **Canal adicional**: canais adquiridos como complemento ao pacote principal.
- **Pacote inadimplência**: pacotes aplicados automaticamente em casos de bloqueio por inadimplência.

A grid possibilita o gerenciamento direto dos produtos, como edição, exclusão ou adição de novos registros, garantindo uma administração eficiente da oferta de serviços.

| Coluna                 | Descrição                                                                                                     |
| ---------------------- | ------------------------------------------------------------------------------------------------------------- |
| **ID**                 | Identificação única do registro do produto Smart Tube.                                                        |
| **Integração**         | ID da integração Smart Tube.                                                                                  |
| **Produto**            | Descrição do produto, respectivo ao campo de nome do cadastro do produto.                                     |
| **Finalidade produto** | Informa a classificação do produto, se **Pacote de canais**, **Canal adicional** ou **Pacote inadimplência**. |

### [[devices limit (limite de dispostivos) smart tube|Devices Limit (Limite de Dispostivos) Smart Tube]]
A aba de [[devices limit (limite de dispostivos) smart tube|Devices Limit (Limite de Dispostivos) Smart Tube]] é uma ferramenta focada na configuração e gerenciamento de restrições de dispositivos associados ao sistema, permitindo adicionar, editar ou excluir limites de dispositivos. Este limite permite o controle do número máximo de dispositivos que podem ser associados à uma conta Smart Tube. Esta aba consiste em uma grid, organizada em linhase colunas, onde cada linha corresponde a um registro de limite de dispositivos.

| Coluna                | Descrição                                            |
| --------------------- | ---------------------------------------------------- |
| **ID de Integração**  | Identificador único da integração                    |
| **Código plataforma** | Código do **Device Limit** que consta na Smart Tube. |

## Casos de Uso

### Implementação da Integração
Neste passo, realiza-se a configuração inicial da integração com os dados API fornecidos pela Smart Tube. Esse processo estabelece a comunicação entre o sistema e a plataforma Smart Tube, possibilitando a troca de dados essenciais, como informações de usuário e de conteúdo, para garantir a operação fluida entre as plataformas. Para prosseguir com a configuração, siga os passos a seguir:

> [!IMPORTANTE]
> Certifique-se de obter os dados necessários com os responsáveis da plataforma SmartTube antes de iniciar a configuração.

1. Acesse o formulário de [[integracao tv smart tube|Integração TV Smart Tube]] através do caminho: Configurações > Integrações > Integração TV Smart Tube;
2. Clique no botão **Novo** para registrar uma nova integração e preencha os campos apresentados:
	- **IP:** insira o endereço de IP da Smart Tube;
	- **Porta:** preencha a porta de acesso à Smart Tube;
	- **Prefix:** insira o prefixo utilizado para cadastro do login dos usuários TV;
	- **Próximo number:** insira o número que o sistema deve considerar para a geração de login do usuário TV.
	  
3. Clique em **Salvar** para validar a configuração e concluir o registro da integração.

>[!TIP] Exemplo prático:
>O **Prefix** define a parte inicial do login, criando um padrão para todos os usuários. O campo **Próximo Number** determina a sequência numérica para novos logins, seguindo a estrutura: **Prefixo + Número**.
>
>- **Exemplo:**
>	- Prefix: client_
>	- Próximo Number: 001
>	 - Resultado: client_001
>
>A cada novo login, o sistema incrementa automaticamente o número sequencial.

>[!INFO] Guia instrutivo:
> O manual completo com todas as instruções de implementação está disponível em: [[configuracao integracao tv smart tube|Integração TV - Smart Tube]]


## Fluxos de Trabalho

```mermaid
graph TD
    A[Início] --> B[Credenciamento Smart Tube]
    B --> C[Registro da Integração no IXC]
    
    C --> D[Estabelecimento de Comunicação]
    D --> D1[Troca de Dados]
    
    D1 --> E[Cadastro do Produto]
    E --> F[Registro no Contrato]
    
    F --> G[Ativação do Usuário TV]
    G --> H[Monitoramento de Acesso]
    
    H --> I{Status de Conexão}
    I -->|Ativo| J[Acesso Permitido]
    I -->|Inativo| K[Acesso Negado]
    
    J --> H
    K --> H
```

## Considerações Finais
A integração TV Smart Tube proporciona uma solução eficiente para provedores que desejam oferecer serviços de TV por streaming. É fundamental manter as credenciais atualizadas e realizar sincronizações periódicas para garantir o correto funcionamento da integração. Em caso de dúvidas ou problemas, consulte a documentação adicional ou entre em contato com o suporte técnico.

## Etiquetas
#Integracoes #IntegracoesTV #SmartTube #ProdutosSmartTube #UsuarioSmartTube

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de tv|Integrações de TV]]
- [[aba configuracao smart tube|Aba Configuração Smart Tube]]
- [[produtos smart tube|Produtos Smart Tube]]
- [[devices limit (limite de dispostivos) smart tube|Devices Limit (Limite de Dispostivos) Smart Tube]]
- [[cadastro de produtos smart tube|Cadastro de Produtos Smart Tube]]
- [[cadastro de device limit (limite de dispositivos) smart tube|Cadastro de Device Limit (Limite de Dispositivos) Smart Tube]]