Integração ITTV - Guia de Uso

1. Introdução

O que é ITTV?

O ITTV é um gateway de TV por assinatura que funciona como uma plataforma de integração para provedores de internet. Seu objetivo é ajudar provedores de internet (ISPs) a entrarem no mercado de IPTV, oferecendo uma solução completa e pronta para uso.

Ao se integrar com o ITTV, os provedores podem oferecer aos seus clientes uma programação diversificada e de alta qualidade, incluindo canais lineares, conteúdo on-demand (VOD) e transmissões de eventos ao vivo. Isso permite que os ISPs aumentem seu portfólio de serviços, melhorem a fidelização de clientes e gerem novas fontes de receita.

A integração com o ITTV é do tipo passiva, onde o gateway age como um observador, monitorando e atualizando automaticamente as informações do provedor em sua própria base de dados, garantindo que o serviço de TV esteja sempre sincronizado.

Principais recursos e benefícios:

Essa abordagem simplifica o fluxo de trabalho, melhora a confiabilidade das informações compartilhadas e reduz a carga operacional sobre as equipes envolvidas.

2. Cadastro Inicial – Planos de TV

Para iniciar a integração com a ITTV, siga os passos abaixo para cadastrar os contratos e planos corretamente.

2.1 Criar Grupo de Contrato

Acesse o menu:

Crie um contrato com:

2.2 Cadastrar Plano de TV

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

2.3 Aba "Dados Técnicos"

⚠️ O Nome do Pacote(title) e ids irá ser fornecido através da lista de planos que será repassado pelo suporte.

3. Contrato do Cliente

3.1 Novo contrato exclusivo de TV

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

4. Gestão de Usuários e Contratos

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

4.1.2. Novo Serviço

Esse é o processo de ativação quando o serviço é cadastrado em um contrato já existente

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 ITTV deve identificar essa alteração de Status e cancelar o serviço do cliente.

Essa exclusão ocorre em cancelamentos:

5. Informações Adicionais

Para que a Suspensão do cliente no ITTV aconteça quando for suspenso no SGP, precisa cadastrar a seguinte variável:

Caso não cadastrem essa variável, o plano será suspenso apenas no SGP e no ITTV o cliente continuará com acesso.

Para isso será necessário criar um contrato de serviço de TV com o login e senha em uso do cliente em questão. Após isso, o campo smartcard desse contrato deverá ser preenchido com o smartcard colhido na plataforma da ITTV. Por último, será necessário que o parâmetro "djson" do Serviço criado seja preenchido com o ID do cliente, da seguinte forma:

{"ittv_customer": ID_DO_CLIENTE"}

Feito isso, os status do Serviço, Cobrança e Contrato devem ser modificados para ATIVO via script, para que o SGP não tente realizar uma ativação pela gateway. Em seguida o serviço já deve conseguir ser gerenciado pela API Do SGP.

6. Funcionalidades Disponiveis