# Configuração da Integração TV Smart Tube (Beta)

## Introdução

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

---

>[!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 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. Com esta solução, sua empresa consegue:
- Simplificar a administração dos serviços de TV e streaming;
- Unificar todos os dados do provedor em um único ambiente;
- Otimizar o gerenciamento de clientes e fluxo de receitas;
- Automatizar o monitoramento e controle de inadimplência.

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

## Configuração da Integração

### Passo 1: Acesso ao Formulário de Integrações
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.

### 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 códigos disponibilizados pela plataforma.

>[!INFO] Informação:
>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** para registrar um novo produto associado à integração, que será fornecido ao cliente;
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 **SmartTube**;
6. Clique em **Salvar** para validar e finalizar o cadastro do produto.

Após essa etapa, é necessário realizar o vinculo do produto criado com produto Smart Tube. Para isso, siga os passos a seguir:

1. No menu principal, acesse **Configurações;
2. Selecione **Integrações;
3. Clique em **Integração TV Smart Tube**;
4. Acesse a aba **[[produtos smart tube|Produtos Smart Tube]]**;
5. Clique em **Novo** para realizar o cadastro do produto Smart Tube;
6. Preencha os campos abaixo:
	- **Finalidade do Produto:** Defina qual será a finalidade desse produto, se será utilizado como pacote de canais principal, canais adicionais ou pacote inadimplência.
	- **Produto:** Selecione o produto que fará vinculo com a Smart Tube e será usado para faturamento dentro do contrato.
	- **Código da Plataforma:** Preencha com o código do produto que consta na Smart Tube.
	- **[[devices limit (limite de dispostivos) smart tube|Devices Limit (Limite de Dispostivos) Smart Tube]]:** Defina os limites de dispositivos simultâneos para esse produto.
	  
7.  Clique em **Salvar** para validar as informações e finalizar o cadastro do produto Smart Tube.

### 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. Acesse o formulário de [[formulario contrato do cliente|Formulário Contrato do Cliente]] através do caminho: Sistema > Cadastros > Contratos;
2. Pressione o botão **Editar** para acessar o contrato;
3. 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.

 >[!CAUTION] Atenção:
 >Para esta etapa, é essencial selecionar apenas os produtos que estejam cadastrados em [[produtos smart tube|Produtos Smart Tube]] e que possuam a classificação específica de **Pacotes de Canais**. Esta seleção é fundamental para o correto funcionamento do sistema.


### Passo 4: Produtos Adicionais
Além disso, também é possível inserir canais adicionais dentro do contrato do cliente. Para isso, é necessário vincular um produto de TV em serviços adicionais.

1. Acesse o formulário de [[formulario contrato do cliente|Formulário Contrato do Cliente]] através do caminho: Sistema > Cadastros > Contratos;
2. Pressione o botão **Editar** para acessar o contrato;
3. Navegue até a aba **Serviços Adicionais** 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 como pacote adicional. No campo **ID Login TV** selecione o usuário TV que terá acesso ao produto adicional. Clique em **Salvar** para validar as configurações.

 >[!CAUTION] Atenção:
 >Para esta etapa, é essencial selecionar apenas os produtos que estejam cadastrados em [[produtos smart tube|Produtos Smart Tube]] e que possuam a classificação específica de **Canais Adicionais**. Esta seleção é fundamental para o correto funcionamento do sistema.

### Passo 5: 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 Smart Tube;
	- **Tipo de tecnologia TV:** defina o tipo de tecnologia do produto;
	- **Login:** refere-se ao login de acesso à plataforma. Gerado automaticamente a partir do prefix e number definidos na integração.
	- **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 do usuário TV na plataforma;
	-  **Status:** indica o status do usuário TV, se Ativa ou Inativo. Permite o controle de acesso e gerenciamento diretamente pelo IXC.
	
4. 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).

## Casos de Uso

### Ativar e Desativar Usuário TV Smart Tube
 A integração do sistema com a plataforma Smart Tube permite realizar alterações manuais de status através dos botões **Ativar** e **Desativar** diretamente no usuário TV. O status do usuário TV pode ser controlado de duas formas:

- **Ativar:** permite realizar a ativação do usuário TV, para retomar o consumo do usuário;
- **Desativar:** permite que o cliente tenha somente o usuário de TV inativado, sem cancelar o contrato. Este corte é efetuado fazendo com que o usuário TV não tenha mais acesso à plataforma.

## Fluxo 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 com a plataforma Smart Tube oferece uma solução robusta para gerenciamento de serviços de TV e streaming. Ao seguir as instruções deste documento e utilizar as funcionalidades disponíveis, é possível otimizar a experiência do cliente e melhorar a eficiência operacional da empresa.

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

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