Matrix

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.

Tipo de Integração

A integração OZmap-Matrix é do tipo Passiva-direta.

Descrição

A Matrix é uma empresa especializada no desenvolvimento de plataformas de tecnologia de ponta com foco no engajamento e relacionamento entre empresas e clientes através, principalmente, de chatbots, integrando diversas plataformas de mensagem como WhatsApp Business.

A integração Matrix com OZmap se baseia em consultas automáticas de viabilidade no OZmap para clientes, feita através de chatbots Matrix.

Resumo de funcionalidades

Funcionalidade

Descrição

Direção da integração

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 chatbot Matrix.

OZmap => Matrix

Funcionalidades

Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona a integração.

Consulta de Viabilidade

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 pelo cliente, o Matrix faz uma consulta em um serviço externo utilizando esse CEP, para obter o endereço completo ou parcial do cliente:

    • Caso seja completo, este endereço é utilizado para uma nova consulta em um serviço externo pelo Matrix, para obter 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 através do chatbot;

      • Usando as novas informações de endereço, o Matrix faz uma nova consulta em um serviço externo como esses dados, para obter a localização do cliente em coordenadas;

  • Após obter a localização do cliente em coordenadas, 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, onde a metragem padrão é determinada diretamente na URL de viabilidade do fluxo Matrix, através do atributo “radius”.

  • O cliente então é informado da viabilidade ou não através chatbot, e dado sequência do fluxo Matrix de acordo com essa resposta de viabilidade.

Dados Acesso

Dados de acesso necessários para as operações realizadas pelo integrador são:

Saiba mais como configurar esses dados acionando o suporte do Matrix.

OZmap

Parâmetro

Descrição

Exemplo

Parâmetro

Descrição

Exemplo

URL API

Endereço do OZmap, com a porta de serviço padrão.

https://cliente.ozmap.com.br:9994/api/v2

Chave API

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

Pergunta

Resposta