Versions Compared

Key

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

...

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
minLevel1
maxLevel7

...

  • 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

...