Integrar leads externos no Voa Corretor

É possível receber leads de plataformas externas no Voa Corretor.

Para isso, os leads devem ser enviados via protocolo HTTP no verbo POST, passando um JSON com as informações do lead no endpoint especificado conforme ilustrado a seguir.

O processo de integração é acionado para cada lead individualmente, sempre que for recebido um POST no endpoint.


Os dados precisam ser enviados de acordo com a estrutura abaixo. Qualquer informação enviada no corpo da resposta fora desta estrutura será totalmente ignorada!

		
			{
			"leadOrigin": "Origem do lead",
			"originListingId": "849816",
			"clientListingId": "CA0787",
			"name": "Nome do lead",
			"email": "nome@email.com",
			"phoneNumber": "11999999999",
			"message": "Olá, tenho interesse neste imóvel. Aguardo o contato. Obrigado.",
			"temperature": "Alta",
			"transaction_type": "SELL"
			}
		
	

O que representa cada campo:

  • . leadOrigin: Identificador da origem do lead (nome da plataforma);
  • . originListingId: Identificador do lead na plataforma de origem;
  • . clientListingId: Identificador do anúncio/imóvel do cliente (conforme cadastrado no Voa Corretor);
  • . name: Nome do lead;
  • . email: E-mail do lead;
  • . phoneNumber: Telefone do lead;
  • . message: Mensagem enviada pelo lead;
  • . transactionType: Tipo de transação (RENT ou SELL);

Seguimos o mesmo padrão de integração utilizado pelo Canal Pró, com alguns dados a menos. A documentação do portal fornece um validador para testes, disponível neste link.

Obter o endpoint

O endpoin para recebimento destes leads pode ser obtido no painel do cliente, no menu Integrações > Outros.


Em caso de dúvidas ou problemas, envie um e-mail para suporte@voacorretor.com.br que iremos responder assim que possível.