# Integração TV - Watch TV

## Introdução

>[!TIP] Definição - Watch TV:
> A [Watch TV](https://descubra.watch.tv.br/para-provedores/?gad_source=1&gclid=CjwKCAiApsm7BhBZEiwAvIu2X-ZfYL2ZFGZELEwX1XUX06YUc72JiywmEQJsWMfnQzXDUoMJoTCJFBoCYqcQAvD_BwE) é 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.

  > [!NOTA] **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

>[!caution] 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. <br>

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

>[!INFO] **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.

>[!INFO] **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 [[integracoes|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.

> [!TIP] 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.

>[!INFO] Importante:
>O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.

1. Acesse o formulário de [[cadastro de produtos|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.
	
>[!NOTA]  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 [[formulario planos de venda|Formulário Planos de Venda]].

1. Acesse o [[formulario contrato do cliente|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.

>[!SUCCESS] 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.

### 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 [[usuarios tv - master abril 2025|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 #UsuariosTV

## Para mais informações sobre funcionalidades específicas, consulte:
- [[integracoes|Integrações]]
- [[integracoes de tv|Integrações de TV]]
- [[cadastro de produtos|Cadastro de Produtos]]
- [[cadastro de contratos no sistema|Cadastro de contratos no Sistema]]
- [[formulario contrato do cliente|Formulário Contrato do Cliente]]
- [[aba - tv - contrato do cliente|Aba TV - Contrato do cliente]]
- [[public/menu sistema/cadastros/pasta tv sva/login tv/usuarios tv|Usuários TV]]
- [[formulario cliente|Formulário Cliente]]