Versions Compared

Key

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

...

Table of Contents
minLevel1
maxLevel7

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

Consulta de Viabilidade no OZmap

Consulta de viabilidade de atendimento para clientes no OZmap, através do chatbot Matrix.

OZmap => Matrix

Funcionalidades

Abaixo está descrita a funcionalidade de exemplo, de serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona seu fluxo e como pode ser feita sua implementação no Matrixa 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 , é feito uma chamada API utilizando o CEP que retorna 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 chamada API que retorna 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, é feito uma chamada API buscando 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 o envio da localizaçãoobter 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, podendo ser configurada 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 pelo chatbotatravé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

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

É possível realizamos uma análise da demanda, e sendo viável de implementação, podemos disponibilizar via serviço adicional. Consulte a equipe Comercial do OZmap para mais informações.

Pergunta

Resposta

É possível implementar uma funcionalidade não contemplada pela API OZmap atualmente?