Huggy

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 disponibilizada pelo OZmap.

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

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

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

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.