Integração de leads com Zap + VivaReal

Owned by Estevão Fernandes (Deactivated)
Last updated: 10 July 2019 by Fabio Zarvos
2 min read

A integração basicamente precisa de uma URL (Endpoint) disponibilizada pelo SnapProperty para que o ZapImoveis/Vivareal envie as informações do lead, esta requisição será realizada via protocolo HTTP no verbo POST no Endpoint especificado passando um JSON como corpo do request.


A documentação da integração disponibilizada pela  ZapImoveis/Vivareal:  https://github.com/grupozap/crm-lead-integration


Métodos de negócio


CriarAtendimento()

Descrição: O SnapProperty é parte passiva da integração, que recebe a requisição na integração.

Método responsável por receber um Lead do serviço de integração do Portal e criar registro de Atendimento e locação.

No body da requisição todos os campos obrigatórios, e todos aqueles que se deseja popular na criação do registro.

Tipo de parâmetro: Dados de Conta e Imóvel 

Tipo: Síncrono

Registros por requisição: 1

Assinatura

URL

Descrição

Padrão

https://<instância do cliente>/services/apexrest/snap_brk/atendimento/v1



<instância do cliente> : nome de instância da org salesforce que o cliente utiliza.

Exemplo: Requisição body JSON - Enviado pelo PortalObservações

{

"leadOrigin": "VivaReal",

"timestamp": "2017-10-23T15:50:30.619Z",

"originLeadId": "59ee0fc6e4b043e1b2a6d863",

"originListingId": "87027856",

"clientListingId": "a40171",

"name": "Nome Consumidor",

"email": "nome.consumidor@email.com",

"ddd": "11",

"phone": "999999999",

"phoneNumber": "11999999999",

"message": Olá, tenho interesse neste imóvel. Aguardo o contato. Obrigado.",

}


Exemplo: Resposta - Sucesso

Observações


  • Não haverá campos ou informações no retorno, pois o portal não tratará isso de nenhuma forma 
  • O controle do status de recebimento dos leads será feito exclusivamente através dos códigos de status do protocolo HTTP, qualquer informação enviada no corpo da resposta será totalmente ignorada.

Retentivas:

Caso o SnapProperty retorne qualquer código de status que não os da família 200,

haverá retentativa automática no envio do lead.

O reenvio será tentado por 5 vezes em intervalos de 10 minutos e após isso ele será armazenado

temporariamente por até 14 dias, podendo ser reenviado a pedido do cliente.

Mapeamento de campos: 

               

Campo no ZapImoveis/VivaRealObjeto do SnapProperty Campo do SnapPropertyObservações
leadOrigin


timestamp


originLeadId


originListingId


clientListingId


name


email


ddd


phone


phoneNumber


message