Integração OléTV - Guia de Uso
1. Introdução
O que é OléTV?
A Olé TV é uma plataforma de distribuição de conteúdos televisivos e de streaming via internet, oferecendo uma experiência completa de entretenimento digital.
- Disponibiliza uma solução IPTV e OTT, permitindo a transmissão de canais lineares (ao vivo) e conteúdos sob demanda (VOD).
- O acesso pode ser feito em diversos dispositivos, como smart TVs, computadores, notebooks, tablets e smartphones, garantindo flexibilidade e mobilidade ao usuário
- Simplificar a administração dos serviços de TV e streaming, centralizando o controle em um único painel;
- Consolidar todas as informações do provedor em um ambiente integrado, facilitando o acesso e a análise de dados;
- Otimizar o gerenciamento de clientes e o controle do fluxo de receitas, promovendo mais eficiência operacional;
- Automatizar o monitoramento da inadimplência e o controle de pagamentos, reduzindo riscos e melhorando a previsibilidade financeira.
2. Cadastro Inicial – Planos de TV
Para iniciar a integração com a OléTV, siga os passos abaixo para cadastrar os contratos e planos corretamente.
2.1 Criar Grupo de Contrato
Acesse o menu:
Crie um contrato com:
- Grupo: TV
- Descrição: Nome descritivo do contrato
- Status: Disponível
2.2 Cadastrar Plano de TV
Após o cadastro do grupo de contrato, podemos criar o plano de TV através do Menu:
- Defina uma descrição para o plano
- Associe ao grupo de contratos TV
- Configure os planos de contas de Mensalidade e Adesão
2.3 Aba "Dados Técnicos"
- UUID: Código do Plano principal que foi fornecido pelo Gateway
- Gateway: Seleciona o OléTV
- Gateway ID: Código do Plano principal que foi fornecido pelo Gateway (podendo adicionar codigo adicionais)
- Nome do Pacote: Adicionar a descrição do Plano principal que foi informado pela Gateway.
3. Contrato do Cliente
3.1 Novo contrato exclusivo de TV
- Ir no cadastro do cliente → Guia Contrato
- Clique em Cadastrar Contrato/Serviço
- Tipo de contrato: TV
- Selecione o POP do cliente
- Escolha o Plano de TV
- Preencha o campo Email/Usuário com um e-mail válido
3.2 Adicionar serviço de TV a contrato já ativo
- Na aba Contratos, clique em Opções → Adicionar Serviço de TV
- Escolha o Plano de TV
- Preencha o campo Email/Usuário com um e-mail válido
4. Gestão de Usuários e Contratos
A integração com a plataforma Olé TV foi desenvolvida para oferecer eficiência, controle e automação na gestão de usuários de TV vinculados aos contratos. Abaixo, veja como funcionam os processos de ativação, bloqueio e cancelamento.
4.1. Ativação do Serviço
O processo de ativação do serviço ocorre logo após o cadastro do contrato ou do serviço do cliente
4.1.1. Novo Contrato
Em caso de ativação de um novo contrato, devemos seguir o processo padrão:
- Acessando o cadastro do cliente, basta clicar no botão Status:
- Em seguida alterar para Ativo e depois Cadastrar:
- Para validar a ativação, basta verificar se os campos Gateway ID e Smartcard foram preenchidos automaticamente.
- Após ativação o OléTV deve enviar um e-mail para o e-mail do cliente para conclusão do processo de cadastro.
4.1.2. Novo Serviço
Esse é o processo de ativação quando o serviço é cadastrado em um contrato já existente
- Acessando a guia de contratos do cliente, identifique o serviço inativo e clique sobre ele para editar
- Em Dados do Serviço clique em Ativar:
- Para validar a ativação, basta verificar se os campos Gateway ID e SmartCard foram preenchidos automaticamente.
- Após ativação o OléTV deve enviar um e-mail para o e-mail do cliente para conclusão do processo de cadastro.
4.2. Bloqueio de Contrato
O processo de bloqueio de contrato funciona de forma autônoma, sem depender da comunicação com sistemas externos.
Para isso, o autobloqueio deve estar ativo nos planos criados nos passos anteriores.
O processo de bloqueio manual também é possivel através da alteração de status do contrato ou desativação do serviço.
4.3. Cancelamento de Contrato
Quando um contrato com serviço de TV é cancelado, o sistema remove automaticamente o usuário da plataforma da OléTV.
Essa exclusão ocorre em cancelamentos:
- Manuais, realizados por um operador;
- Automáticos, por inadimplência ou outras regras.
5. Funcionalidades Disponíveis
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? | ✔️ |
| Remove serviço ao cancelar? | ✔️ |
| Criação de planos com vários SVAs? | ✔️ |
| Alteração de Senha? | ✔️ |
6. Informações Adicionais
6.1 Dados para Ativação
Para ativar o cliente na plataforma OléTV, é necessário preencher corretamente os seguintes dados:
-
Data de Nascimento (formato dd/mm/aaaa) – Obrigatório para cadastro de Pessoa Física.
-
Dia de Vencimento do Boleto – Obrigatório. Deve ser escolhido entre os dias disponíveis abaixo (qualquer outro valor pode gerar erro na ativação):
-
05, 06, 07, 08, 10 e 20
-
-
Número de Telefone (formato 99999-9999) – Opcional.
-
CPF (formato 999.999.999-99) ou CNPJ (formato 99.999.999/9999-99) – Obrigatório.
Atenção: o preenchimento incorreto ou incompleto dos campos obrigatórios pode impedir a ativação do cliente.
6.2 Comportamento no SGP
- Suspensão do contrato ou serviço: Suspende automaticamente o serviço correspondente na Gateway.
- Cancelamento do contrato: Remove automaticamente o serviço correspondente da Gateway.
6.3 Informações Complementares
- É possível criar planos que incluem múltiplos SVAs (Serviços de Valor Agregado).
- A OléTV exige que o usuário do cliente seja um e-mail válido, pois todas as informações de acesso serão enviadas por e-mail.
