...
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 | ||||
---|---|---|---|---|
|
Tipo de Integração
A integração OZmap-Fortics é do tipo Passiva-indireta.
Descrição
A Fortics é uma empresa 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 localização é 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.