...
Essa documentação trata da integração com o sistema Matrix. A integração é realizada através de chamadas de API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.
...
A Consulta de Viabilidade realizada pelo Matrix no OZmap consiste em verificar a disponibilidade de atendimento para um novo cliente em determinada localidade, e ocorre da seguinte forma:
O cliente começa o processo de contratação pelo chatbot Matrix, onde é requerido inicialmente que seja enviado seu CEP para processamento de localização.
A partir do CEP enviado, é feito uma chamada API utilizando o CEP que retorna o endereço completo ou parcial do cliente:
Caso seja completo, este endereço é utilizado para uma nova chamada API que retorna a localização do cliente em coordenadas
Caso o endereço esteja parcial, é solicitado o nome da rua, bairro e número de endereço diretamente ao cliente
Usando as novas informações de endereço, é feito uma chamada API buscando a localização do cliente em coordenadas
Após o envio da localização, o Matrix 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 em metros, podendo ser configurada diretamente na URL do fluxo.
O cliente então é informado da viabilidade ou não pelo chatbot
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo integrador são:
...