Integrações TV - ITTV
Introdução
Definição - ITTV
A ITTV é uma plataforma de TV com conteúdo on demand com foco em provedores, que oferece um amplo leque de serviços de conteúdo audiovisual ao seu negócio. 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 ITTV 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:
Este guia aborda a integração entre os serviços ITTV e o Sistema, permitindo uma gestão eficiente e centralizada de serviços de streaming e TV para provedores de internet.
- Gerenciamento facilitado de serviços de TV e streaming;
- Centralização de informações do provedor;
- Gestão eficiente de clientes e receitas;
- Controle automatizado de inadimplência.
Acesso ao Formulário
Caminho: Configurações > Integrações > Integrações TV
Credenciais:
Assim que o seu provedor (ISP) realizar o credenciamento junto a plataforma citada, serão fornecidos os dados necessários para realizar a integração com o ERP IXC Soft. A partir destes dados, é possível realizar o cadastramento da integração no IXC, conforme o material a seguir.
Requisitos de Uso
Para implementar a Integração da plataforma ITTV em seu sistema, é necessário solicitar à ITTV a liberação de acesso do endereço IP do seu servidor IXC no Firewall da plataforma. Este procedimento é fundamental para estabelecer uma conexão segura e eficiente entre os sistemas, permitindo estabelecer a comunicação entre as plataformas.
Entrega de Valor
- Alinhar as necessidades dos clientes que utilizam streaming e TV por assinatura com a plataforma ITTV;
- Centralizar as informações do provedor em um único local e facilitar o gerenciamento de inadimplentes, gestão de clientes e faturamento mensal.
- Simplificação do processo de ativação e manutenção de clientes;
- Otimização do controle de inadimplência.
Configuração da Integração
Passo 1: Cadastro da Integração
Neste passo, é efetuado o cadastro da integração. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma ITTV.
- Acesse o formulário de Integrações de TV através do caminho: Configurações > Integrações > Integrações TV;
- Pressione o botão Novo;
- Selecione ITTV no campo Plataforma;
- Preencha os campos:
- IP Integração: este campo se refere à URL fornecida pela plataforma credenciada - https://api-resellers.ittv.com.br/alpha/reseller/. Ela é responsável por “liberar o acesso” do sistema IXC Soft à plataforma ITTV para estabelecer a comunicação entre as plataformas envolvidas;
- Token acesso: preencha com a informação de token de acesso fornecida pela plataforma credenciada;
- Clique em Salvar para estabelecer a comunicação entre o IXC e a plataforma e para concluir o cadastro da integração.
Importante:
As informações de IP Integração e Token acesso são fornecidas pela própria ITTV.
Passo 2: Configuração do Produto de TV
O cadastro do produto de TV é essencial para a gestão do produto no contrato, faturamento e também para permitir a ativação do usuário TV, pois o produto se relaciona com a integração pelos pacotes disponibilizados pela plataforma.
Importante:
O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.
- Acesse o formulário de Cadastro de Produtos através do caminho: Sistema > Cadastros > Produtos;
- Pressione o botão Novo;
- Preencha os campos obrigatórios na aba Produtos e na aba Planejamento;
- Acesse a aba TV;
- No campo Plataforma, selecione a opção ITTV;
- Preencha o campo:
- ID Integração: clique na lupa e selecione o cadastro da integração de TV da ITTV e vincule ao campo;
- ID Pacote: clique sobre o botão Buscar pacote e selecione um pacote para o produto que está cadastrando. Este pacote é referente ao pacote principal que será disponibilizado ao cliente;
- Clique em Salvar para validar e finalizar o cadastro do produto.
Passo 3: Produto no Contrato
Para realizar a gestão do contrato associado ao produto de TV, é necessário vincular o produto de TV ao contrato. Esta ação permite realizar a geração do faturamento, emitir notas fiscais e também efetuar ativação do usuário TV associado à integração. Esta ativação pode ocorrer diretamente pelo contrato ou por Formulário Planos de Venda.
- Acesse o formulário de Contrato do Cliente através do caminho: Sistema > Cadastro > Contratos;
- Pressione o botão Editar para acessar o contrato;
- Navegue até a aba Produtos e clique no botão Novo. Defina o tipo do produto como TV/Streaming e no campo Produto/Serviço, clique na lupa e selecione o produto de TV cadastrado. Clique em Salvar para validar as configurações.
Passo 4: Ativação do Usuário TV
A ativação do usuário TV consiste em criar as credenciais de acesso para o usuário final obter acesso à plataforma.
- Ainda no contrato do cliente, navegue até a aba TV;
- Clique no botão Novo e preencha os campos apresentados:
- Plataforma: no botão de seleção, selecione a opção ITTV;
- Tipo de tecnologia TV: defina o tipo de tecnologia do produto;
- Produto: clique na lupa e selecione o produto de TV incluso no contrato;
- Usar e-mail principal: se sim, utiliza o e-mail do cadastro do cliente. Se não, preencher manualmente;
- Login: refere-se ao login de acesso à plataforma. Deve ser um e-mail válido;
- Senha: clique em Gerar senha para gerar uma senha aleatória ou preencha manualmente. A senha deve conter mais de 6 caracteres para a ativação adequada do login TV.
- Após preencher os campos, clique em Salvar para validar as modificações e efetivar a criação do usuário TV.
Finalização:
Após realizar a ação de todos os passos, o usuário TV estará pronto para uso. O controle de acesso é feito diretamente pelas ações do contrato (bloqueio e liberação).
Casos de Uso
Ações do Contrato
A integração com a plataforma da ITTV valida ações sobre o contrato, impactando no acesso do usuário TV, permitindo o controle de acesso pelo sistema e espelhando na plataforma credenciada.
Controle de Acesso do Usuário TV pelo Status do Contrato
A integração com a plataforma ITTV valida as seguintes ações sobre o contrato, impactando no acesso do usuário TV. Estas ações incluem:
- Aviso de atraso/Financeiro em atraso: a integração com a plataforma ITTV não valida o status do contrato em atraso por inadimplência, portanto, o acesso do login TV permanece ativo.
- Bloqueio manual ou automático: em casos de bloqueio automático ou manual devido inadimplência, o login TV terá seu acesso interrompido.
- Liberação automática: ocorre sob pagamento, no momento em que o contrato é ativado, liberando o acesso à plataforma.
- Liberação manual: o login volta a constar como online e libera o acesso à plataforma.
- Aguardando assinatura: irá constar como online, com o acesso liberado.
- Cancelamento: O login TV será inativado automaticamente quando o contrato for cancelado. O cancelamento pode ser realizado de duas formas:
- Através dos botões disponíveis no contrato, com as opções:
-
Status > Cancelar contrato e financeiro
-
Status > Cancelar contrato e financeiro não vencido
-
Status > Cancelar contrato e gerar financeiro remanescente
- Através da Tarefa - Cancelamento Automático de Contrato Inadimplente, que processa o cancelamento automaticamente em casos de inadimplência, comunicando com o login TV e inativando-o, cortando o acesso à plataforma.
- Deleção: a integração permite a deleção do Usuário TV, portanto, se o usuário TV for deletado no IXC Provedor, todos os seus registros serão removidos do sistema e será deletado na plataforma.
Atenção:
Evite deletar um usuário TV diretamente pelo painel de controle da ITTV. A comunicação entre as plataformas ocorre apenas de IXC Provedor para a ITTV, portanto, alterações feitas na plataforma não serão consideradas no IXC Provedor. Em caso de deleção do usuário TV, o sistema perderá a comunicação com a plataforma e não permitirá mais alterações no usuário TV através do IXC.
Bloqueio de Contrato com Tratamento de Erro
Atenção!
A funcionalidade de Bloqueio de Contrato com Tratamento de Erro está presente na versão Beta do sistema.
A disponibilidade desta integração na versão Estável será a partir de julho de 2025.
O processo de bloqueio de contrato opera de forma independente da integração com sistemas externos. Em caso de falhas de comunicação ou outros erros de integração, esses são devidamente registrados nos logs de erros de integracoes, sem impactar a execução do bloqueio do contrato do cliente. Isso garante a continuidade do processo de bloqueio e o cumprimento das regras de negócio.
Portanto, quando identificada alguma instabilidade na comunicação entre as plataformas, o sistema dispara um aviso de erro com a seguinte mensagem:
Aviso de erro:
Ocorreu um erro ao bloquear usuários TV. Verifique os logs de integrações para mais detalhes do problema.
Considerações Finais
A integração ITTV com o sistema oferece uma solução completa para provedores de internet, otimizando a gestão de serviços de TV e streaming. Esta integração permite um gerenciamento eficiente de assinaturas, redução de erros operacionais e controle preciso dos serviços oferecidos. Como resultado, proporciona uma experiência superior aos clientes, além de automatizar processos e permitir monitoramento em tempo real. Esta tecnologia contribui significativamente para a modernização dos serviços de telecomunicações, tornando a gestão mais eficiente e confiável.
Etiquetas
Integracoes IntegracoesTV IntegracaoITTV ITTV Streaming Conteudo