Mudanças entre as edições de "Configurações MVNO Tip"

De Grupo Voalle
 
(17 revisões intermediárias por 4 usuários não estão sendo mostradas)
Linha 1: Linha 1:
  
 
===MVNO TIP===
 
===MVNO TIP===
 
 
Serviço de Telefonia Móvel - MVNO integrado ao ERPVoalle.
 
Serviço de Telefonia Móvel - MVNO integrado ao ERPVoalle.
  
Linha 7: Linha 6:
 
Explicar como devem ser feitas as configurações necessárias para utilizar a Integração de MVNO Tip.  
 
Explicar como devem ser feitas as configurações necessárias para utilizar a Integração de MVNO Tip.  
  
Alguns passos serão realizados internamente, pela equipe da Voalle, e outros devem ser feitos por você, usuário do ERP Voalle. <br />
+
Alguns passos serão realizados internamente, pela equipe do Grupo Voalle, e outros devem ser feitos por você, usuário do ERPVoalle. <br />
  
 
===Pré-Requisitos===
 
===Pré-Requisitos===
A empresa já deve utilizar em sua operação o CRM - Voalle e a nova tela de atendimento.
+
A empresa já deve utilizar em sua operação o CRM Voalle e a nova tela de atendimento.
 
 
  
 
==Passo a passo da configuração==
 
==Passo a passo da configuração==
'''1.''' {{Icone|tipo=cliente}} Entre em contato com a Tip e com sua equipe de TI, solicitando as informações detalhadas no documento abaixo:
+
'''1.''' {{Icone|tipo=cliente}} Entre em contato com a Tip e com sua equipe de TI solicitando as informações detalhadas no documento abaixo:
  
 
[[:File:Formulario_C07 (1).pdf]]
 
[[:File:Formulario_C07 (1).pdf]]
Linha 22: Linha 20:
 
* CPF
 
* CPF
 
* E-mail
 
* E-mail
<br />
+
<br />
 
+
'''2.''' {{Icone|tipo=cliente}} Envie o documento '''complementação preenchido''' acima à equipe '''Comercial''' da Voalle.<br />
'''2.''' {{Icone|tipo=cliente}} Envie o documento '''complementação preenchido''' acima à equipe '''Comercial''' da Voalle.<br />
 
  
'''3.''' {{Icone|tipo=voalle}} Equipe '''Comercial''' após receber o documento preenchido , enviadas pelo cliente, deve encaminhar a solicitação à equipe de '''Entregas da Voalle''', que irá entrar em contato com o cliente, passando informações e prazos de homologação. <br /><br  />
+
'''3.''' {{Icone|tipo=voalle}} Equipe '''Comercial''' após receber o documento preenchido, enviadas pelo cliente, deve encaminhar a solicitação à equipe de '''Entregas da Voalle''', que irá entrar em contato com o cliente, passando informações e prazos de homologação. <br />
  
{{Icone|tipo=voalle}} === Configurações - V-DI===
+
==={{Icone|tipo=voalle}} Configurações - V-DI===
'''1.''' Solicitar a equipe responsável a criação da base V-DI no banco de dados - PostgreSQL para o cliente.<br />
+
'''1.''' Solicitar à equipe responsável a criação da base V-DI no banco de dados - PostgreSQL para o cliente.<br />
  
'''2.''' Com a base V-DI criada, realize os cadastros da Empresa, Integradores e Parceiros.<br />
+
'''2.''' Com a base V-DI criada, realize os cadastros da Empresa, Parceiro e Integradores, nessa ordem.<br />
 +
* Para o cadastro do parceiro é necessária a geração de uma chave única que será informada no campo ERP KEY na aba configurações. Será usada esta mesma chave também nas configurações globais para vincular o ERP ao V-DI;
 +
** Site com a funcionalidade: https://www.uuidgenerator.net/guid<br /><br />
  
'''3.''' Realize o cadastro do Usuário responsável para o cliente, assim, ele terá acesso para realizar os demais cadastros e configurações necessárias.<br />
+
'''3.''' Realize o cadastro do Usuário responsável para o cliente, desse modo, ele terá acesso para realizar os demais cadastros e configurações necessárias.<br />
  
'''4.''' Realize as configurações de parâmetros com as informações de "e-mail" fornecidas pelo cliente.<br />
+
'''4.''' Realize as configurações de parâmetros com as informações de e-mail fornecidas pelo cliente.<br />
  
Dúvidas relacionadas a este processo, podem ser consultadas em: [[V-DI_(Voalle_Data_Integration)| V-DI]]<br />
+
Dúvidas relacionadas a este processo podem ser consultadas em: [[V-DI_(Voalle_Data_Integration)| V-DI]]<br />
  
 
==={{Icone|tipo=voalle}} Configurações - ERP===
 
==={{Icone|tipo=voalle}} Configurações - ERP===
 +
'''1.''' Solicitar a equipe Administrativo para ser habilitado o módulo V-DI no ERP da empresa.
  
 +
==={{Icone|tipo=cliente}} Configurações - ERP===
 +
'''1.''' Configurar os parâmetros do ERP em: Configurações / Parâmetros, menu Voalle Data Integration | V-DI
 +
** '''ERP KEY:''' Informar a Chave do ERP gerada no cadastro de Parceiros do V-DI. Para ver a chave, basta clicar sobre o registro do Parceiro cadastrado.<br />
 +
** '''API KEY:''' Informar a Chave da API gerada no cadastro de Parceiros do V-DI. Para ver a chave, basta clicar sobre o registro do Parceiro cadastrado.<br />
 +
** '''URL BASE:''' Informar a URL do V-DI, porém alterar a porta para 45720 ao invés de 45721<br />
  
==={{Icone|tipo=cliente}} Configurações - ERP===
+
<br />
  
'''1.''' Realize o cadastro de Integradores em: Manutenções / Integrações / Integradores.
+
'''2.''' Realize o cadastro de Integradores em: Manutenções / Integrações / Integradores.
Dúvidas relacionadas a este processo, podem ser consultadas em: [[Integradores]] - “Como cadastrar um novo Integrador”.<br />
+
Abaixo, seguem os campos a serem preenchidos para essa integração. Dúvidas relacionadas a este processo podem ser consultadas em: [[Integradores]] - “Como cadastrar um novo Integrador”.<br />
  
'''2.''' Realize o cadastro de Webhooks em: Manutenções / Integrações / Integrações Webhooks.
+
{| class="wikitable"
Dúvidas relacionadas a este processo, podem ser consultadas em: [[Cadastro_de_Webhooks]] - “Como cadastrar um Webhook”.<br  />
+
|+ 
 +
|-
 +
!Campo
 +
!Dado
 +
|-
 +
|Alias
 +
|tip_mvno
 +
|-
 +
|Descrição
 +
|Título livre
 +
|-
 +
|Tipo de integração
 +
|Reativa
 +
|-
 +
|V-DI
 +
|Sim
 +
|-
 +
|URL
 +
|Preencher com uma barra "/"
 +
|-
 +
|Versão
 +
|2.0 (MVNO)
 +
|-
 +
|Integration Key
 +
|Hash gerado ao cadastrar o integrador no V-DI, copiar a informação do campo Chave da Integração ao clicar sobre o registro.
 +
|}
 +
'''Obs: Campos não informados não devem ser preenchidos. '''
  
'''3.''' Marcar o parâmetro “Utilizar Webhooks” nos parâmetros globais do sistema em: Configurações / Parâmetros / Service Desk.<br />
+
'''3.''' Realize o cadastro de Webhooks em: Manutenções / Integrações / Integrações Webhooks.
 +
Abaixo, seguem os campos a serem preenchidos para essa integração. Dúvidas relacionadas a este processo, podem ser consultadas em: [[Cadastro_de_Webhooks]] - “Como cadastrar um Webhook”.<br />
  
'''4.'''  Realize cadastro dos Serviços de Telefonia Móvel em: Faturamento / Cadastros / [[ Produtos/Serviços - Cadastro Serviços | Produtos/Serviços]];<br  />  
+
{| class="wikitable"
*Marque a opção '''Serviço Composto''' como '''sim'''.<br />  
+
|-
*No campo '''tipo de serviço''' selecione a opção '''telefonia móvel'''.<br  />
+
!Campo
*A seleção do tipo telefonia móvel, fará com que sejam adicionados dois novos campos de preenchimento obrigatório, sendo eles:<br  />
+
!Dado
**'''Empresa de Integração:''' selecione a empresa Integradora.<br  />
+
|-
**'''Código de Integração:''' preencha com o código do plano/serviço na integradora.<br/>
+
|Nome do webhook
*Após a criação do serviço, edite o mesmo, e realize a configuração da sua composição.<br />
+
|Título livre
*Caso desejado, controlar o estoque de ICCIDs, através da utilização de kits, deverá ser preenchido o campo “kit” no cadastro do serviço de telefonia móvel criado. Dúvidas relacionadas a este processo, podem ser consultadas em: [[Kits]] - “Como cadastrar um Kit” e “Como vincular o Kit a um Serviço”.<br/><br>
+
|-
 +
|Integrator
 +
|Selecionar a integração cadastrada no passo anterior
 +
|-
 +
|Método HTTP
 +
|POST
 +
|-
 +
|Url
 +
|<nowiki>https://synsuite.SEUDOMINIO.com.br:45720/api/v1/receive</nowiki>
 +
<br />
 +
|-
 +
|Limite de tentativas de Integrar
 +
|15
 +
|-
 +
|Lista de E-mails caso chegue ao máximo de tentativas
 +
|Conforme informado pelo cliente.<br />Caso o cliente informe mais de 1 e-mail, separar por ponto e virgula ";"
 +
|}
 +
'''Obs. Campos não informados não devem ser preenchidos.'''
  
 +
'''4.''' Marcar o parâmetro “Utilizar Webhooks” nos parâmetros globais do sistema em Configurações / Parâmetros / Service Desk.<br />
  
'''5.''' Vincular os serviços novos na rotina CRM - Voalle / Operações / Dashboard - Parâmetros do CRM, menu Lista de Preço<br />
+
'''5.''' Realize cadastro dos Serviços de Telefonia Móvel em Faturamento / Cadastros / [[ Produtos/Serviços - Cadastro Serviços | Produtos/Serviços]];<br />
A lista de preço será vinculada a campanha e conforme parametrização os serviços serão listados durante a venda.
+
** Marque a opção '''Serviço Composto''' como '''sim'''.<br />
 +
** No campo '''tipo de serviço''' selecione a opção '''telefonia móvel'''.<br />
 +
** A seleção do tipo telefonia móvel, fará com que sejam adicionados dois novos campos de preenchimento obrigatório, sendo eles:<br />
 +
*** '''Empresa de Integração:''' selecione a empresa Integradora.<br />
 +
*** '''Código de Integração:''' preencha com o código do plano/serviço na integradora.<br />
 +
** Após a criação do serviço, edite o mesmo, e realize a configuração da sua composição.<br />
 +
** Caso desejado controlar o estoque de ICCIDs através da utilização de kits, deverá ser preenchido o campo “kit” no cadastro do serviço de telefonia móvel criado. Dúvidas relacionadas a este processo, podem ser consultadas em: [[Kits]] - “Como cadastrar um Kit” e “Como vincular o Kit a um Serviço”.<br /><br />
  
 +
'''6.''' Vincular os serviços novos na rotina CRM - Voalle / Operações / Dashboard - Parâmetros do CRM, menu Lista de Preço. A lista de preço será vinculada a campanha e conforme parametrização os serviços serão listados durante a venda.
  
 
==={{Icone|tipo=cliente}} Configurações - V-DI===
 
==={{Icone|tipo=cliente}} Configurações - V-DI===
'''1.''' Revise os cadastros realizados pela equipe Voalle.<br  />
+
'''1.''' Crie cadastros de CNs, Operadora Doadora e Planos.<br />
 
+
Os planos cadastrados no V-DI, precisam possuir o mesmo código informado no ERP, no cadastro do serviço, campo: “Código de Integração”.<br />
'''2.''' Crie cadastros de Usuários, CNs e Planos.<br />
 
Os planos cadastrados no V-DI, precisam possuir o mesmo código informado no ERP, no cadastro do serviço, campo: “Código de Integração”.<br />
 
  
'''3.''' Realize a importação de ICCIDs (Chips), utilizando um arquivo CSV. Dúvidas relacionadas a este processo, podem ser consultadas em: [[V-DI_(Voalle_Data_Integration)]].
+
'''3.''' Realize a importação de ICCIDs (Chips), com o cabeçalho abaixo. Dúvidas relacionadas a este processo, podem ser consultadas em: [[V-DI_(Voalle_Data_Integration)|V-DI]].
  
{{Icone|tipo=cliente}} '''4.''' Realize o cadastro dos planos.<br  />
+
{| class="wikitable"
 +
|+ 
 +
|-
 +
! IMSI
 +
! ICCID
 +
! PIN1
 +
! PUK1
 +
! PIN2
 +
! PUK2
 +
! MKT
 +
! ADMIN
 +
|-
 +
| Não preencher
 +
| Exemplo '89552600000008618766
 +
| Não preencher
 +
| Não preencher
 +
| Não preencher
 +
| Não preencher
 +
| Não preencher
 +
| Não preencher
 +
|}
 +
Na coluna ICCIDs, informar uma ' antes da numeração para o excel não quebrar a informação.
  
 
==Páginas relacionadas==
 
==Páginas relacionadas==
[[Cadastro_de_Webhooks]]<br />
+
[[Cadastro_de_Webhooks]]<br />
[[Integradores]]<br />
+
[[Integradores]]<br />
 
[[V-DI_(Voalle_Data_Integration)]]
 
[[V-DI_(Voalle_Data_Integration)]]

Edição atual tal como às 16h59min de 6 de março de 2023

MVNO TIP

Serviço de Telefonia Móvel - MVNO integrado ao ERPVoalle.

Objetivo da Documentação

Explicar como devem ser feitas as configurações necessárias para utilizar a Integração de MVNO Tip.

Alguns passos serão realizados internamente, pela equipe do Grupo Voalle, e outros devem ser feitos por você, usuário do ERPVoalle.

Pré-Requisitos

A empresa já deve utilizar em sua operação o CRM Voalle e a nova tela de atendimento.

Passo a passo da configuração

1. CLIENTE.png Entre em contato com a Tip e com sua equipe de TI solicitando as informações detalhadas no documento abaixo:

File:Formulario_C07 (1).pdf

Adicionalmente, informar uma pessoa para ser criado o usuário que irá responsável pelos cadastros no V-DI, informando os campos.

  • Nome
  • CPF
  • E-mail


2. CLIENTE.png Envie o documento complementação preenchido acima à equipe Comercial da Voalle.

3. VOALLE.png Equipe Comercial após receber o documento preenchido, enviadas pelo cliente, deve encaminhar a solicitação à equipe de Entregas da Voalle, que irá entrar em contato com o cliente, passando informações e prazos de homologação.

VOALLE.png Configurações - V-DI

1. Solicitar à equipe responsável a criação da base V-DI no banco de dados - PostgreSQL para o cliente.

2. Com a base V-DI criada, realize os cadastros da Empresa, Parceiro e Integradores, nessa ordem.

  • Para o cadastro do parceiro é necessária a geração de uma chave única que será informada no campo ERP KEY na aba configurações. Será usada esta mesma chave também nas configurações globais para vincular o ERP ao V-DI;

3. Realize o cadastro do Usuário responsável para o cliente, desse modo, ele terá acesso para realizar os demais cadastros e configurações necessárias.

4. Realize as configurações de parâmetros com as informações de e-mail fornecidas pelo cliente.

Dúvidas relacionadas a este processo podem ser consultadas em: V-DI

VOALLE.png Configurações - ERP

1. Solicitar a equipe Administrativo para ser habilitado o módulo V-DI no ERP da empresa.

CLIENTE.png Configurações - ERP

1. Configurar os parâmetros do ERP em: Configurações / Parâmetros, menu Voalle Data Integration | V-DI

    • ERP KEY: Informar a Chave do ERP gerada no cadastro de Parceiros do V-DI. Para ver a chave, basta clicar sobre o registro do Parceiro cadastrado.
    • API KEY: Informar a Chave da API gerada no cadastro de Parceiros do V-DI. Para ver a chave, basta clicar sobre o registro do Parceiro cadastrado.
    • URL BASE: Informar a URL do V-DI, porém alterar a porta para 45720 ao invés de 45721


2. Realize o cadastro de Integradores em: Manutenções / Integrações / Integradores. Abaixo, seguem os campos a serem preenchidos para essa integração. Dúvidas relacionadas a este processo podem ser consultadas em: Integradores - “Como cadastrar um novo Integrador”.

 
Campo Dado
Alias tip_mvno
Descrição Título livre
Tipo de integração Reativa
V-DI Sim
URL Preencher com uma barra "/"
Versão 2.0 (MVNO)
Integration Key Hash gerado ao cadastrar o integrador no V-DI, copiar a informação do campo Chave da Integração ao clicar sobre o registro.

Obs: Campos não informados não devem ser preenchidos.

3. Realize o cadastro de Webhooks em: Manutenções / Integrações / Integrações Webhooks. Abaixo, seguem os campos a serem preenchidos para essa integração. Dúvidas relacionadas a este processo, podem ser consultadas em: Cadastro_de_Webhooks - “Como cadastrar um Webhook”.

Campo Dado
Nome do webhook Título livre
Integrator Selecionar a integração cadastrada no passo anterior
Método HTTP POST
Url https://synsuite.SEUDOMINIO.com.br:45720/api/v1/receive


Limite de tentativas de Integrar 15
Lista de E-mails caso chegue ao máximo de tentativas Conforme informado pelo cliente.
Caso o cliente informe mais de 1 e-mail, separar por ponto e virgula ";"

Obs. Campos não informados não devem ser preenchidos.

4. Marcar o parâmetro “Utilizar Webhooks” nos parâmetros globais do sistema em Configurações / Parâmetros / Service Desk.

5. Realize cadastro dos Serviços de Telefonia Móvel em Faturamento / Cadastros / Produtos/Serviços;

    • Marque a opção Serviço Composto como sim.
    • No campo tipo de serviço selecione a opção telefonia móvel.
    • A seleção do tipo telefonia móvel, fará com que sejam adicionados dois novos campos de preenchimento obrigatório, sendo eles:
      • Empresa de Integração: selecione a empresa Integradora.
      • Código de Integração: preencha com o código do plano/serviço na integradora.
    • Após a criação do serviço, edite o mesmo, e realize a configuração da sua composição.
    • Caso desejado controlar o estoque de ICCIDs através da utilização de kits, deverá ser preenchido o campo “kit” no cadastro do serviço de telefonia móvel criado. Dúvidas relacionadas a este processo, podem ser consultadas em: Kits - “Como cadastrar um Kit” e “Como vincular o Kit a um Serviço”.

6. Vincular os serviços novos na rotina CRM - Voalle / Operações / Dashboard - Parâmetros do CRM, menu Lista de Preço. A lista de preço será vinculada a campanha e conforme parametrização os serviços serão listados durante a venda.

CLIENTE.png Configurações - V-DI

1. Crie cadastros de CNs, Operadora Doadora e Planos.
Os planos cadastrados no V-DI, precisam possuir o mesmo código informado no ERP, no cadastro do serviço, campo: “Código de Integração”.

3. Realize a importação de ICCIDs (Chips), com o cabeçalho abaixo. Dúvidas relacionadas a este processo, podem ser consultadas em: V-DI.

 
IMSI ICCID PIN1 PUK1 PIN2 PUK2 MKT ADMIN
Não preencher Exemplo '89552600000008618766 Não preencher Não preencher Não preencher Não preencher Não preencher Não preencher

Na coluna ICCIDs, informar uma ' antes da numeração para o excel não quebrar a informação.

Páginas relacionadas

Cadastro_de_Webhooks
Integradores
V-DI_(Voalle_Data_Integration)