Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 20 Current »

Essa documentação trata da integração com o sistema Piperun. A integração é realizada através de chamadas de API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.

Tipo de Integração

A integração OZmap-Piperun é do tipo Passiva-direta.

Descrição

O Piperun é uma plataforma de gestão de atendimento focada em estratégias de CS (Customer Success), adequada a qualquer modelo de negócio.

A integração tem como objetivo a consulta de viabilidade com reserva de porta ou criação de prospects no OZmap para o endereço de clientes interessados em contratação via chatbot Piperun.

Resumo de funcionalidades

Funcionalidade

Descrição

Direção da integração

Consulta de viabilidade com Reserva de Porta ou criação de Prospect no OZmap

A partir da localização informada pelo cliente no chatbot, o Piperun busca viabilidade no OZmap, podendo realizar a reserva de porta se houver viabilidade ou a criação de um prospect caso não haja viabilidade.

OZmap => Piperun

Funcionalidades

Abaixo serão descritos alguns exemplos das funcionalidades no resumo de forma a entender como funciona a integração, mas esse processo pode ser customizado pelas configurações do chatbot Piperun.

Consulta de viabilidade com Reserva de Porta ou criação de Prospect no OZmap

A Consulta de viabilidade com Reserva de Porta ou criação de Prospect no OZmap se baseia na busca de viabilidade de atendimento para a localização de um cliente interessado em contratação via chatbot Piperun, e ocorre da seguinte forma:

  • O cliente começa o processo de contratação pelo chatbot Piperun, onde são dadas duas opções para o cliente enviar a localização onde deseja a instalação para ser verificada viabilidade:

    • Enviar localização pelo aplicativo: nesta opção, será enviada a localização captada pelo aplicativo que o cliente está usando para interagir com o chatbot (Whatsapp, Telegram, etc);

    • Procurar minha localização no mapa: o cliente é redirecionado para o FindME (ferramenta OZmap para envio de localização), onde a localização do cliente será captada pelo GPS do dispositivo que o cliente está usando para interagir com o chatbot ou pode ser digitado manualmente o endereço, em ambos os casos é mostrada a localização em imagem de satélite, que pode ser refinada ao arrastar o ícone de local na tela;

  • Após o envio da localização e confirmação da mesma pelo cliente, o Piperun irá consultar a viabilidade no OZmap, buscando caixas que não estejam “Em projeto”, e possuam splitter de atendimento com portas disponíveis no OZmap;

    • A busca de viabilidade realizada no OZmap é feita por raio, e a distância máxima para este raio de busca será a que estiver definida nas configurações do OZmap (Configurações > Sistema > API > Raio de busca padrão).

  • Caso haja viabilidade para a localização informada, o cliente pode optar por realizar a reserva ou não.

    • Quando for realizada a reserva de porta, será criado um cliente não implantado no OZmap com os dados enviados pelo Piperun, e com drop conectado à caixa mais próxima que tenha dado viabilidade.

  • Caso não haja viabilidade para a localização, é possível criar um prospect no OZmap, adicionando tags OZmap previamente configuradas no chatbot Piperun.

OBS.: Este fluxo pode ser customizado pelo cliente nas configurações do chatbot Piperun, sendo este um exemplo de fluxo que é possível ser feito.

Dados Acesso

Dados de acesso necessários para as operações realizadas pelo integrador são:

OZmap

Parâmetro

Descrição

Exemplo

URL

Endereço do OZmap, com a porta de serviço padrão.

https://cliente.ozmap.com.br:9994/api/v2

Token

Token associado a conta do usuário de integração cadastrado no ozmap. (O usuário deve ter acesso aos projetos que a integração irá trabalhar (Escolha do usuário). Tutorial de como gerar usuário/chave.)

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE

Saiba mais como configurar esses dados acionando o suporte do Piperun.

Liberação de IPs

Caso o servidor OZmap esteja em ambiente ON-Premisses, é necessário liberar nos firewalls o IP do servidor onde está o Piperun para acessar as portas 80 e 9994 no ambiente do OZmap.

Caso seu servidor seja hospedado pelo OZmap, essas portas já estarão liberadas para o integrador.

Questionário

Pergunta

Resposta

//Anotar as perguntas e possíveis respostas e quais as funcionalidades relacionadas às respostas.

  • No labels