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

De Grupo Voalle
 
(14 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 21: 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 />
  
'''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  />
+
==={{Icone|tipo=voalle}} Configurações - V-DI===
 +
'''1.''' Solicitar à equipe responsável a criação da base V-DI no banco de dados - PostgreSQL para o cliente.<br />
  
==={{Icone|tipo=voalle}} Configurações - V-DI===
+
'''2.''' Com a base V-DI criada, realize os cadastros da Empresa, Parceiro e Integradores, nessa ordem.<br />
'''1.''' Solicitar a equipe responsável a criação da base V-DI no banco de dados - PostgreSQL para o cliente.<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 />
  
'''2.''' Com a base V-DI criada, realize os cadastros da Empresa, Integradores e Parceiros.<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 />
  
'''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 />
+
'''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===
 +
'''1.''' Solicitar a equipe Administrativo para ser habilitado o módulo V-DI no ERP da empresa.
  
 
==={{Icone|tipo=cliente}} Configurações - ERP===
 
==={{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 />
  
'''1.''' Realize o cadastro de Integradores em: Manutenções / Integrações / Integradores.
+
<br />
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.
+
'''2.''' Realize o cadastro de Integradores em: Manutenções / Integrações / Integradores.
Dúvidas relacionadas a este processo, podem ser consultadas em: [[Cadastro_de_Webhooks]] - “Como cadastrar um Webhook”.<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 />
  
'''3.''' Marcar o parâmetro “Utilizar Webhooks” nos parâmetros globais do sistema em: Configurações / Parâmetros / Service Desk.<br  />
+
{| class="wikitable"
 +
|+ 
 +
|-
 +
!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. '''
  
'''4.''' Realize cadastro dos Serviços de Telefonia Móvel em: Faturamento / Cadastros / [[ Produtos/Serviços - Cadastro Serviços | Produtos/Serviços]];<br />  
+
'''3.''' Realize o cadastro de Webhooks em: Manutenções / Integrações / Integrações Webhooks.
*Marque a opção '''Serviço Composto''' como '''sim'''.<br />
+
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 />
*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 />
+
{| class="wikitable"
**'''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/>
+
!Campo
*Após a criação do serviço, edite o mesmo, e realize a configuração da sua composição.<br />
+
!Dado
*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>
+
|-
 +
|Nome do webhook
 +
|Título livre
 +
|-
 +
|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. A lista de preço será vinculada a campanha e conforme parametrização os serviços serão listados durante a venda.
+
'''5.''' Realize cadastro dos Serviços de Telefonia Móvel em Faturamento / Cadastros / [[ Produtos/Serviços - Cadastro Serviços | Produtos/Serviços]];<br />
 +
** 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.''' Crie cadastros de CNs, Operadora Doadora e Planos.<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 />
+
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), com o cabeçalho abaixo. Dúvidas relacionadas a este processo, podem ser consultadas em: [[V-DI_(Voalle_Data_Integration)|V-DI]].
 
'''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]].
  
 
{| class="wikitable"
 
{| class="wikitable"
|+ Texto da legenda
+
|+ 
 
|-
 
|-
! Texto do cabeçalho !! Texto do cabeçalho !! Texto do cabeçalho !! Texto do cabeçalho !! Texto do cabeçalho !! Texto do cabeçalho !! Texto do cabeçalho !! Texto do cabeçalho
+
! IMSI
 +
! ICCID
 +
! PIN1
 +
! PUK1
 +
! PIN2
 +
! PUK2
 +
! MKT
 +
! ADMIN
 
|-
 
|-
| Exemplo || Exemplo || Exemplo || Exemplo || Exemplo || Exemplo || Exemplo || Exemplo
+
| 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)