Integração TV - Watch TV

Introdução

Definição - Watch TV:

A 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 aprimorar a gestão de serviços de telecomunicações e conteúdo digital, oferecendo uma plataforma unificada para provedores de internet. Com esta solução, sua empresa consegue:

• Simplificar a administração dos serviços de TV e streaming;

• Unificar todos os dados do provedor em um único ambiente;

• Otimizar o gerenciamento de clientes e fluxo de receitas;

• Automatizar o monitoramento e controle de inadimplência.

  Acesso ao Formulário

Caminho: Configurações > Integrações > Integrações TV

Requisitos de Uso

Para utilizar este recurso no sistema, é necessário atender as seguintes condições:

• Obter a URL de retorno do sistema IXC;
• Obter o arquivo JSON junto ao suporte da plataforma Watch TV para realizar o cadastro da integração no sistema.

Entrega de Valor

• Alinhar as necessidades dos clientes que utilizam streaming e TV por assinatura com a plataforma Watch TV;
• 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

Atenção:

Assim que o seu provedor (ISP), fizer o credenciamento junto a Watch, será fornecido um arquivo JSON para a integração, baseado em sua URL de retorno.

Passo 1: URL de Retorno e Arquivo JSON

A comunicação entre o sistema IXC e a plataforma Watch TV segue um fluxo estruturado, no qual a URL de retorno desempenha um papel essencial. A URL de retorno, configurada com a estrutura sistema.com.br/retorno/watch/, é fornecida à plataforma Watch TV como ponto de conexão.

URL de retorno:

Uma URL de retorno (ou callback URL, em inglês) é um endereço na web que é usado como ponto de retorno para um aplicativo ou serviço após a conclusão de uma ação ou processo. Esse conceito é frequentemente utilizado em cenários de integração entre sistemas, como em APIs, autenticação

Após essa configuração, o sistema IXC registra um arquivo JSON associado à URL de retorno, fornecido pela Watch. Este processo estabelece a comunicação entre os sistemas, permitindo que a partir da comunicação entre as plataformas seja gerado um token de segurança para garantir a integridade e a autenticação da troca de dados.

Com essa integração ativa, os sistemas podem realizar operações como a criação de assinantes, atualização de pacotes e controle de acesso, garantindo uma sincronização eficiente entre o IXC e a plataforma Watch TV.

Para que a plataforma Watch TV possa gerar o arquivo JSON necessário para a integração, é fundamental enviar à equipe Watch a URL de retorno configurada com o domínio de acesso ao sistema IXC.

Exemplo de URL de retorno:

https://seuprovedor.com.br/retorno/watch/

1. Copie o link de acesso ao seu sistema IXC;
2. Remova o sufixo /adm.php ou /login.php, mantendo apenas a estrutura base do domínio (ex.: https://seudominio.com.br).
3. Acrescente ao final do link a seguinte estrutura: /retorno/watch/.
4. A URL de retorno final terá a seguinte forma: https://seudominio.com.br/retorno/watch/.

Após configurar a URL de retorno, envie-a para a equipe Watch, que será responsável pela geração do arquivo JSON necessário para estabelecer a integração.

Passo 2: Cadastro da Integração

Neste passo, é efetuado o cadastro da integração com o arquivo JSON gerado. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma Watch TV.

1. Acesse o formulário Integrações através do caminho: Configurações > Integrações;
2. Clique em Integrações TV;
3. Pressione o botão Novo;
4. Selecione Watch TV no campo Plataforma;
5. No campo Arquivo JSON, Insira o Arquivo JSON fornecido pela plataforma;
6. Clique em Salvar para estabelecer a comunicação entre o IXC e a plataforma e para concluir o cadastro da integração;
7. Após salvar a integração, o campo Token de Acesso é preenchido automaticamente como um retorno da plataforma, indicando que a comunicação com a Watch foi estabelecida com sucesso.

Expiração do token:

O token possui uma validade de 6 horas, mas é renovado automaticamente a cada requisição realizada no sistema que interaja com a plataforma Watch. Isso inclui ações como a criação da integração, ativação ou inativação de usuários de TV, busca de pacotes ou deleção de usuários de TV. Essas operações garantem a atualização contínua do token, mantendo a comunicação com a plataforma sempre ativa.

Passo 3: 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.

1. Acesse o formulário de Cadastro de Produtos através do caminho: Sistema > Cadastros > Produtos;
2. Pressione o botão Novo;
3. Preencha os campos obrigatórios na aba Produtos e na aba Planejamento;
4. Acesse a aba TV;
5. No campo Plataforma, selecione a opção Watch TV;
6. Preencha o campo:
   • Pacote Watch: clique sobre o botão Buscar pacote Watch e selecione um pacote para o produto que está cadastrando.

Atenção:

Os pacotes apresentados são os pacotes disponibilizados pela Watch, onde o sistema realiza uma consulta na plataforma da Watch e exibe os pacotes correspondentes.

9. Os campos de Descrição e Total tickets serão apresentados. Ambos são preenchidos a partir do retorno da Watch, indicando a descrição do pacote selecionado e o total de tickets ativos para este produto, respectivamente.
10. Clique em Salvar para validar e finalizar o cadastro do produto.

Passo 4: Produto no Contrato

Para realizar a gestão do contrato efetivamente, é 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.

1. Acesse o Formulário Contrato do Cliente através do caminho: Sistema > Cadastros > Contratos;
2. Selecione o contrato do cliente do qual deseja incluir o produto no contrato;
3. Pressione o botão Editar para acessar o contrato;
4. 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 5: 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.

1. Ainda no contrato do cliente, navegue até a aba TV;
2. Clique no botão Novo e preencha os campos apresentados:
   • Plataforma: no botão de seleção, selecione a opção Watch TV;
   • API: selecione a opção Alterar na API e no IXC para ter comunicação com a plataforma. Ao utilizar a opção Ignorar API e alterar apenas no IXC, não obtém comunicação com a Watch e, portanto, não envia a requisição de criação de usuário à plataforma, criando somente no sistema;
   • 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;
   • Token assinante: retorno da plataforma Watch, token que estabelece a comunicação entre o sistema e a Watch baseado no login TV.
3. 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

Bloqueio por Inadimplência

1. Cliente não realiza o pagamento do boleto mensal em relação ao serviços contratados com o provedor.
2. No tipo de cobrança do contrato desse cliente, foi parametrizado os dias em atraso para ocorrer o bloqueio.
3. A rotina de bloqueio automático é executada no sistema.
4. Ocorre então o bloqueio do contrato no sistema e por consequência, a inativação do usuário Watch TV.

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.

Cancelamento de Serviço

1. Cliente realiza a solicitação de cancelamento e então o departamento responsável assume a demanda de cancelamento do contrato.
2. No contrato, é definido o dia de cancelamento, o financeiro é ajustado conforme acordado entre as partes e ocorre o cancelamento manual do contrato;
3. Ocorre então a desativação do contrato no sistema e por consequência, a desativação do usuário Watch TV.

Ativar e Desativar Usuário TV Watch

A integração do sistema com a plataforma Watch TV permite realizar alterações manuais de status através dos botões Ativar e Desativar diretamente no usuário TV, de forma independente do contrato. O status do usuário TV pode ser controlado de duas formas:

• Ativar: permite realizar a ativação do usuário TV, para retomar o consumo do usuário;
• Desativar: permite que o cliente tenha somente o usuário de TV inativado, sem cancelar o contrato. Este corte é efetuado fazendo com que o usuário TV não tenha mais acesso à plataforma.

1. Acesse a grid de Usuários TV através do caminho sistema > Cadastros > aba TV/SVA > Usuários TV;
2. Selecione o usuário TV do qual deseja realizar o ajuste de status;
3. Clique no botão Ativar usuário para ativar o usuário TV e/ou no botão Desativar usuário para inativar um usuário TV, interrompendo seu consumo.

Considerações Finais

A integração Watch TV com o sistema oferece uma solução robusta para provedores de internet, simplificando a gestão de serviços de TV e streaming. Esta tecnologia melhora a eficiência operacional, reduz erros de informação e proporciona uma experiência superior aos clientes.

Etiquetas

Integracoes IntegracoesTV IntegracaoWatchTV WatchTV Streaming Conteudo

Leia Também

• Integrações
• Integrações de TV
• Cadastro de Produtos
• Cadastro de contratos no Sistema
• Contrato do Cliente
• Aba TV - Contrato do cliente
• Usuários TV
• Formulário Cliente