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:
- Abra Marketing › Divulgação de imóveis › Minhas integrações.
- No cartão SUB100, clique em Copiar endereço (campo Endereço para receber os leads).
- Cole esse endereço no painel do SUB100, no lugar de webhook de leads.
- 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:
- Abra Gestão › Operacional › Webhooks de leads e clique em Novo webhook.
- Escolha De onde vêm os leads, dê um Nome (para você identificar) e clique em Criar e configurar.
- Copie o endereço da coluna Endereço para o portal e cole no painel do portal.
- Mande um lead de teste pelo portal, confira o que chegou e escolha, para cada campo, para onde ele vai no CRM.
- 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.
- Abra Marketing › Divulgação de imóveis › Minhas integrações e desça até Webhook de leads.
- Clique em Adicionar webhook.
- Preencha a URL do webhook (o endereço que o outro sistema te deu).
- 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.
- Se o outro sistema exigir, preencha Token de autenticação (opcional).
- 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.
