Skip to main content

Integração PlayHub - Guia de Uso

sgptsmx-petroleo.png


1. Introdução

O que é a PlayHub?

PlayHub é uma plataforma de conteúdos on demand que funciona como uma extensão dos seus serviços. Ao integrar a solução, você enriquece seu portfólio e oferece filmes e séries, fidelizando clientes e gerando novas oportunidades de receita. A integração é simples e permite que seu provedor controle toda a gestão e o faturamento do serviço de streaming.

Em resumo, a PlayHub é uma ferramenta que fortalece seu negócio, aumenta a satisfação dos clientes e te ajuda a se destacar no mercado.

A integração 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:

  • Administração simplificada dos serviços de entretenimento.
  • Informações centralizadas do seu provedor em um só lugar.;
  • Gestão fácil dos clientes e controle de cobranças.;
  • Monitoramento automático de inadimplência.

2. Cadastro Inicial – Planos de TV

Verificação e Cadastro de Grupos de Contratos de TV


Para cadastrar os planos no SGP é obrigatório que tenha um grupo de contratos de TV.
A verificação e o cadastro podem ser acessadas conforme as instruções abaixo:

Financeiro
Cadastros
Contrato
Cadastrar Contrato


O contrato precisa ser do Grupo TV, ter uma Descrição e estar Disponível.

  • Grupo: TV
  • Descrição: Nome descritivo do contrato
  • Status: Disponível


⚠️ O Contrato pode ser criado em Branco.


2025-07-31_15-18.png


Cadastro de Planos

Após validação/criação do grupo de contrato, devemos seguir para o cadastro do(s) plano(s) no seguinte menu:

Administração
Planos
Cadastrar
TV

Na tela de Cadastro de Plano vamos definir uma Descrição, em Contrato vamos selecionar o Grupo de Contratos de TV e vamos definir os Planos de Contas de Mensalidade e Adesão. As demais configurações ficam a critério do Usuário.

2025-07-26_11-50.png

Após definir os dados básicos do plano, acesse a guia Dados Técnicos para concluir a configuração. Essas configurações são essenciais para garantir o correto funcionamento e a integração do plano com a PlayHub.

2025-07-26_11-56.png

Nesta etapa, siga as instruções abaixo:

  • Gateway: selecione o gateway previamente criado para a PlayHub.
  • Gateway ID: informe o(s) código(s) disponibilizado(s) para o cliente. Basta selecionar os planos contratados.
    • Importante: caso o plano inclua mais de um serviço (ex.: HBO + Deezer), é possível inserir múltiplos IDs separados por vírgula. Exemplo: HBX,DZ1
2.1 Exemplos de Códigos de SVAs

Abaixo estão alguns exemplos de SVAs previamente verificados para esta integração. Essa lista é meramente ilustrativa — o cliente pode possuir outros SVAs disponibilizados pela própria PlayHub. O sistema SGP reconhece automaticamente os códigos, pois realiza a consulta diretamente via integração.

Exemplos de Códigos de Produtos
  • D01 - 01 SERVIÇO ADVANCED À ESCOLHA
  • D02 - 02 SERVIÇO ADVANCED À ESCOLHA
  • D03 - 03 SERVIÇO ADVANCED À ESCOLHA
  • D04 - 04 SERVIÇO ADVANCED À ESCOLHA
  • D05 - 05 SERVIÇO ADVANCED À ESCOLHA
  • D06 - 06 SERVIÇO ADVANCED À ESCOLHA
  • DI1 - Disney
  • DT0 - SKY+ c/ Telecine
  • DT1 - SKY+ Full
  • DT2 - SKY+ c/Premiere
  • DT3 - SKY+ c/ Telecine e Premiere
  • DT8 - SKY+ Conmebol
  • DT9 - SKY+ BBB24
  • DTA - SKY+ Paramount+
  • DTB - SKY+ Nosso Futebol
  • DTC - SKY+ Combate
  • DTD - DGO Copa do Nordeste
  • DTE - SKY+ ESPN
  • DTF - SKY+ Light
  • DTG - SKY+ Light c/ Telecine
  • DTH - SKY+ Light c/ Premiere
  • DTI - SKY+ Light c/ Telecine e Premiere
  • DTJ - SKY+ UFC
  • DTK - SKY+ Light c/ Paramount+ SVA
  • DTL - SKY+ Light SVA
  • DTM - SKY+ Light com Globo SVA
  • DTN - SKY+ Nosso Futebol SVA
  • DTO - SKY+ Combate SVA
  • DTP - SKY+ Premiere SVA
  • DTQ - SKY+ Full SVA
  • DTR - SKY+ Telecine SVA
  • DWY - DOCWAY
  • DZ1 - Deezer
  • FLD - Fluid
  • HBX - HBOMax
  • HUB - Hube
  • K00 - Kaspersky Small Office - 05 Lic. T
  • K01 - Kaspersky Small Office - 10 Lic. T
  • KO2 - Kaspersky Small Office - 25 Lic. T
  • KO3 - Kaspersky Internet Security - 3 Lic. B
  • KO4 - Kaspersky Small Office - 50 Lic. T
  • KO5 - Kaspersky Total Security - 5 Lic. B
  • KO6 - Kaspersky Standard - 1 Lic. T
  • K10 - Kaspersky Combo
  • K11 - Kaspersky Standard - 1 Lic. BL
  • K13 - Kaspersky Internet Security - 3 Lic. T
  • K15 - Kaspersky Total Security - 5 Lic. T
  • K20 - Kaspersky Standard - 1 Lic. MA
  • LEC - Hub Vantagens
  • LOK - Looke
  • LS1 - LIONSGATE
  • NB1 - NBA League Pass
  • NB2 - NBA Team Choice
  • NP1 - No Ping
  • P01 - 01 serviços premium à escolha
  • P02 - 02 serviços premium à escolha
  • P03 - 03 serviços premium à escolha
  • P04 - 04 serviços premium à escolha
  • P05 - 05 serviços premium à escolha
  • P06 - 06 serviços premium à escolha
  • PKD - Playkids
  • PT1 - Partiu
  • PU1 - Reforça
  • PU2 - Taplingo
  • PU3 - Tô Aqui
  • Q01 - 01 Serviços à escolha
  • Q02 - 02 Serviços à escolha
  • Q03 - 03 Serviços à escolha
  • Q04 - 04 Serviços à escolha
  • Q05 - 05 Serviços à escolha
  • Q06 - 06 Serviços à escolha
  • Q07 - 07 Serviços à escolha
  • Q08 - 08 Serviços à escolha
  • Q09 - 09 Serviços à escolha
  • Q10 - 10 Serviços à escolha
  • QD1 - Queima Diária
  • QD2 - QNutri
  • RF1 - Ritual Fit
  • SC1 - Smart Content
  • S01 - Social Comics
  • SXH - Sexy Hot
  • UB1 - Ubook
  • UB2 - Ubook News
  • UB4 - Ubook GO
  • UB8 - Ubook Go JW
  • UB9 - Ubook News JW
  • UBD - Ubook CN
  • UBF - Ubook PV
  • UBJ - Leitura 360
  • UBK - Estuda Mais
  • UBL - Pequenos Leitores
  • UBM - Playlist
  • UBN - O Jornalista
  • UBO - UBOOK GO ADVANCED
  • UBP - UBOOK GO PREMIUM FULL
  • UBQ - UBOOK GO STANDARD
  • UBR - UBOOK GO PREMIUM LIGHT
  • UBS - UBOOK GO SUPER PREMIUM
  • UBT - UBOOK GO STAR
  • UBU - ADYLBOOKS - 2 LIVROS DIGITAIS
  • UBV - UBOOK GO - 2 LIVROS DIGITAIS
  • UBW - UBOOK GO - 3 LIVROS DIGITAIS
  • VG1 - Clube de Ciencias
  • VG2 - FuzeForge
  • VG3 - Galinha Pintadinha
  • VG4 - Pocoyo
  • X01 - 01 Serviço Start à escolha
  • X02 - 02 Serviço Start à escolha
  • X03 - 03 Serviço Start à escolha
  • X04 - 04 Serviço Start à escolha
  • X05 - 05 Serviço Start à escolha
  • X06 - 06 Serviço Start à escolha
  • ZD2 - Maia
  • ZW1 - ZenApp

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.

Ativação do Contrato de Serviço de 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 Cadastro do Cliente para que a ativação do usuário SVA seja possível.

3. Contrato de Serviço do Cliente

Informações Obrigatórias para Registro

Durante o processo de registro de cadastro na PlayHub, é obrigatório o envio das seguintes informações além de Usuário e Senha: CPF, Nome completo, E-mail e Telefone de contato. A integração, por padrão, utiliza os contatos vinculados ao contrato. Abaixo, segue um exemplo da configuração desses contatos:

2025-07-26_12-02.png

Cadastro de Novo Contrato ou Adição de Serviço de Contrato Existente.

Após a criação dos planos podemos realizar o cadastro dos clientes. Para isso, teremos duas opções: cadastrar um novo contrato somente para o serviço de TV ou adicionar o serviço de TV a um contrato já existente.

Para cadastrar um novo contrato devemos acessar o cadastro do cliente, ir na guia Contrato e depois em Cadastrar Contrato/Serviço. Vamos definir o Tipo de Contrato como TV e vamos selecionar o POP do cliente:

Imagem ilustrativa da integração com a PlayHub

Para cadastrar o plano a um contrato já ativo basta clicar no botão Opções e Adicionar Serviço de TV.

2025-07-26_12-52.png

Nos Dados do Serviço, vamos definir o Plano de TV. No campo E-mail/Usuário deve conter o login do cliente e no campo Senha vamos definir a Senha de acesso.

Usuário e Senha precisam ter entre 6 e 30 caracteres

dadostv.png


4. Plano Adicional

Uso do Plano Adicional

Ao adicionar o Plano de TV PlayHub para um cliente, o sistema liberará a opção de incluir um Plano Adicional, permitindo ativar mais de um plano por contrato.

Atenção: O valor dos Planos Adicionais NÃO é somado à mensalidade do cliente.


Plano Adicional



5. Funcionalidades Disponíveis

Recursos disponíveis pela API

A tabela abaixo descreve os recursos disponíveis por meio da integração com a API da PlayHub. Essas funcionalidades podem ser acessadas diretamente pelo sistema e utilizadas conforme as permissões da integração.

Recurso Status
Suspende serviço ao suspender? ✔️
Permite alterar senha? ✔️
Cria planos com vários SVAs? ✔️
Permite adicionar SVAs em serviços existentes? ✔️
Permite vincular um serviço existente no contrato do SGP? ✔️
Existem dados obrigatórios? (E-mail ou Telefone) ✔️

TSMX-petroleo.png