O webhook do portal parou — como religar o recebimento de leads

Quando um portal para de mandar os contatos interessados para o CRM, os leads somem sem nenhum aviso na tela — e é fácil demorar dias para perceber. Este guia explica como identificar que o webhook de um portal parou e como religá-lo você mesmo, sem esperar chamado. Vale para OLX, ZAP Imóveis, VivaReal, Canal Pro (Grupo OLX), Chaves na Mão, ImovelWeb, SP Imóveis, Órulo e Mercado Livre.

Onde fica

Menu Marketing › Portais imobiliários. Cada portal aparece num card, com os horários e o status da integração.

Duas pontas: webhook de leads (entrada) x XML (saída)

Toda integração de portal tem duas pontas, e elas falham de formas diferentes — não confunda:

• XML de imóveis (saída) — é o arquivo com o seu estoque que o portal lê para montar os anúncios. Se essa ponta falha, o problema é nos anúncios (some imóvel, foto não aparece).
• Webhook de leads (entrada) — é o endereço para onde o portal envia os contatos de quem se interessou pelo anúncio. Se essa ponta falha, os anúncios continuam no ar, mas os leads param de chegar no CRM.

Este guia é sobre a segunda ponta: o webhook de leads.

Como saber que o webhook parou

No card de cada portal, olhe o status da integração de leads e a data do último lead recebido por aquele portal:

• Status parado ou data do último lead muito antiga (dias ou semanas) = aquele portal deixou de entregar contatos.
• Se você ainda recebe leads de outros portais, mas de um deles a data travou, o problema é só naquele portal — quase sempre a URL do webhook está desatualizada no painel dele.

Importante: a URL do webhook pode parar de funcionar sem ninguém mexer no CRM. Basta o portal ter guardado um endereço antigo (de uma migração, de outro sistema, de um cadastro feito há muito tempo). Quando o endereço não bate mais, o portal envia o lead "para o vazio" e ele nunca chega — sem erro na sua tela. Por isso a data do último lead por portal é o alarme mais confiável.

Passo a passo para religar

1. Abra Marketing › Portais imobiliários e clique no card do portal parado (ou em Configurações e URLs).
2. Localize o Caminho de integração de leads (a URL do webhook) e clique em Copiar para pegar o endereço atual.
3. Entre no painel do próprio portal (a área de administração da sua conta lá) e recadastre essa URL no campo de integração/webhook de leads, substituindo qualquer endereço antigo.
4. Se o portal tem e-mail de integração, use o botão Enviar e-mail de integração na tela de Portais: ele monta uma mensagem pronta, com o endereço correto, para o suporte do portal cadastrar por você. Revise e envie.
5. Faça um lead de teste pelo anúncio (ou peça ao portal) e confira, alguns minutos depois, se a data do último lead daquele portal se atualizou na tela de Portais.

Dica: se o portal te deu um código de cliente (o número da sua conta lá), cite-o no e-mail de integração — ajuda o suporte do portal a localizar seu cadastro. Alguns portais (como o ImovelWeb) também exigem informar esse N. Cliente aqui na configuração do card.

Atenção: o XML de imóveis (saída) e o webhook de leads (entrada) são cadastros separados no painel do portal. Recadastrar um não conserta o outro — se além dos leads os anúncios também sumiram, recadastre também a URL do XML (ver Portais).

Problemas comuns

• Recadastrei e ainda não chega lead — confira se colou a URL atual copiada da tela (não uma antiga anotada), e se ela foi salva no campo certo do painel do portal (integração/webhook de leads, não o do XML). Depois, faça um lead de teste e observe a data do último lead atualizar.
• Não sei onde cadastrar no painel do portal — use o botão Enviar e-mail de integração: o suporte do portal cadastra o endereço correto para você.
• O portal não oferece webhook — nem todo portal entrega lead por webhook. Nesses casos o card não mostra a linha de integração de leads, e os contatos chegam por outro meio (e-mail do portal, área do anunciante). O XML de anúncios continua funcionando normalmente.
• Órulo aparece aqui, mas é diferente — Órulo e outras integrações de importação de imóveis não são portais comuns; a conexão delas fica em Minhas integrações.

O que muda no seu site

Nada. O webhook de leads é a ponte entre o portal e o CRM — não passa pelo seu site próprio. Os leads do formulário do seu site entram por outra porta e não são afetados pelo webhook de um portal.

Perguntas frequentes

Preciso recadastrar o webhook toda hora? Não. É um cadastro único no painel do portal. Você só precisa refazer se a URL foi trocada/perdida no lado do portal — e a data do último lead na tela de Portais avisa quando isso acontece.

Recadastrar o webhook recupera os leads que não chegaram? Não. Os contatos que o portal enviou enquanto a URL estava errada não ficam guardados. Por isso o ideal é perceber cedo, pela data do último lead. Se precisar tentar recuperar contatos específicos, informe ao suporte o portal, a data/hora e o telefone.

Qual a diferença entre "Última solicitação" e a data do último lead? "Última solicitação" é quando o portal buscou o seu XML (lado dos anúncios). A data do último lead é quando o portal entregou um contato (lado dos leads). Uma pode estar em dia e a outra parada — são pontas independentes.