Skip to main content

Integração WatchTV - Guia de Uso

sgptsmx-petroleo.png



1. Introdução

O que é WatchTV?


Watch TV é uma plataforma de TV com conteúdo on demand focada em provedores, fornecendo aos provedores de internet (ISPs) a possibilidade de entregar assinaturas de serviço multimídia. Isso inclui acesso a filmes, séries, programas de TV, esportes, documentários e uma variedade de outros conteúdos, todos disponíveis online.

A integração entre a Watch TV e o Sistema foi desenvolvida para transformar a gestão de serviços de telecomunicações e conteúdo digital, oferecendo uma plataforma unificada e eficiente para provedores de internet. Com essa solução, sua empresa poderá:

  • 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 WatchTV, siga os passos abaixo para cadastrar os contratos e planos corretamente.

2.1 Criar Grupo de Contrato


Acesse o menu:

Financeiro
Cadastros
Contrato
Cadastrar Contrato

contratos.png

Crie um contrato com:

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

Cadastro Contrato TV

2.2 Cadastrar Plano de TV


Após o cadastro do grupo de contrato, podemos criar o plano de TV através do Menu:

Administração
Planos
Cadastrar
TV

planos.png

  • Defina uma descrição para o plano
  • Associe ao grupo de contratos TV
  • Configure os planos de contas de Mensalidade e Adesão

Cadastro Plano

2.3 Aba "Dados Técnicos"


  • Gateway: selecione "WatchTV"
  • Gateway ID: insira o(s) código(s) do plano (Ex: 1506,1507)
  • Auto Bloqueio: marque como habilitado

Dadostecnicos.png


3. Contrato do Cliente

3.1 Novo contrato exclusivo de TV


  • Ir no cadastro do cliente → Guia Contrato
  • Clique em Cadastrar Contrato/Serviçocontratotv.png
  • Tipo de contrato: TV
  • Selecione o POP do clienteNovo Contrato TV
  • Escolha o Plano de TV
  • Preencha o campo Email/Usuário com um e-mail válidocontratocliente.png

3.2 Adicionar serviço de TV a contrato já ativo


  • Na aba Contratos, clique em Opções → Adicionar Serviço de TVservtv.png
  • Escolha o Plano de TV
  • Preencha o campo Email/Usuário com um e-mail válidocontratocliente.png

4. Gestão de Usuários e Contratos

A integração com a plataforma Watch 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:

  1. Acessando o cadastro do cliente, basta clicar no botão Status:ativarcontrato.png
  2. Em seguida alterar para Ativo e depois Cadastrar:ativar.png
  3. Para validar a ativação, basta verificar se os campos Gateway ID e SmartCard foram preenchidos automaticamente.smartcard.png
  4. Após ativação o WatchTV 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

  1. Acessando a guia de contratos do cliente, identifique o serviço inativo e clique sobre ele para editarativar serv.png
  2. Em Dados do Serviço clique em Ativar:ativserv2.png
  3. Para validar a ativação, basta verificar se os campos Gateway ID e SmartCard foram preenchidos automaticamente.smartcard.png
  4. Após ativação o WatchTV 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 WatchTV.

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 WatchTV. 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? ✔️

6. Informações Adicionais

6.1 Integração de Planos WatchTV – Novas Diretrizes


A WatchTV passou a utilizar um novo modelo de integração de planos, que combina serviços Lineares (Básicos) e Premium. Essa integração é obrigatória para o funcionamento do serviço Premium.

Regras de Integração:

  • Obrigatoriedade do Plano Básico: Para que o serviço Premium funcione corretamente, é necessário que o cliente também esteja cadastrado com o serviço Básico (Linear).
  • Cadastro Recomendado (Plano Único): Com base em validações junto à Gateway, recomenda-se cadastrar os serviços Básico + Premium em um único plano. Isso garante a correta integração e simplifica a operação.

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 WatchTV 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.

7. Erros Comuns

P0001: API_EMAIL_ALREADY_IN_TICKET

O e-mail já está associado a outro ticket.

  • Verifique e delete o ticket existente no backoffice
  • Ou use outro e-mail válido
P0001: API_PHONE_IS_NOT_CELLPHONE

Telefone informado não é um celular válido.

  • Corrija para o formato correto: (DDD) 9XXXX-XXXX
P0002: EMAIL_CAN_NOT_BE_CREATED

Excedeu o número de tickets contratados.

  • Solicite liberação de novos tickets com o suporte WatchTV.
P0001: API_TICKET_BASIC_NOT_FOUND

Plano Premium cadastrado sem plano Básico.

  • Adicione um código de SVA básico no plano

tsmx-petroleo.png