Integração WatchTV - Guia de Uso
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:

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"
- Gateway: selecione "WatchTV"
- Gateway ID: insira o(s) código(s) do plano (Ex: 1506,1507)
- Auto Bloqueio: marque como habilitado
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 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:
- 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 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
- 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 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
![]()


