[WiP]Salesforce

Tipo de Integração

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

Descrição

O Salesforce é um sistema CRM que permite que as empresas rastreiem e gerenciem interações com clientes, desde a prospecção e aquisição até o suporte pós-venda.

A integração pode ser configurada de forma personalizada nos fluxos do sistema Salesforce, utilizando a API OZmap. Esta documentação exemplifica como pode ser utilizada a funcionalidade de Consulta de Viabilidade no OZmap, porém, muitas outras funcionalidades OZmap podem ser incorporadas nos fluxos Salesforce. Consulte a documentação https://ozmap.atlassian.net/l/cp/CKJMvNge para mais informações sobre funcionalidades indicadas para implementação.

Resumo de funcionalidades

Funcionalidades

Abaixo está descrita a funcionalidade de exemplo, de forma a entender como funciona seu fluxo e como ser feita sua implementação dentro do Salesforce.

Consulta de Viabilidade

A Consulta de Viabilidade realizada pelo Salesforce no OZmap consiste em verificar a disponibilidade de atendimento para um novo cliente em determinada localidade, e ocorre da seguinte forma:

• Para realizar a consulta de viabilidade no OZmap, é necessário dispor das coordenadas do novo cliente. A consulta de viabilidade feita pela API OZmap busca por caixas que não esteja com estado de implantação “Em projeto”, e contenham algum Splitter de atendimento com portas disponíveis;

• Com as coordenadas do cliente, basta realizar configurar o fluxo Salesforce para realizar uma requisição API ao OZmap no momento de verificação de viabilidade, passando essas coordenadas como parâmetro:

  • https://cliente.ozmap.com.br:9994/api/v2/ftth-viability/radius?lat=-27.57635071150383&lng=-48.52777004241944

• O retorno esperado desta requisição é um arquivo json contendo uma lista de todas as caixas encontradas de acordo com as configurações de viabilidade definidas no OZmap, com os seguintes atributos:

  • viable: Apresenta um valor booleano, indicando se há viabilidade ou não na localização informada;

  • boxes: Lista de todas as caixas com disponibilidade que foram encontradas no raio de busca, com distância, número de portas disponíveis, nome da caixa, entre outras informações;

  • refused_boxes: Lista de caixas que forma encontradas dentro do raio de busca, mas que não possuem disponibilidade para atender clientes no momento.

• Adicionamento, podem ser passados mais parâmetros nesta requisição, como por exemplo:

  • Definir um raio em metros para a busca de caixas (radius): O raio de busca padrão utilizado na viabilidade é o que estiver definido nas configurações de viabilidade do OZmap, mas pode ser utilizado um raio diferente passando um valor em metros por parâmetro. Exemplo:

    • https://cliente.ozmap.com.br:9994/api/v2/ftth-viability/radius?lat=-27.57635071150383&lng=-48.52777004241944&return_type=boolean

  • Definir retorno booleano (return_type=boolean): Com este parâmetro, o retorno da requisição será um json contendo apenas o atributo “viable", que pode assumir o valor “true” caso haja viabilidade na localidade informada, ou “false” caso não haja viabilidade. Exemplo:

    • https://cliente.ozmap.com.br:9994/api/v2/ftth-viability/radius?lat=-27.57635071150383&lng=-48.52777004241944&radius=50

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 Salesforce.

OZmap

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