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.
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.
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.
Add Comment