# Integrações TV - YouCast

## Introdução


>[!tip] Atenção!
>Este conteúdo está presente na **versão [[clientes beta ixc soft|Beta]]** do sistema.
>A disponibilidade desta integração na **versão Estável** será a partir de Abril de 2025.

---

>[!TIP] **Definição - YouCast**:
> A [YouCast](https://youcast.tv.br/) é 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 YouCast 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
A contratação de um **módulo** é necessária para a liberação da integração no sistema IXC. Para realizar a contratação do módulo, entre em contato conosco mediante um atendimento direcionado ao departamento **Administrativo Financeiro**.

## Entrega de Valor
- Alinhar as necessidades dos clientes que utilizam streaming e TV por assinatura com a plataforma YouCast;
 - 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

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

### Passo 1: Cadastro da Integração
Neste passo, é efetuado o cadastro da integração com os dados API fornecidos pela plataforma. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma YouCast.

1. Acesse o formulário de [[integracoes de tv|Integrações de TV]] através do caminho: Configurações > Integrações > Integrações TV;
2. Pressione o botão **Novo**;
3. Selecione **YouCast** no campo **Plataforma**;
4. Preencha os campos:
	- **IP Integração:** este campo se refere à URL fornecida pela plataforma credenciada. Ela é responsável por "liberar o acesso" do sistema IXC Soft à plataforma PlayHub para estabelecer a comunicação entre as plataformas envolvidas;
	- **Login TV:** refere-se à informação de API Key (chave de login) na PlayHub, informação fornecida pela plataforma;
	- **Senha TV:** refere-se à informação de API Secret (senha) na PlayHub, informação fornecida pela plataforma;
	- **IP MW YouCast:** endereço IP referente à plataforma Middleware (MW) da YouCast. É o ponto de acesso para receber os dados enviados a partir do software IXC Soft.
	- **Login MW YouCast:** nome de usuário ou identificador usado para autenticação na plataforma Middleware (MW) da YouCast.
	- **Secret MW YouCast:** secret ou token de autenticação utilizado em conjunto com o login na plataforma Middleware (MW) da YouCast. Esta senha é essencial para garantir a segurança da integração e autorizar o acesso aos recursos de ambas as plataformas.
	  
5. Clique em **Salvar** para estabelecer a comunicação entre o IXC e a plataforma e para concluir o cadastro da integração.

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

>[!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 **YouCast**;
6. Preencha o campo:
	- **ID Pacote:** clique no botão de **Buscar pacote** e selecione o produto que será ofertado ao cliente. Este produto deve ser compatível aos seus produtos contratados com a YouCast.
	
7. Clique em **Salvar** para validar e finalizar o cadastro do produto.

### Passo 3: 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. Pressione o botão **Editar** para acessar o contrato;
3. 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.

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 YouCast;
	-  **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;
	- **Account ID:** campo preenchido automaticamente ao estabelecer a comunicação do login após salvá-lo. É o ID do usuário TV na plataforma;
	- **Usar e-mail principal:** se **sim**, utiliza o e-mail do cadastro do cliente. Se **não**, preencher manualmente;
	- **Profile name:** preenchido a partir da Razão Social do cadastro do cliente;
	- **Pin:** campo para inserir senha de acesso a canais bloqueados, onde pode se localizar no cadastro usuário TV e inserido manualmente, um campo de numeros com 4 dígitos
	- **Birthday:** data de nascimento no cadastro do cliente;
	- **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;
	- **Status:** status do login, se ativo ou inativo. Acompanha ações do contrato que influenciam no status de acesso;
	- **Portal:** clique em **Buscar portal** para definir o portal de acesso deste usuário TV;
	- **MAC devices:** número do equipamento entregue ao cliente caso o utilize. Caso haja mais de um, deve ser separado por ponto e virgula.
	
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

### Ações do contrato
A integração com a plataforma da YouCast 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 a partir do status do contrato:

A integração com a plataforma YouCast 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 YouCast 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 de **bloqueio total**.
  
- **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.
  
- **Cancelamento**: ao cancelar o contrato, o login TV será inativado.
  
- **Deleção**: a integração permite deleção. 
  
>[!DANGER] **Atenção:**
>Evite deletar um usuário TV diretamente pelo painel de controle da YouCast. A comunicação entre as plataformas ocorre apenas de IXC Provedor para a YouCast, 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.

### Deleção de Usuário TV YouCast
Para realizar a deleção de um usuário TV YouCast, siga os passos a seguir:

1. Acesse o contrato do cliente do qual deseja realizar a deleção do usuário TV através do caminho: Sistema > Cadastros > Contratos;
2. Selecione o contrato do cliente e clique em **Editar**;
3. Acesse a [[aba - tv - contrato do cliente|Aba TV - Contrato do cliente]];
4. Em seguida, selecione o usuário TV YouCast e clique no botão **Deletar**. Confirme a ação. O registro será removido do sistema.

## Considerações Finais
A integração YouCast 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 #IntegracaoTV #YouCast  #Streaming #IPTV 

## Para mais informações sobre funcionalidades específicas, consulte:
- [[integracoes|Integrações]]
- [[integracoes de tv|Integrações de TV]]
- [[public/menu sistema/cadastros/pasta tv sva/login tv/usuarios tv|Usuários TV]]
- [[aba - tv - contrato do cliente|Aba TV - Contrato do cliente]]