¶ Integração V-Tal FTTP
O conceito de redes neutras é relativamente novo no mercado de ISPs. De forma simples, uma rede neutra é uma rede de acesso, geralmente construída com fibra ótica, que pode ser compartilhada por várias empresas provedoras de acesso à internet (ISPs).
Atualmente existem duas metodologias de trabalho adotadas, nessa página iremos falar um pouco sobre o modelo FTTP.
Nessa metodologia, o provedor de acesso à internet é responsável por executar o último trecho para atendimento ao assinante, como instalação dos cabos drop e configuração da CPE do assinante. Dessa forma, sempre que for necessário executar uma O.S de reparo na casa do assinante, a responsabilidade é integralmente do provedor de acesso à internet que está contratando a rede neutra.
Para que um ISP utilize o Hubsoft para ativar clientes em redes neutras através do Hubsoft, é necessário seguir os passos abaixo:
¶ Configuração da Integração
O primeiro passo é a configuração da Integração, que pode ser feita através do módulo Configuração > Integração > Redes Neutras. Nesse painel, é possível cadastrar uma nova integração, contanto que se tenha as credenciais e os parâmetros necessários em mãos.
Os seguintes parâmetros são exigidos ao cadastrar uma nova integração V-Tal:
- Client Key: Informado pela V-Tal após a contratação
- Client Secret: Informado pela V-Tal após a contratação
- Ambiente: Produção, Homologação ou Sandbox
- Modelo de Contratação: Modelo de contratação (selecione o modelo FTTP)
.jpg)
.jpg)
¶ Cadastro dos Serviços
Para que seja possível cadastrar novos assinantes e planos que irão utilizar a rede neutra, primeiro é necessário cadastrar os serviços que serão vendidos em Configuração > Geral > Serviços.
O cadastro de um novo serviço a ser fornecido via rede neutra é idêntico ao cadastro de um serviço comum. A única diferença é a necessidade de configurar os parâmetros na aba Redes Neutras.
Parâmetros necessários:
- Integração de Rede Neutra: Cada serviço só pode estar vinculado a uma integração.
- Identificador do Serviço: Parâmetro textual que identifica o serviço no provedor de redes neutras. A relação de serviços disponíveis para venda deve ser consultada com o provedor de redes neutras previamente.
¶ Configuração dos Tipos de Ordem de Serviço
Para que seja possível abrir chamados técnicos (ou ordens de serviço) que demandem ação conjunta ou exclusiva do provedor de rede neutra, é necessário configurar os Tipos de Ordem de Serviço exclusivos para essa finalidade.
Os Tipos de Ordem de Serviço podem ser criados normalmente no módulo Configuração > Geral > Tipo de O.S. Os parâmetros específicos para redes neutras estão na aba Rede Neutra.
Os seguintes parâmetros estão disponíveis:
- Tipo de Chamado Técnico: Instalação, Suporte ou Retirada.
- Solicitar Abertura de Chamado Técnico: Indica se um chamado técnico deve ser aberto na plataforma sempre que uma O.S desse tipo for aberta no Hubsoft.
- Tipo de Problema: No caso de abertura de chamado técnico na plataforma, identifica qual é o tipo de problema reportado. A lista de problemas possíveis geralmente está documentada no painel da API do provedor de redes neutras.
¶ Configuração de um Técnico
É interessante cadastrar um novo técnico, para casos em que é necessário abrir uma OS com Chamado Técnico, quando está com algum problema na estrutura da Rede Neutra. Isso é importante para garantir que ao abrir uma Ordem de Serviço destinada à rede neutra, a mesma não seja atribuída a um técnico do provedor de acesso à internet, evitando conflitos na execução da O.S. A inclusão de um novo técnico pode ser feita normalmente em Configuração > Geral > Usuários.
¶ Configuração de uma Agenda de O.S
Caso seja necessário realizar agendamentos na plataforma de rede neutra, é viável criar uma Agenda de Ordem de Serviço. A criação da agenda pode ser feita normalmente no módulo Configuração > Geral > Agenda de O.S.
Na configuração da agenda, somente os Tipos de O.S referentes a redes neutras devem ser selecionados, para evitar que os usuários do Hubsoft cometam erros ao abrir ordens de serviço nessa agenda.
Caso seja desejado, pode ser criado um técnico fictício no sistema para representar os técnicos do provedor de rede neutra. Nas imagens abaixo é possível ver um exemplo de agenda criado:
Após a configuração da nova agenda, basta vinculá-la na integração de rede neutra em Configuração > Integração > Redes Neutras.
¶ Consulta de Viabilidade
Para verificar se existe viabilidade para a prestação do serviço no endereço do assinante, é possível executar uma busca de viabilidade na integração de rede neutra e obter uma relação dos serviços disponíveis para a região, caso exista. Para executar a busca de viabilidade, basta seguir o passo a passa abaixo:
- Acessar a ação Consulta de Viabilidade no submenu de clientes:
- Selecionar o tipo de consulta Integrações de Rede Neutra, selecionar a integração e preencher os dados do endereço:
- Clicar no botão de lupa para executar a busca e aguardar o resultado:
O resultado da busca irá conter a lista de serviços disponíveis para a região, caso exista viabilidade.
Somente os serviços cadastrados no Hubsoft são exibidos no resultado!
¶ Cadastro dos Clientes e dos Serviços
Uma vez que todas as configurações prévias estejam prontas e a configuração de rede neutra esteja funcional, é possível cadastrar novos clientes e serviços, para que sejam ativados na nova rede.
O cadastro de um novo cliente, ou a adição de um novo serviço em um cliente já existente segue o mesmo processo para atendimento com infraestrutura própria, com algumas ressalvas:
Não é permitido abrir uma O.S de instalação durante o cadastro do novo plano. A O.S deve ser aberta posteriormente quando o plano já tiver cadastrado.
Não é permitido modificar o endereço de instalação do plano. Caso seja necessário, será preciso cancelar o plano e cadastrar um novo no endereço correto. Um motivo de cancelamento específico para isso pode ser utilizado, para não afetar as estatísticas.
¶ Cadastro do Plano do Cliente na Rede Neutra
Após o cadastro do novo assinante ou do novo plano no Hubsoft, é possível executar o cadastro, ativação e gerenciamento do plano na rede neutra. Para um novo plano, é necessário executar as seguintes etapas:
- Consulta do endereço de instalação na plataforma
- Consulta dos complementos do endereço
- Consulta de viabilidade
- Abertura de OS
- Execução do cadastro do novo plano e Execução da ativação ou vinculação da CPE ao novo serviço
Todas essas etapas podem ser feitas através do painel acessível pelo botão destacado abaixo:
1. Consulta do endereço de instalação na plataforma:
2. Consulta de complementos do endereço:
3. Consulta de Viabilidade:
4. Abertura de Ordem de Serviço:
5. Confirmação dos dados e finalização do cadastro:
¶ Ativação do Serviço na Rede Neutra (Associação de CPE)
Após o serviço ser habilitado e cadastrado corretamente na integração de rede neutra, é necessário efetuar a ativação do serviço na integração de rede neutra. Cada provedor de rede neutra pode necessitar de parâmetros distintos durante a ativação, dependendo do modelo de contratação.
Para a modalidade FTTP, ao ativar um novo serviço, é necessário informar alguns parâmetros, conforme a imagem abaixo:
Parâmetros obrigatórios:
- Serial da ONT: Serial PON do equipamento a ser utilizado no cliente
- Código do Equipamento: Código que descreve o modelo de equipamento que está sendo utilizado. Deve ser consultado previamente com a V-Tal
Para ativar o serviço na integração de rede neutra, o mesmo já deve estar habilitado no Hubsoft e possuir dados de autenticação criados.
¶ Gerenciamento do Plano do Cliente na Integração de Rede Neutra
Para gerenciar e visualizar informações do plano do cliente na integração de rede neutra, é possível acessar o painel através do botão abaixo:
No painel de gerenciamento do serviço, é possível visualizar algumas abas, são elas:
- Ativação: Caso o plano ainda não esteja ativado, permite preencher os parâmetros e solicitar a ativação.
- Geral: Informações e parâmetros gerais do plano.
- Diagnóstico: Histórico de diagnósticos executados e botão para execução de diagnósticos.
- Configuração: Conseguiremos realizar algumas configurações no Equipamento do Cliente
- Ações: Relação de ações executadas no serviço (cadastro, ativação, diagnóstico, etc).
- Transmissão: Informações referentes às chamadas na API, com dados de request e response.
¶ Aba: Ativação
No modelo de contratação FTTP, a ativação é de responsabilidade do provedor de acesso à internet, que deve ser feita após o técnico realizar a instalação da infraestrutura nas dependências do assinante.
Para realizar a ativação, será necessário informar os seguintes parâmetros obrigatórios:
- Serial da ONT: Serial PON do equipamento a ser utilizado no cliente
- Código do Equipamento: Código que descreve o modelo de equipamento que está sendo utilizado. Deve ser consultado previamente com a V-Tal
¶ Aba: Geral
Na imagem abaixo é possível ver as abas disponíveis e as informações da aba Geral:
Nessa aba estão contidas várias informações importantes referentes ao cadastro do plano na integração de rede neutra. É possível visualizar toda a relação de parâmetros que foram utilizados durante as etapas de cadastro e ativação, como também o identificador do plano na integração.
¶ Alteração do Status do Serviço
Foi implementada a possibilidade de alterar o status do serviço de rede neutra, caso os serviços já estejam cancelados/inativos na plataforma, mas ainda aparecem como ativos no sistema Hubsoft.
Dessa forma, caso o serviço esteja em algum dos status abaixo, será exibida uma nova opção:
- aguardando
- aguardando_confirmacao_cadastro
- aguardando_confirmacao_ativacao
- aguardando_confirmacao_inativacao
- aguardando_confirmacao_remocao
Inicialmente, será permitido alterar apenas para o status ‘Removido’. Além disso, cada alteração gerará um histórico no sistema, registrando o status antigo e o novo.
Obs.: Para conseguir utilizar essa funcionalidade, é necessário que o usuário tenha a seguinte permissão:
Cliente > Editar > Serviço > Editar > Rede Neutra > Gerenciar Status do Serviço de Rede Neutra
Obs. 2: Caso o serviço possua alguma ação com status de aguardando, será exibido um erro indicando que é necessário ajustar todas ações para que posteriormente seja alterado o status do serviço.
Importante: A alteração do Status é um procedimento crítico que pode impactar o fluxo operacional do serviço de rede neutra, devendo ser feita com cautela e apenas em casos de necessidade justificada e analisada, visto que é um procedimento irreversível.
¶ Aba: Diagnósticos
Uma vez que o provedor de acesso à internet não possui acesso aos equipamentos do provedor de rede neutra, as integrações fornecem métodos para que o provedor de acesso execute testes e diagnósticos nos planos dos assinantes. Dessa forma, é possível identificar se existem incidentes massivos ou falhas que possam estar impedindo o funcionamento adequado do acesso do assinante. A imagem abaixo demonstra alguns diagnósticos executados:
¶ Aba: Configuração
Após a ativação do plano, conseguiremos realizar algumas configurações nos Dispositivos do cliente, como:
- Ativar/Desativar Wifi
- Reiniciar Dispositivo
- Configurar Senha do Wifi
- Configurar Parametros do Wifi
¶ Aba: Ações
Quase todas as operações executadas em um plano ativado via rede neutra no Hubsoft são representadas através de ações registradas na base de dados. Assim é possível que o usuário acompanhe o status em que a ação se encontra, os parâmetros associados e o resultado final. Na imagem abaixo é possível visualizar o histórico de ações executadas em um plano:
No exemplo acima é possível perceber que uma das ações possui um botão de aviso em vermelho. Algumas ações quando mal-sucedidas possuem uma descrição sobre o que deu errado, que pode ser lida ao clicar no botão de aviso.
¶ Alteração do Status da Ação
Foi implementada a possibilidade de alterar o status da ação de rede neutra, caso as ações já estejam cancelados/inativos na plataforma, mas ainda aparecem como ativos no sistema Hubsoft.
Dessa forma, quando a Ação estiver com status ‘Aguardando’ ou ‘Aguardando Reagendamento’, será exibida uma opção para alterar o status, conforme ilustrado abaixo:
Inicialmente, será permitido alterar apenas para o status ‘Cancelado’. Além disso, cada alteração gerará um histórico no sistema, registrando o status antigo e o novo.
Obs.: Para conseguir utilizar essa funcionalidade, é necessário que o usuário tenha a seguinte permissão:
Cliente > Editar > Serviço > Editar > Rede Neutra > Gerenciar Status da Ação de Rede Neutra
Importante: A alteração do Status é um procedimento crítico que pode impactar o fluxo operacional do serviço de rede neutra, devendo ser feita com cautela e apenas em casos de necessidade justificada e analisada, visto que é um procedimento irreversível.
¶ Aba: Transmissão
A aba transmissão armazena de forma bruta, os dados de requisições e respostas da API de rede neutra. Essa funcionalidade é útil para diagnóstico de possíveis problemas ou bugs.
¶ Abertura de O.S no Provedor de Rede Neutra
Em alguns casos, pode ser que seja necessário abrir uma O.S no provedor de rede neutra, em situações que o provedor de acesso à internet não consiga resolver o problema por conta própria. Por exemplo:
- Agendamento de O.S para verificar problemas encontrados durante a ativação
- Agendamento de O.S para reparos na conexão do assinante, quando é detectado que o problema se encontra na infraestrutura do provedor de rede neutra
O processo de abertura de O.S nesses casos é feito através do processo padrão do Hubsoft. A diferença se encontra na seleção adequada do Tipo de O.S e da Agenda de O.S.
¶ Observações Importantes
Algumas ações executadas nos planos são feitas em background, como por exemplo o bloqueio e desbloqueio do plano em caso de inadimplência, ou troca de velocidade do plano. Essas ações são processadas periodicamente por uma rotina. O status e os parâmetros de cada ação podem ser visualizados na aba Ações.
Em algumas plataformas, como a V-Tal, várias ações são executadas de forma assíncrona. Isso significa que primeiro a solicitação é realizada e agendada na plataforma, posteriormente uma notificação é enviada para o Hubsoft informando se a ação foi finalizada ou não. Nesses casos as ações aparecem com o status aguardando.
É possível visualizar as notificações enviadas pela integração de rede neutra para o Hubsoft, através do painel de gerenciamento de integrações (Configuração > Integrações > Rede Neutra > Ações > Callbacks):
A nossa equipe também está sempre presente para ajudar nessas configurações. Em caso de dúvidas, entre em contato conosco.
¶ Peculiaridades
Várias ações ou requisições na API da V-Tal, são executadas de forma assíncrona, ou seja, a resposta que indica se a operação foi bem-sucedida não chega em tempo real, e sim através de uma notificação enviada por eles posteriormente. Por esse motivo, as ações possuem um campo status dentro do Hubsoft, indicando se estão aguardando ou finalizadas.