Documentação

Formulário nativo da Meta (Lead Ads)

Quando a campanha usa o formulário instantâneo do Facebook ou do Instagram, o lead não passa pelo seu site: ele fica dentro da Meta. O ImobiliQ recebe esses leads por webhook, cria o card no pipeline com as respostas do formulário e as informações do anúncio, e dispara a primeira mensagem no WhatsApp se a mensagem automática estiver ligada.

Por que usar o webhook e não baixar planilha?

Baixar CSV do Gerenciador significa que o lead espera alguém lembrar de baixar. No mercado imobiliário, quem responde primeiro atende. Com o webhook, o lead entra no pipeline em segundos e já sai distribuído para um corretor.

Como ligo o formulário ao ImobiliQ?

  1. Conecte a Meta antes

    O caminho do Lead Ads usa a mesma conexão da Conversions API. Se ainda não fez, siga Conectar a Meta primeiro.
  2. Peça a assinatura do webhook ao suporte

    A assinatura do webhook de Lead Ads é feita no aplicativo do Business Manager e vale para a página do Facebook inteira. Abra um chamado pelo menu Suporte informando o nome da página e o identificador do formulário; nós assinamos e confirmamos o teste.
  3. Rode um lead de teste

    No Gerenciador de Anúncios, use a ferramenta de teste de leads (Lead Ads Testing Tool) para enviar um lead falso. Ele precisa aparecer no pipeline em poucos segundos.
O que depende da Meta
A assinatura do webhook e a revisão de permissões acontecem do lado da Meta e podem levar alguns dias, principalmente se o aplicativo ainda não passou pela análise. É a única parte desta integração que não depende só de nós.

As perguntas de qualificação aparecem onde?

Cada pergunta do formulário vira um campo na ficha do lead, com o nome humanizado. Se o seu formulário pergunta faixa de investimento e bairro de interesse, o corretor vê as duas respostas antes de mandar a primeira mensagem, junto com a campanha e o anúncio que trouxeram aquela pessoa.

O telefone informado no formulário é o que liga esse lead à conversa do WhatsApp: quando o corretor (ou a mensagem automática) inicia o contato, a conversa nasce já vinculada ao card, com as respostas e as UTMs no mesmo lugar.

E se eu não quiser esperar a assinatura?

Dá para chegar no mesmo resultado por fora, com uma automação: no n8n, Make ou Zapier, use o gatilho de novo lead do Facebook e mande os dados para o endpoint de ingestão. O resultado no CRM é idêntico, e você controla o fluxo. O passo a passo está em Enviar leads para o CRM, na seção do n8n.

Nesse caminho, lembre de mandar as respostas do formulário dentro de custom_fields e o identificador do anúncio em fonte, para não perder a rastreabilidade.