Essa documentação trata da integração com o sistema Datacake. A integração é realizada atraves de chamadas de API partindo do Datacake e utilizando a API disponibilizada pelo OZmap.
Tipo de Integração
A integração OZmap-Datacake é do tipo Passiva-Direta.
Descrição
O Datacake é um sistema focado no desenvolvimento de soluções para o meio telecom, validando a cobertura e todos os dados necessários para concretizar uma venda.
A integração tem como objetivo a consulta de viabilidade e criação de leads no OZmap quando não ocorre viabilidade em um endereço.
Resumo de funcionalidades
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Consultar CTOs OZmap Disponíveis para Viabilidade | O Datacake realiza a busca de CTOs OZmap próximas do endereço do cliente disponíveis para conexões. Essa viabilidade pode ser realizada por raio ou por postes. | OZmap => Datacake |
Criação de LEADs OZmap | O Datacake realiza a criação de leads no OZmap quando não houver viabilidade para um endereço. | Datacake => OZmap |
Funcionalidades
Abaixo serão descritas as funcionalidades apresentadas no resumo para entender como funciona o fluxo de sincronização.
Consultar CTOs OZmap Disponíveis para Viabilidade
A consulta das CTOs OZmap disponíveis para realizar a viabilidade, é dado da seguinte forma:
A partir do endereço digitado pelo cliente, é disponibilizado um mapa onde o cliente escolhe a localização correta através de um PIN;
A partir da confirmação do endereço, é feito uma consulta no OZmap por CTOs e condomínios próximos à coordenada no OZmap.
A viabilidade no OZmap pode ser feita por raio (busca a CTO mais próxima em linha reta a partir do cliente) ou por poste (busca o poste mais próximo do cliente, e procura CTOs a partir das adjacências cadastradas no OZmap). A definição de qual tipo de viabilidade será feita no OZmap é determinada pelas configurações de viabilidade que o provedor pode escolher no Datacake.
Caso tenha viabilidade no seu endereço, é retornado sucesso na viabilidade, permitindo a ele seguir com o processo de venda no Datacake.
Criação de LEADs OZmap
A criação de LEADs no OZmap, é dada da seguinte forma:
No momento da viabilidade, caso o endereço do cliente não possuir viabilidade no OZmap, um LEAD é criado em ambos os sistemas, de modo a posteriormente realizar a viabilidade e possível venda novamente;
O lead criado no OZmap possui as informações de nome completo, endereço, observação e as coordenadas do cliente;
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo Datacake são:
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
URL | Endereço do OZmap, com a porta de serviço padrão. | |
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 Datacake 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 Datacake.
Questionário
Pergunta | Resposta |
|---|
Add Comment