Integrações TV - Ministra
Introdução
O que é a Ministra?
A Ministra é uma plataforma de transmissão de TV e processamento de sinais que oferece um amplo leque de serviços de conteúdo audiovisual ao seu provedor. 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 Ministra 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:
- 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
Entrega de Valor
- Alinhar as necessidades dos clientes que utilizam streaming e TV por assinatura com a plataforma Ministra;
- 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. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma Ministra.
-
No menu principal, navegue até Configurações;
-
Selecione Integrações;
-
Clique em Integrações TV;
-
Pressione o botão Novo;
-
Selecione Ministra 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 do usuário API na Ministra, informação fornecida pela plataforma;
- Senha TV: refere-se à informação de senha do usuário API na Ministra, informação fornecida pela plataforma;
- ID filial: selecione a filial da qual a integração pertence. Filial da qual os dados serão considerados, de acordo com a filial do contrato do cliente.
-
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.
- No menu principal, navegue até Sistema;
- Selecione Cadastros;
- Clique em 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 Ministra;
- Preencha os campos:
- ID integração: clique sobre a lupa e selecione a integração cadastrada para a Ministra;
- 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 Ministra.
- ID pacote temporário: clique no botão Buscar pacote. O sistema irá apresentar os produtos temporários disponibilizados quando o cliente estiver inadimplente. Selecione e insira o ID do pacote temporário do qual o cliente terá acesso neste produto;
- Dias para expiração do pacote temporário: quantidade de dias em que o cliente terá acesso ao produto temporário.
- 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.
- No menu principal, navegue até Sistema;
- Selecione Cadastros;
- Clique em Contrato;
- 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 Ministra;
- Tipo de tecnologia TV: defina o tipo de tecnologia do produto;
- Produto/Serviço: clique sobre a lupa e selecione o produto de TV vinculado ao contrato;
- 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;
- MAC devices: número do equipamento entregue ao cliente caso o utilize. Caso haja mais de um, deve ser separado por ponto e virgula;
- Version: preenchido automaticamente com o retorno da API;
- IP: preenchido automaticamente com o retorno da API;
- Online: preenchido de acordo com o status de acesso do contrato. Se online, indica que está ativado e consumindo. Se offline, está bloqueado.
- Após preencher os campos, clique em Salvar para validar as modificações e efetivar a criação do usuário TV.
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).
Lembrete:
Depois de criado o login, o sistema não permitirá sua edição.
Casos de Uso
Ações do Contrato
A integração com a plataforma da Ministra 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 Ministra valida as seguintes ações sobre o contrato, impactando no acesso do usuário TV. Estas ações incluem:
- 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.
Atenção:
Evite deletar um usuário TV diretamente pelo painel de controle da Ministra. A comunicação entre as plataformas ocorre apenas de IXC Provedor para a Ministra, 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 Ministra 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 IntegracaoMinistra Ministra Streaming Conteudo