← Central de Ajuda

Webhooks e leads dos portais

Como receber leads de portais e de sistemas externos pelo webhook do Nuclevo e pela URL do Canal Pro, com o que cada lead traz.

Atualizado em

Além de publicar imóveis, o Nuclevo recebe leads de fora. Quando um interessado clica num anúncio do ZAP, do VivaReal ou da OLX, o lead pode cair direto no funil, com o imóvel certo associado. Sistemas externos também podem enviar leads por um endereço próprio, chamado webhook.

As configurações ficam em Configurações > Integrações, nos cartões Webhook de leads e na URL de leads do Canal Pro.

Leads dos portais pelo Canal Pro

Se a sua imobiliária tem o plano do Canal Pro com ZAP, VivaReal e OLX:

  1. Em Configurações > Integrações, copie a URL de leads do Canal Pro.
  2. No Canal Pro, vá em Integrações e cole a URL em Receber leads no CRM.
  3. Pronto. Os leads de ZAP, VivaReal e OLX chegam com a mensagem do interessado e o imóvel do anúncio.

Um mesmo lead enviado de novo pelo portal não é duplicado.

Webhook de leads para outros sistemas

O webhook serve para integrar um site, um formulário ou outro sistema da imobiliária.

  1. Em Configurações > Integrações, copie a URL do webhook de leads.
  2. Configure o sistema de origem para enviar um POST com os dados do lead em JSON.
  3. Envie o cabeçalho X-Webhook-Secret com o valor mostrado no cartão.

Cada envio precisa informar:

  • nome do interessado, com pelo menos dois caracteres;
  • telefone, com DDD;
  • código do imóvel cadastrado no Nuclevo;
  • origem: ZAP, VivaReal, OLX ou outra origem aceita pelo sistema;
  • e-mail, quando o formulário tiver esse campo. É opcional.

Se faltar nome, telefone ou código do imóvel, o Nuclevo recusa o envio e informa o erro.

Quando trocar a chave

Administradores podem gerar um novo segredo do webhook no mesmo cartão. Depois disso, atualize o cabeçalho no sistema de origem. Os envios com a chave antiga deixam de ser aceitos.

Onde os leads aparecem

Cada lead recebido entra em Novo no Leads Kanban, já ligado ao imóvel. Se a roleta estiver ligada, ele é atribuído ao corretor que está há mais tempo sem receber. Veja o artigo sobre o funil de leads.

Dicas

  • Use um teste com um lead fictício antes de ligar o envio real.
  • Confira a origem: ela define como o lead aparece no funil.
  • Um reenvio do mesmo lead pelo portal não cria outro cartão no funil.