ImobTotalCentral de Ajuda

Webhook: receber leads de um portal ou enviar leads para outro sistema

"Webhook" é um endereço que um sistema usa para mandar informação para outro, automaticamente. No CRM ele aparece em dois sentidos opostos, e confundir os dois é o motivo mais comum de "configurei o webhook e não entra lead": um recebe leads de fora (portal, automação) e o outro envia cada lead novo do CRM para outro sistema.

Onde fica

  • Receber leads do SUB100: Marketing › Divulgação de imóveis › Minhas integrações, cartão SUB100 (Recebe leads do portal).
  • Receber leads de outros portais e automações: Gestão › Operacional › Webhooks de leads.
  • Enviar os leads do CRM para outro sistema: Marketing › Divulgação de imóveis › Minhas integrações, cartão Webhook de leads (no fim da tela).

Receber leads (entrada)

Aqui o CRM te dá um endereço, e você cola esse endereço no painel do portal. A partir daí, o portal manda cada lead para o CRM, que entra pela roleta e avisa o corretor.

SUB100:

  1. Abra Marketing › Divulgação de imóveis › Minhas integrações.
  2. No cartão SUB100, clique em Copiar endereço (campo Endereço para receber os leads).
  3. Cole esse endereço no painel do SUB100, no lugar de webhook de leads.
  4. Aguarde o próximo lead. O cartão muda de Aguardando 1º lead para Recebendo. O SUB100 manda os leads em lotes, a cada poucos minutos.

Outros portais e automações:

  1. Abra Gestão › Operacional › Webhooks de leads e clique em Novo webhook.
  2. Escolha De onde vêm os leads, dê um Nome (para você identificar) e clique em Criar e configurar.
  3. Copie o endereço da coluna Endereço para o portal e cole no painel do portal.
  4. Mande um lead de teste pelo portal, confira o que chegou e escolha, para cada campo, para onde ele vai no CRM.
  5. Clique em Ativar webhook.

O passo a passo completo do mapeamento está em Webhooks, importações, log de acesso e respostas prontas.

Enviar leads (saída)

Aqui é o contrário: você informa a URL do outro sistema (Make, Zapier, outro CRM, BotConversa), e o CRM manda para lá cada lead novo. Isso não faz lead entrar no CRM.

  1. Abra Marketing › Divulgação de imóveis › Minhas integrações e desça até Webhook de leads.
  2. Clique em Adicionar webhook.
  3. Preencha a URL do webhook (o endereço que o outro sistema te deu).
  4. Escolha o Formato do envio: Padrão (JSON estruturado), Com dados do atendimento (inclui descrição do atendimento, corretor e transação), Reinjeção (Lastro/Órulo) ou BotConversa / campos simples.
  5. Se o outro sistema exigir, preencha Token de autenticação (opcional).
  6. Clique em Salvar.

Importante: se o seu objetivo é trazer leads de um portal para o CRM, o Webhook de leads de Minhas integrações não serve: ele só envia. Use o cartão do portal ou Gestão › Operacional › Webhooks de leads.

Dica: para o seu próprio site ou sistema mandar leads chamando o CRM, use a API de leads, com token.

Problemas comuns

  • Aparecem webhooks em Minhas integrações, mas não entra lead — esses são de saída. Para receber, copie o endereço de entrada (cartão do portal ou Webhooks de leads) e cadastre no painel do portal.
  • Colei o endereço no portal e nada chegou — no SUB100, espere alguns minutos (envio em lotes). Em Webhooks de leads, o webhook precisa estar ativado; enquanto ele só captura, nenhum lead é criado.
  • O lead chegou, mas a observação foi para o lugar errado — em Webhooks de leads, abra o webhook e ajuste o destino do campo em Vai para. Pela API, mande o texto no campo message.
  • O portal parou de mandar leads — veja O webhook do portal parou.

Perguntas frequentes

Aparecem dois webhooks para mim, com URL do webhook, Formato do envio e Token de autenticação. Eles trazem os leads do portal? Não. Esses são webhooks de saída: mandam os leads do CRM para outro sistema. Para receber leads do portal, use o endereço de entrada do cartão do portal ou de Gestão › Operacional › Webhooks de leads.

Onde pego o endereço para colocar no painel do SUB100? Em Marketing › Divulgação de imóveis › Minhas integrações, cartão SUB100, botão Copiar endereço.

Quem pode configurar? Minhas integrações abre para o administrador e para quem tem a permissão de configurar portais. Webhooks de leads fica no menu Gestão, para quem tem acesso a ele.