Essa documentação trata da integração com o sistema 5Hub. A integração é realizada atraves de chamadas de API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.
| Table of Contents | ||||
|---|---|---|---|---|
|
Tipo de Integração
A integração OZmap-5hub é do tipo Passiva-direta.
Descrição
A 5Hub é uma plataforma de gestão de atendimentos, que identifica o cliente e disponiliza o histórico de outros atendimentos por meio de um bot customizável.
Resumo de funcionalidades
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Consulta de viabilidade de acordo com região enviada pelo cliente | O 5hub envia a localização do cliente por meio do FindME para o OZmap o qual faz a consulta de viabilidade por raio no local enviado. | OZmap => IClass |
Funcionalidades
Abaixo serão descritos alguns exemplos das funcionalidades no resumo de forma a entender como funciona a integração, mas é bom ressaltar que são só exemplos, pois esses fluxos de atendimentos realizados por bots são customizáveis.
Consulta de viabilidade de acordo com localização de cliente
A consulta de viabilidade de acordo com a localização enviada pelo cliente é dada da seguinte forma:
O cliente começa o processo de consulta de viabilidade em um chat com um dos chatbots disponibilizados e escolhe entre enviar a sua localização pelo aplicativo ou selecionar a localização pelo mapa
Se escolher enviar pelo aplicativo, a localização é enviada automaticamente de acordo com o que é disponibilizado.
Se escolher selecionar pelo mapa, uma visão do FindME é disponibilizada qual o cliente pode selecionar sua localização exatamente.
As coordenadas são enviadas ao OZmap, que faz uma busca de viabilidade por raio que retorna o resultado para o cliente, que pode então seguir com o processo caso haja viabilidade.
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo integrador são:
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
URL | Endereço do OZmap, com a porta de serviço padrão. | |
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 5Hub para acessar as portas 80 e 9994 no ambiente do OZmap.
Caso seu servidor seja hospedado pelo OZmap, essas portas já estarão liberadas para o integrador.
Questionário
Pergunta | Resposta |
|---|---|
//Anotar as perguntas e possíveis respostas e quais as funcionalidades relacionadas às respostas.