Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

...

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

Criação Consulta de ReservasCriação de reservas no OZmap, com base nas solicitações realizadas na hora da viabilidade da Viabilidade no OZmap

Consulta de viabilidade de atendimento para clientes no OZmap, através do sistema de vendas do Conecte.ai.

OZmap => 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;

...

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, informar o cliente seleciona o plano que tem interesse em contratar, e informa o endereço, nome completo, telefone e e email-mail;

  • Após preencher e enviar 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;

    Se em 7 dias a reserva não for confirmada, a porta da CTO no OZmap é liberada para permitir novas conexões e a reserva do cliente é excluida

    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 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

Resposta

O Conect.ai realiza reserva de portas no OZmap?

Não, atualmente o Conect.ai realiza apenas a consulta de viabilidade para um endereço no OZmap.