...
Essa documentação trata da integração com o sistema Conecte.ai. A integração é realizada através 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-Conecte.ai é do tipo Passiva-direta.
Descrição
O Conecte.ai é um sistema de Vendas Onlinevenda consultiva, convertendo acessos do seu site em adesões e pré-cadastros, validando a coberturae todos os dados necessários para concretizar uma venda.
A integração tem como objetivo a consulta de viabilidade no OZmap para o endereço de clientes interessados em contratação via Conect.ai.
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 sistema de vendas do Conecte.ai. | OZmap => Conecte.ai |
Funcionalidades
Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
Consulta de Viabilidade
A Consulta de Viabilidade realizada pelo Conect.ai no OZmap consiste em verificar a disponibilidade de atendimento para um novo cliente em determinada localidade, e ocorre da seguinte forma:
Através da interface de contratação da Conecte.ai, o cliente seleciona o plano que tem interesse em contratar, e informa o endereço, nome completo, telefone e e-mail;
Após preencher e enviar os dados, o sistema da Conecte.ai irá consultar a 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 raio, e a distância máxima para este raio de busca será a que estiver definida nas configurações do OZmap (Configurações > Sistema > API > Raio de busca padrão).
É possível restringir a busca para regiões específicas no OZmap dependendo do plano selecionado inicialmente pelo cliente:
Para isso, basta cadastrar tags de regiões OZmap nas configurações dos planos no Conect.ai.
Caso haja alguma tag de região OZmap cadastrada para o plano escolhido, a viabilidade será feita somente considerando caixas que estiverem nas regiões que possuem essa tag de plano no OZmap.
Se houver disponibilidade para o endereço informado, a interface de contratação do Conect.ai seguirá com o processo de contratação.
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo integrador são:
Saiba mais como configurar esses dados utilizando a documentação acionando o suporte do Conecte.ai. (Não encontrei doc ainda)
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
URL | Endereço do OZmap, com a porta de serviço padrão. | https://cliente.ozmap.com.br:9994/api/v2 |
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 Hubsoft Conect.ai 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 |
|---|
Descrição
Direção da integração
Criação de Reservas
Criação de reservas no OZmap, com base nas solicitações realizadas na hora da viabilidade da Conecte.ai
Conecte.ai => OZmap
Funcionalidades
Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
Para informações mais detalhadas, consulte a documentação do Conecte.ai.
Criação de Reservas
Criação de reservas no OZmap, com base nas solicitações realizadas na hora da viabilidade da Conecte.ai;
...
Para realizar uma nova reserva, é necessário, via interface de contratação da Conecte.ai, informar o endereço, nome completo, telefone e email;
...
Após preencher os dados, o sistema da Conecte.ai irá buscar no OZmap uma CTO Implantada com Splitter de Conexão disponível para criar a reserva do cliente;
Caso não seja encontrado uma CTO disponível, a reserva não é criada no OZmap;
...
Se houver disponibilidade no local informado, é habilitado os campos para preenchimento dos dados do cliente para realizar a contratação do serviço;
Após preencher todos os dados necessários, é criado uma reserva próximo a CTO do endereço no OZmap;
...