Integrações TV - YouCast
Introdução
Definição - YouCast:
A YouCast é 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.
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
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.
- 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 YouCast no campo Plataforma;
- 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.
- 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.
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 YouCast;
- Preencha o campo:
- ID Pacote: clique no botão Buscar pacote e selecione o produto a ser ofertado 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 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.
- Acesse o Formulário Contrato do Cliente através do caminho: Sistema > Cadastros > 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 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.
- 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 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 pelo 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, portanto, se o usuário TV for deletado no IXC Provedor, todos os registros relacionados à ele serão removidos do sistema será deletado na plataforma.
Atenção:
Evite deletar um usuário TV diretamente pelo backoffice 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.
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.
Deletar Usuário TV YouCast
Para deletar um usuário TV YouCast, siga os passos a seguir:
- Acesse o contrato do cliente do qual deseja realizar a deleção do usuário TV através do caminho: Sistema > Cadastros > Contratos;
- Selecione o contrato do cliente e clique em Editar;
- Acesse a Aba TV - Contrato do cliente;
- 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 IntegracoesTV IntegracaoYouCast YouCast Streaming Conteudo