Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Table of Contents
minLevel1
maxLevel7

Tipo de Integração

A integração OZmap-Fortics é do tipo Passiva-indireta.

Descrição

A Fortics é uma empresa referência focada em plataformas de atendimento, vendas e comunicação omnichannel através de chatbots.

A integração Fortics com o OZmap se baseia na consulta automatizada de viabilidade no OZmap para clientes, feita através do chatbot Fortics.

Resumo de funcionalidades

Funcionalidade

Descrição

Direção da integração

Consulta de viabilidade de acordo com coordenada enviadaO Fortics envia as coordenadas do cliente para o OZmap o qual faz a consulta de viabilidade no local enviadono OZmap

Consulta de viabilidade de atendimento para clientes no OZmap, através do chatbot Fortics.

OZmap => Fortics

Funcionalidades

Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona a integração.

Consulta de viabilidade

...

no OZmap

A consulta Consulta de viabilidade de acordo com coordenadas enviadas é dada no OZmap consiste em verificar a disponibilidade de atendimento para um novo cliente em determinada localidade, e ocorre da seguinte forma:

  • O cliente começa inicia o processo de consulta de viabilidade em um chat com um dos chatbots disponibilizados e envia pelo chatbot Fortics;

  • É solicitado ao cliente que envie a sua localização por um dos meios configurados: através da posição atual do usuário, utilizando o FindME, através do endereço ou coordenadas

    • A localização é enviada para a integração que então decide como processar a informação de acordo com o que foi disponibilizado

      • Se escolher enviar pelo posição atual, a localização é enviada automaticamente de acordo com o que é disponibilizado.

      • Se escolher selecionar pelo FindME, o cliente poderá enviar seu número de celular qual receberá um SMS com um link que utilizará para escolher a sua localização.

      • Se escolher endereço, o endereço do cliente é utilizado para encontrar a localização exata do cliente

      • Se escolher enviar as coordenadas, as coordenadas são enviadas diretamente ao OZmap

    As coordenadas são enviadas ao OZmap para encontrar um poste válido que então é enviado ao OZmap novamente para checar a viabilidade

    • Através do endereço ou coordenadas, informando via chatbot.

    • Utilizando o FindME: o Fortics envia o contato do cliente ao FindME (ferramenta OZmap para envio de localização), e o FindME envia ao cliente um link de acesso via SMS, onde a localização do cliente será captada pelo GPS do dispositivo que o cliente está usando 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 pelo cliente, o sistema da Fortics 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 poste, sendo assim, será buscado o poste mais próximo da localização passada pelo cliente, e a partir deste poste, será buscada alguma caixa nas condições acima, seguindo pelas adjacências cadastradas no OZmap.

  • Quando concluída a verificação de viabilidade pelo Fortics no OZmap, é retornado pelo Fortics um dos resultados:

    • Encontrado - Quando houver resultado para a consulta e a área possui viabilidade;

    • Não encontrado - Quando não há resultado para a busca;

    • Área sem viabilidade - Quando há resultado para a busca, porém não existe viabilidade na área determinada.

  • Caso a consulta retorne “Encontrado”, segue o fluxo de atendimento pelo chatbot, e caso retorne “Área sem viabilidade”, é informado ao cliente e encerrado o fluxo.

Dados Acesso

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

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

OZmap

Parâmetro

Descrição

Exemplo

URL

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

https://cliente.ozmap.com.br:9994/apiintegrations/v2fortics

Token

Token associado a conta do usuário de integração cadastrado no ozmap. Usuário

Usuário criado no OZmap para acesso API pelo Fortics (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

integracao_fortics

Senha

Senha do usuário criado no OZmap para acesso API pelo Fortics.

-

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 Fortics para acessar as portas 80 e 9994 16000 no ambiente do OZmap.

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

Questionário

Pergunta

Resposta

O Fortics realiza reserva de portas no OZmap?

Não, atualmente o Fortics realiza apenas a consulta de viabilidade para um endereço no OZmap.

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