Central de Ajuda

Leitura de 10 min

Integração de TV - PlayHub

Introdução

O que é a PlayHub?

A PlayHub é uma plataforma de conteúdos on demand, especializados em oferecer conteúdo digital para provedores regionais, de modo a enriquecerem seus serviços e fidelizar clientes. É uma empresa que detém o direito de representar produtos audiovisuais e revendê-los.

A integração PlayHub com o Sistema visa otimizar a oferta de serviços de comunicação e multimídia, centralizando informações e fornecendo uma solução completa para provedores de internet. Esta integração permite:

  • Gerenciamento facilitado de serviços de TV e streaming;
  • Centralização de informações do provedor;
  • Gestão eficiente de clientes e receitas;
  • Controle automatizado de inadimplência.

Acesso ao Formulário

Caminho: Configurações > Integrações > Integrações TV

Entrega de Valor

  • Alinhar as necessidades dos clientes que utilizam streaming e TV por assinatura com a plataforma PlayHub;
  • 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

Credenciais:

Assim que o seu provedor (ISP) realizar o credenciamento junto a plataforma citada, serão fornecidos os dados necessários para realizar a integração com o ERP IXC Soft. A partir destes dados, é possível realizar o cadastramento da integração no IXC, conforme o material a seguir.

Passo 1: Cadastro da Integração

Neste passo, é efetuado o cadastro da integração. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma PlayHub.

  1. Acesse o formulário de Integrações de TV através do caminho: Configurações > Integrações > Integrações TV;

  2. Pressione o botão Novo;

  3. Selecione PlayHub no campo Plataforma;

  4. Preencha os campos:

    • Versão: indique se a plataforma está sendo utilizada na versão 1 ou versão 3;
    • IP Integração: este campo se refere à URL fornecida pela plataforma credenciada. Ela é responsável por “liberar o acesso” do sistema IXC Soft à plataforma PlayHub para estabelecer a comunicação entre as plataformas envolvidas;
    • Login TV: refere-se à informação de API Key (chave de login) na PlayHub, informação fornecida pela plataforma;
    • Senha TV: refere-se à informação de API Secret (senha) na PlayHub, informação fornecida pela plataforma;

  5. Clique em Salvar para estabelecer a comunicação entre o IXC e a plataforma e para concluir o cadastro da integração.

Importante:

As informações de Login TV e Senha TV são fornecidas pela própria Playhub e não se referem às mesmas utilizadas para acesso a plataforma da Playhub, são exclusivas para a integração API.

Passo 2: Cadastro 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 pacotes disponibilizados pela plataforma.

Importante:

O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.

  1. Acesse o formulário de Cadastro de Produtos através do caminho: Sistema > Cadastros > Produtos;
  2. Clique no botão Novo;
  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 PlayHub;
  6. Preencha o campo:
    • Produto PlayHub: clique sobre o botão de seleção e selecione um dos produtos disponibilizados pela plataforma, do qual consta disponível em seu contrato.
  7. Clique em Salvar para validar e finalizar o cadastro do produto.

Atenção!

Pacotes que não forem contratados diretamente com a PlayHub não poderão ser disponibilizados ao cliente, mesmo que estejam cadastrados no sistema. Se necessário, consulte a PlayHub para verificar os produtos contratados para revenda.

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.

  1. No menu principal, navegue até Sistema;
  2. Selecione Cadastros;
  3. Clique em Contrato;
  4. Pressione o botão Editar para acessar o contrato;
  5. 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.

Passo 4: Ativação do Usuário TV

Validação de dados cadastrais:

Para permitir a ativação do usuário TV, a plataforma PlayHub valida os seguintes dados cadastrais do cliente:

  • Nome/Razão social;
  • CPF/CNPJ;
  • Endereço de e-mail;
  • Número de telefone;

Certifique-se de que todos estes dados estão preenchidos no Formulário Cliente para que a ativação do usuário SVA seja possível.

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 PlayHub;
    • API: selecione a opção Alterar na API e no IXC para ter comunicação com a plataforma. Ao utilizar a opção Ignorar API e alterar apenas no IXC, não obtém comunicação com a PlayHub e, portanto, não envia a requisição de criação de usuário à plataforma, criando somente no sistema;
    • Tipo de tecnologia TV: defina o tipo de tecnologia do produto;
    • Login: refere-se ao login de acesso à plataforma. Deve ser um e-mail válido;
    • Senha: clique em Gerar senha para gerar uma senha aleatória ou preencha manualmente;
  3. O campo Status é apresentado automaticamente de acordo com o status do login na plataforma, permitindo o controle de acesso pelo sistema de acordo com as alterações no contrato;
  4. Após preencher os campos, clique em Salvar para validar as modificações e efetivar a criação do usuário TV.

Finalização:

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

Cancelamento de serviço

  1. Cliente realiza a solicitação de cancelamento e então o departamento responsável assume a demanda de cancelamento do contrato;
  2. No contrato, é definido o dia de cancelamento, o financeiro é ajustado conforme acordado entre as partes e ocorre o cancelamento manual do contrato;
  3. Ocorre então a desativação do contrato no sistema e por consequência, a inativação do usuário PlayHub, alterando somente seu status e realizando o corte de acesso à plataforma.

Atenção:

A plataforma PlayHub não permite a deleção de usuários TV, isto é, o login permanece criado no sistema e na plataforma PlayHub. Em casos de cancelamento, somente é possível a inativação do usuário, cortando seu acesso.

Bloqueio de Contrato com Tratamento de Erro

Atenção!

A funcionalidade de Bloqueio de Contrato com Tratamento de Erro está presente na versão Beta do sistema.
A disponibilidade desta integração na versão Estável será a partir de julho de 2025.

O processo de bloqueio de contrato opera de forma independente da integração com sistemas externos. Em caso de falhas de comunicação ou outros erros de integração, esses são devidamente registrados nos logs de erros de integracoes, sem impactar a execução do bloqueio do contrato do cliente. Isso garante a continuidade do processo de bloqueio e o cumprimento das regras de negócio.

Portanto, quando identificada alguma instabilidade na comunicação entre as plataformas, o sistema dispara um aviso de erro com a seguinte mensagem:

Aviso de erro:

Ocorreu um erro ao bloquear usuários TV. Verifique os logs de integrações para mais detalhes do problema.

Considerações Finais

A integração PlayHub com o sistema oferece uma solução robusta para provedores de internet, simplificando a gestão de serviços de TV e streaming. Esta tecnologia melhora a eficiência operacional, reduz erros de informação e proporciona uma experiência superior aos clientes.

Etiquetas

Integracoes IntegracoesTV IntegracaoPlayHub PlayHub

Leia Também

Visão de gráfico