Makesystem
- Leonardo Rosa Bittencourt
Essa documentação trata da integração com o sistema Makesystem. 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-Makesystem é do tipo Passiva-direta.
Descrição
O Makesystem é um sistema focado na gestão de vendas e equipes, voltado para provedores de internet.
A integração tem como objetivo a consulta de viabilidade no OZmap para o endereço de clientes interessados em contratação via plataforma de vendas do Makesystem.
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 da plataforma de vendas Makesystem. | OZmap => Makesystem |
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 Makesystem 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 da plataforma de vendas Makesystem, é preenchido o endereço do cliente para a consulta de viabilidade;
A partir do endereço informado, o Makesystem realiza a consulta de viabilidade no OZmap, enviando as coordenadas correspondentes ao endereço do cliente para buscar 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 Makesystem (Parâmetro “OzMap Raio”).
Após a busca de viabilidade no OZmap, são carregados na tela do Makesystem todos os dados de cobertura para o usuário gerar a venda;
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 Makesystem.
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
OzMap Host | Endereço do OZmap, com a porta de serviço padrão. | https://cliente.ozmap.com.br:9994/api/v2 |
OzMap Key | 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 Makesystem 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 Makesystem realiza reserva de portas ou criação de Leads no OZmap? | Não, atualmente o Makesystem realiza apenas a consulta de viabilidade para um endereço no OZmap. |