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 OZmap.
| Table of Contents | ||||
|---|---|---|---|---|
|
Tipo de Integração
A integração OZmap-Huggy é do tipo Passiva-indireta.
Descrição
A Huggy é uma plataforma de atendimento digital omnichannel para empresas capturarem leads, e venderem por meio principalmente de respostas automatizadas (chatbots).
A integração Huggy com o OZmap se baseia na consulta automatizada de viabilidade no OZmap para clientes, feita através de chatbots Huggy.
Resumo de funcionalidades
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Consulta de viabilidade no OZmap | Consulta de viabilidade de atendimento para clientes no OZmap, através do chatbot Huggy. | OZmap => Huggy |
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 de viabilidade 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 realiza a consulta de 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 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.
Outras funcionalidades possíveis de implementação
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.
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo integrador são:
Saiba mais como configurar esses dados consultando a documentação Huggy.
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
URL | Endereço do serviço de integração no OZmap | https://<cliente>.ozmap.com.br/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 |
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 Huggy para acessar as portas 80 e 15000 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 Huggy realiza reserva de portas no OZmap? | Neste fluxo de exemplo que apresentamos não, mas é possível implementar configurando o Huggy para acionar diretamente a api do OZmap e realizar esse processo. |
//Anotar as perguntas e possíveis respostas e quais as funcionalidades relacionadas às respostas.