...
Essa documentação trata da integração com o sistema Huggy. A integração é realizada através de chamadas de API partindo do Integrador e utilizando a API disponibilizada no serviço de integração pelo OZmap, mas também pode ser feita utilizando diretamente a api do API disponibilizada pelo OZmap.
Table of Contents | ||||
---|---|---|---|---|
|
...
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 a localização enviada pelo cliente é dada no OZmap consiste em verificar a disponibilidade de atendimento para um novo cliente em determinada localidade, e ocorre da seguinte forma:
O cliente inicia o processo de consulta de viabilidade pelo chatbot Huggy;
O Huggy envia ao cliente um link de acesso ao FindME (ferramenta OZmap para envio de localização);
Quando o cliente acessa o FindME, 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 Huggy envia realiza a consulta de viabilidade ao 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 Huggy no OZmap, é seguido o fluxo de acordo com o retorno da viabilidade, onde pode ser seguido o fluxo de contratação caso tenha viabilidade no OZmap, ou encerrado o atendimento caso não haja viabilidade.
...
O fluxo do chatbot Huggy pode ser personalizado, e também a comunicação para busca de outros dados ou ações no OZmap pode ser configurada. É possível realizar várias outras ações no OZmap, apontando a comunicação do Huggy diretamente para a api do OZmap.
Para este fluxo apresentado, há um serviço OZmap padronizando o retorno do OZmap para ser aceito pelo Huggy, sendo importante ressaltar que o Huggy não captura informações que não estão no primeiro nível de retorno, então para utilizar a API do OZmap em chamadas onde a informação que está sendo buscada não está no primeiro nível, é necessário trabalhar com um intermediário, por exemplo Google Scripts, que pega a informação e passa para um só nível. Aqui um exemplo do Huggy de como pode ser padronizado esse retorno.
...
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:15000/integrations/huggy |
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 |
...