Configuração da Integração TV Smart Tube (Beta)
Introdução
Atenção!
Este conteúdo está presente na versão Beta do sistema. A disponibilidade desta funcionliade na versão Estável será a partir de Abril de 2025.
Definição - Smart Tube:
A Smart Tube, desenvolvida pela SmartLabs, é 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.
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.
- Acesse o formulário de Integração TV Smart Tube através do caminho: Configurações > Integrações > Integração TV Smart Tube;
- 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.
- Clique em Salvar para validar a configuração e concluir o registro da integração.
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.
Informação:
O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.
- Acesse o formulário de Cadastro de Produtos através do caminho: Sistema > Cadastros > Produtos;
- Clique no botão Novo para registrar um novo produto associado à integração, que será fornecido ao cliente;
- Preencha os campos obrigatórios na aba Produtos e na aba Planejamento;
- Acesse a aba TV;
- No campo Plataforma, selecione a opção SmartTube;
- 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:
- No menu principal, acesse **Configurações;
- Selecione **Integrações;
- Clique em Integração TV Smart Tube;
- Acesse a aba Produtos Smart Tube;
- Clique em Novo para realizar o cadastro do produto Smart Tube;
- 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: Defina os limites de dispositivos simultâneos para esse produto.
- 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 Formulário Planos de Venda.
- Acesse o formulário de Formulário Contrato do Cliente através do caminho: Sistema > Cadastros > Contratos;
- Pressione o botão Editar para acessar o contrato;
- 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.
Atenção: 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.
Para esta etapa, é essencial selecionar apenas os produtos que estejam cadastrados em
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.
- Acesse o formulário de Formulário Contrato do Cliente através do caminho: Sistema > Cadastros > Contratos;
- Pressione o botão Editar para acessar o contrato;
- 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.
Atenção: Produtos Smart Tube e que possuam a classificação específica de Canais Adicionais. Esta seleção é fundamental para o correto funcionamento do sistema.
Para esta etapa, é essencial selecionar apenas os produtos que estejam cadastrados em
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.
- Ainda no contrato do cliente, navegue até a aba TV;
- 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.
- 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
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