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 Portal Observaçõ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/VivaReal	Objeto do SnapProperty	Campo do SnapProperty	Observações
leadOrigin
timestamp
originLeadId
originListingId
clientListingId
name
email
ddd
phone
phoneNumber
message