Integrações TV - Panaccess
Introdução
Definição - Panaccess:
A Panaccess é 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 entre a Panaccess 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:
- Possuir uma conta ativa na Panaccess;
- Obter os dados de acesso API 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 Panaccess;
- 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 Panaccess.
- Acesse o formulário Integrações através do caminho: Configurações > Integrações;
- Clique em Integrações TV;
- Pressione o botão Novo;
- Selecione Panaccess no campo Plataforma;
- Preencha os campos:
- Ambiente: defina se a integração encontra-se em produção (uso ativo de disponibilização ao cliente) ou em homologação (testes);
- URL acesso: insira a URL fornecida pela plataforma, essa URL será necessária para estabelecer a comunicação entre as duas plataformas e é o destino do qual o IXC irá enviar as informações cadastradas;
- Token acesso: token fornecido pela plataforma;
- Login TV: refere-se à informação usuário API, informação fornecida pela plataforma;
- Senha TV: refere-se à informação de senha do usuário API, informação fornecida pela plataforma;
- HC (Head Control): código da licença do provedor, adquirida com a plataforma;
- Sessão: preenchido automaticamente com a chave da sessão ao realizar a importação dos produtos.
- Clique em Salvar para estabelecer a comunicação entre o IXC e a plataforma e para concluir o cadastro da integração.
Passo 2: Importação dos Pacotes Panaccess
A plataforma Panaccess atua com os produtos disponibilizados aos clientes através do cadastramento de pacotes na plataforma. Para a disponibilização destes pacotes ao usuário final a partir do vínculo com o produto, é necessário realizar a importação destes pacotes a partir de uma tarefa, visando a sincronização destes dados entre as plataformas envolvidas. A tarefa Importar Produtos Panaccess TV é responsável pela importação, e pode ser configurada realizando o seguinte processo:
- Acesse o formulário de Agenda de tarefas através do caminho: Ferramentas > Ferramentas > Agenda de tarefas;
- Clique no botão Novo para cadastrar a tarefa;
- No campo Tarefa, selecione a opção Importar Produtos Panaccess TV;
- Preencha o horário em que a tarefa executará a partir dos campos de Minuto e Hora. No campo Minuto, indique o minuto em que a tarefa executará, correlacionando ao campo de hora. No campo Hora, indique o horário em que a tarefa executará;
Exemplo:
Para que uma tarefa execute as 7h30, insira o número 7 no campo Hora e o número 30 no campo Minuto.
- Na seção Dia do mês, insira no campo Valor o intervalo “1-31” para que o sistema execute a tarefa todos os dias do mês;
- Na seção Mês, insira no campo Valor o intervalo “1-12” para que o sistema execute a tarefa todos os meses;
- Na seção Dia da semana, insira no campo Valor o intervalo “0-6” para que o sistema execute a tarefa todos os dias da semana.
- Após preencher os campos, clique em Salvar para validar a criação da tarefa;
- Execute a tarefa para efetuar a sincronização dos pacotes, o sistema irá buscar as informações dos produtos liberados pela Panaccess, possibilitando o cadastro dos produtos. Para isso, clique em Listar para verificar a tarefa criada, localize-a na agenda de tarefas e clique em Executar Tarefa.
Após efetuar a importação dos pacotes de TV, os produtos importados estarão disponíveis para visualização e edição no formulário de TV Pacotes.
Acesso ao formulário TV Pacotes
Caminho: Sistema > Cadastros > pasta TV > Pacotes TV
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.
- 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 Panaccess;
- Preencha os campos:
- ID integração: clique na lupa e selecione a plataforma de TV cadastrada no sistema;
- Produtos disponíveis: clique no botão de seleção e selecione o produto que será ofertado ao cliente. Será apresentada uma lista dos pacotes importados ao sistema, sendo os mesmos pacotes disponibilizados e cadastrados na plataforma Panaccess.
- 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.
- Acesse o Formulário Contrato do Cliente através do caminho: Sistema > Cadastros > Contratos;
- Selecione o contrato do cliente do qual deseja incluir o produto no 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 5: Cadastro do Assinante e Ativação do SmartCard Panaccess
A ativação do usuário TV consiste em criar as credenciais de acesso para o usuário final e associar o SmartCard correspondente. A partir da ativação, o usuário TV obtém acesso à plataforma e aos produtos disponibilizados
Acesso do assinante ao produto:
O acesso do assinante é baseado no vínculo do produto no contrato. Portanto, ao realizar a associação do produto no contrato do cliente, uma vez que ele esteja relacionado ao seu respectivo pacote na plataforma, será disponibilizado o produto a partir da ativação do usuário TV/SmartCard.
Ativação do Assinante
- 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 Panaccess;
- ID integração: clique na lupa e selecione o cadastro da integração
- 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;
- Portal: clique em Buscar portal para definir o portal de acesso deste usuário TV;
- Após preencher os campos, clique em Salvar para validar as modificações e efetivar a criação do usuário TV.
Associação do SmartCard Panaccess
Definição SmartCard:
Um SmartCard, ou cartão inteligente em português, é um dispositivo portátil que contém um microprocessador incorporado e é projetado para armazenar, processar e fornecer informações de maneira segura.
Um SmartCard para TV, é um cartão inteligente para sistemas de televisão por assinatura e tem como objetivo autenticar o usuário, desbloqueando canais para os quais o usuário tem direito, com base no pacote de assinatura que adquiriu.
- Ainda no formulário de Usuário TV, acesse a aba SmartCard para vincular o SimCard ao assinante;
- Na aba SmartCards, clique no botão Novo;
- Preencha os campos:
- SmartCard (obrigatório): clique no botão Buscar SmartCard e selecione uma das opções apresentadas;
- Validade (obrigatório): indique uma quantidade numérica em unidade de medida de meses para definir a validade de acesso deste cartão;
- Status: preenchido automaticamente de acordo com o acesso e uso do cartão.
- Clique em Salvar para finalizar a criação do usuário TV e ativação do SimCard.
Controle de acesso:
Ativar/Desativar: É possível realizar a ativação e desativação do assinante a partir do botão de ação Ativar/Desativar, gerenciando o acesso do usuário;
Deletar: É possível inativar um SimCard a partir da sua deleção, a partir do botão de ação Deletar, excluindo o registro do sistema.
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 Panaccess 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 Panaccess 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 Panaccess 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 painel de controle da Panaccess. A comunicação entre as plataformas ocorre apenas de IXC Provedor para a Panaccess, 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 Panaccess 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 IntegracaoPanaccess Panaccess SmartCard IPTV Conteudo