Versions Compared

Version Old Version 4 New Version 5
Changes made by

Estevão Fernandes (Deactivated)

Estevão Fernandes (Deactivated)

Saved on

Key

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

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

Table of Contents

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 ZapImoveis/Vivareal 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.