Por que o webhook do RD Station chega sem funnel_stage, e o lead do formulário da Meta some?

O webhook do RD Station Marketing traz a última conversão do instante, às vezes sem etapa do funil. E o formulário novo da Meta pode descartar o lead calado.

Pedro Henrique Quadroatualizado em 6 min de leitura

O webhook do RD Station Marketing manda o lead como ele está no instante do disparo, com a última conversão daquele momento. Se o negócio ainda não foi criado, essa conversão é outra, e o payload chega sem funnel_stage e sem o endereço da oportunidade. Um filtro que exige esses campos descarta o lead sem avisar. Já no formulário novo da Meta, o lead pode entrar no RD sem nome e sem telefone e nunca sair para o seu sistema. São duas falhas mudas: nas duas, nada no caminho acusava erro.

O que a documentação diz

Conferi a página de webhooks dos desenvolvedores do RD em 10 de outubro de 2026.

  • O webhook do Marketing dispara em dois gatilhos: conversão e oportunidade. Em conversão, envia o lead cada vez que ele converte. Em oportunidade, envia quando o lead é marcado como oportunidade, manualmente, por integração ou por fluxo de automação.
  • O campo entity_type identifica o evento, com os valores WEBHOOK.CONVERTED e WEBHOOK.MARKED_OPPORTUNITY.
  • O payload tem as informações do perfil do lead, padrão e personalizadas, se estiverem preenchidas.
  • Importação manual e atualização manual de contato não disparam webhook.

A página não menciona last_conversion, funnel_stage nem a corrida que descrevo abaixo. Tentei abrir também os artigos da central de ajuda sobre a integração com o Meta Lead Ads e sobre a ação "Enviar Leads para Integração" dos fluxos de automação, mas eles carregam por script e não consegui ler o texto. Tudo o que digo sobre essas telas é observação em produção.

O que vi em produção: webhook sem etapa

Num fluxo que consumia um webhook disparado por uma automação do RD (essa ação não está na página oficial que li), o payload trazia leads[0].last_conversion, a última conversão no instante do disparo. Só quando essa conversão era a criação da negociação (OPPORTUNITY_CREATED) o payload trazia content.funnel_stage e o endereço da oportunidade, de onde eu tirava o ID da negociação. Quando o webhook disparava antes de a negociação virar a última conversão, esses campos faltavam. Existe uma corrida entre o formulário, a criação da negociação e o webhook.

Em 6 de julho de 2026 vi as duas consequências:

  • Sem o endereço da oportunidade, o nó que atualizava a negociação falhava com "ID da negociação é obrigatório", depois de o primeiro contato já ter sido enviado. O lead ficava parado na primeira etapa, como se ninguém tivesse falado com ele.
  • Sem funnel_stage, o filtro (um Switch do n8n) descartava o lead, e a execução aparecia como sucesso sem ter feito nada.

Também apareceu um caso em que a linha do tempo do lead no RD marcava "Completou o fluxo de automação" sem que eu tivesse registro de nenhum disparo. A falha pode ser do lado do RD. Não consegui provar.

O que fazer com o webhook

  1. Não assuma que a última conversão é a da negociação.
  2. Faça um fallback para o ID da negociação: buscar o contato pelo telefone no CRM e pegar a primeira negociação dele. Proteja com um IF para o caso de não achar nada.
  3. Registre todo disparo na entrada, antes de qualquer filtro, com uma coluna que diga se a oportunidade veio. Foi assim que medi a frequência.
  4. Filtro que descarta deve gravar o que descartou.

O que vi em produção: o formulário novo da Meta

Quando o formulário de captação foi trocado, nada mudou no n8n, e o lead sumiu. Eram dois passos manuais no RD, ambos silenciosos.

Passo 1, o mapeamento de campos. Em Integrações, no Meta Lead Ads, o formulário novo nasceu com status pendente e só o e-mail combinado. A tela, como a vi, avisava que campos sem combinação ficam indisponíveis na base de leads; não consegui conferir o nome exato da tela e dos botões na ajuda do RD, então procure pelo mapeamento de campos da integração com o Meta Lead Ads. Na prática, o lead entrou no RD sem nome, sem telefone e sem as respostas. Meu filtro exigia telefone, então descartava o lead sem ruído. Quem ainda funcionava era quem já existia na base com telefone de um cadastro antigo. A correção foi abrir o formulário pendente, combinar cada campo do formulário da Meta com o campo do RD (nome, telefone, e-mail e as perguntas) e salvar, usando como guia o mapeamento de um formulário parecido que já estava concluído. Os nomes de tela e de botão acima são como lembro da interface, não conferi na ajuda do RD.

Passo 2, o gatilho do fluxo. O que mandava o lead ao n8n era um fluxo de automação cujo gatilho é uma lista de critérios, escrita um por um, ligados por "ou", e cada critério nomeia um formulário. Formulário fora da lista entra no RD e nunca sai, sem erro em camada nenhuma. O sintoma é um lead visível no RD e ausente no log do webhook, e levou 4 dias para aparecer. No meu caso, o gatilho só valia para quem passasse a atender aos critérios e não retroagia: incluir o formulário depois não recupera quem já converteu.

Medi mais duas coisas em 19 de agosto de 2026. Uma lista de contatos importada à mão entrou no RD e não gerou nenhuma execução no n8n, de acordo com o que a documentação diz sobre importação. E o e-mail de boas-vindas e o envio ao n8n saíam do mesmo fluxo, então quem entra por importação também não recebia o e-mail.

O que fazer com o formulário

  1. Ao subir um formulário novo, confira o status do mapeamento antes de ligar o tráfego. No que vi, pendente significava lead sem dados.
  2. Confira se o formulário está no gatilho do fluxo. Um formulário de teste converte e você vê se aparece no log.
  3. Diagnostique em camadas: da Meta ao RD (mapeamento), do RD ao seu sistema (gatilho) e do seu sistema ao atendimento (filtro). A resposta de que "as perguntas não mudaram" vale para a Meta, e não diz nada sobre o que o RD recebe.
  4. Compare periodicamente os leads do RD com o log do webhook. A diferença é o lead perdido.

Se leads de anúncio estão sumindo antes de chegar ao atendimento, é o tipo de coisa que resolvo em vendas e CRM com IA.

Fontes

  1. RD Station: webhooks do Marketing (gatilhos de conversão e oportunidade, payload, importação manual não dispara)
Pedro Henrique QuadroEngenheiro de software e IA. Constrói aplicativos, sistemas, painéis e agentes de IA em produção, e tem código aceito no Supabase, no Kestra e no QuestDB.

Continue lendo