Integração · Meta + Imobilead

API de Conversão da Meta no Imobilead

Guia atualizado para configurar a integração usando um conjunto de dados (Pixel) do tipo CRM — o passo que faz toda a diferença para os eventos do corretor chegarem corretamente ao Meta.

Atualizado em julho de 2026 · Interface do Gerenciador de Eventos v25.0
O que mudou nesta versão O Pixel agora deve ser criado como conjunto de dados do tipo CRM e conectado manualmente. Com isso, você não seleciona mais os eventos dentro do Meta — apenas gera o ponto de extremidade e o token de acesso. O teste também mudou: além do "Código de teste", agora existe o "Lead de verificação".

Por que usar a API de Conversão?

Quando você configura a API de Conversão, o Imobilead envia ao Meta eventos importantes baseados nas ações do corretor dentro do CRM. Isso permite que o algoritmo do Facebook:

Eventos enviados automaticamente

O Imobilead envia 3 eventos fixos para o Meta, conforme o corretor movimenta o lead no funil:

Ação no CRMQuando aconteceEvento no MetaDados enviados
Agendamento de visita O corretor agenda uma visita para o lead Schedule (Programar)
Venda ganha O corretor marca o lead como "venda ganha" e insere o valor Purchase (Comprar) Valor da venda (anonimizado)
Lead desqualificado O corretor finaliza/desqualifica o lead informando o motivo Lead_disqualified (personalizado) Motivo da desqualificação
Privacidade em primeiro lugar Todos os dados são enviados de forma anonimizada (hash), respeitando a privacidade dos usuários.

Etapa 1 — Criar o Pixel tipo CRM no Meta

Esta é a etapa mais importante e a que costumava gerar dúvidas. O conjunto de dados precisa ser do tipo CRM — não do tipo Site nem App. É isso que permite ao Imobilead enviar os eventos do corretor pelo servidor.

Atenção — escolha o tipo CRM Se você criar um Pixel de site comum, a integração não vai funcionar como esperado. Ao adicionar a fonte de dados no Gerenciador de Eventos, selecione CRM.
1

Abrir o Gerenciador de Eventos e criar o conjunto de dados

Acesse o Gerenciador de Eventos no Meta Business Manager e clique em Conectar fontes de dados (ou "+ Adicionar"). Selecione a opção CRM e dê um nome descritivo ao conjunto de dados (ex.: CRM Imobiliária).

2

Conectar manualmente

Na janela "Como deseja conectar seu CRM?", abra a aba Conectar manualmente e escolha "Fazer a programação manualmente por conta própria" (opção recomendada). Clique em Avançar.

Janela 'Como deseja conectar seu CRM?' com a aba Conectar manualmente e a opção Fazer a programação manualmente por conta própria selecionada.
Aba "Conectar manualmente" → "Fazer a programação manualmente por conta própria" → Avançar.
3

Copiar a Identificação do conjunto de dados (Pixel ID)

Na etapa "3. Criar ponto de extremidade", localize à direita a Identificação do conjunto de dados. Esse número é o que o Imobilead chama de Pixel ID — anote-o.

Tela 'Criar ponto de extremidade' destacando a Identificação do conjunto de dados e o botão Copiar ponto de extremidade.
① Identificação do conjunto de dados = Pixel ID que você usará no Imobilead.
4

Gerar e copiar o Token de acesso

Ainda na etapa 3, clique em Gerar token de acesso e, em seguida, em Copiar token de acesso. Esse é o código longo que autoriza o Imobilead a enviar eventos pelo servidor.

Botões Copiar token de acesso e Copiar ponto de extremidade na tela de criar ponto de extremidade.
Clique em "Gerar token de acesso" e depois em "Copiar token de acesso".
Guarde os dois dados Você sairá desta tela com duas informações: a Identificação do conjunto de dados (Pixel ID) e o Token de acesso. Ambos serão colados no Imobilead na próxima etapa.

Etapa 2 — Cadastrar o Pixel no Imobilead

1

Abrir as integrações

No Imobilead, vá em Integrações → Entradas e Saídas de lead, encontre API de Conversão da Meta e clique em Adicionar um pixel.

2

Preencher os dados do Pixel

No formulário Adicionar Novo Pixel, preencha:

  • Nome: um nome de sua preferência para identificar o pixel;
  • Pixel ID: cole a Identificação do conjunto de dados copiada na Etapa 1;
  • Token de Acesso da API de Conversões: cole o token de acesso gerado no Meta;
  • Status: deixe em Ativo.

Clique em Criar Pixel.

Formulário 'Adicionar Novo Pixel' do Imobilead com os campos Nome, Pixel ID e Token de Acesso da API de Conversões.
① Pixel ID (Identificação do conjunto de dados) · ② Token de Acesso da API de Conversões.
Pronto — a integração básica está configurada A partir daqui, os eventos do corretor já começam a ser enviados. Recomendamos fazer o teste abaixo para confirmar que tudo está funcionando.

Etapa 3 — Testar a integração (Lead de verificação)

O teste garante que o Meta está recebendo os eventos. Como o conjunto de dados é do tipo CRM, o método mais confiável é o Lead de verificação. Você vai copiar um lead de teste no Meta e colá-lo no Imobilead.

1

No Meta: abrir os Eventos de teste e selecionar o canal CRM

No Gerenciador de Eventos, abra o conjunto de dados e vá em Eventos de teste. Em "Selecione um canal de marketing", escolha CRM. Selecione o Formulário instantâneo da sua página do Facebook (ex.: Lead Imobilead).

Aba Eventos de teste no Meta com o canal CRM selecionado, um formulário instantâneo escolhido e a linha de Lead de verificação para copiar.
Canal CRM → escolha o formulário → copie a linha do Lead de verificação (leadId • email • telefone).
2

Copiar a linha do Lead de verificação

Em Eventos, o Meta mostra um Lead de verificação no formato leadId • email • telefone. Copie essa linha inteira. Se precisar de um novo, clique em Gerar novo lead.

3

No Imobilead: abrir o teste do pixel

No card do pixel criado, clique no ícone de teste (frasco).

Card do pixel no Imobilead com o ícone de teste (frasco) em destaque.
Ícone de teste (frasco) no card do pixel.
4

Escolher "Lead de verificação" e iniciar

Na janela Testar Facebook Pixel, em Tipo de Teste selecione Lead de verificação e cole a linha copiada do Meta (formato: leadId, email, telefone — separados por , vírgula ou espaço). Clique em Iniciar Teste.

Janela 'Testar Facebook Pixel' do Imobilead com o Tipo de Teste 'Lead de verificação' selecionado.
Tipo de Teste → Lead de verificação. Serão testados os eventos Purchase, Scheduler e Lead_disqualified.
Alternativa: Código de teste Você também pode usar o "Código de teste" tradicional: copie o código na aba de Eventos de teste do Meta e cole selecionando o tipo Código de teste no Imobilead.
5

Conferir os eventos no Meta

Volte à aba Eventos de teste do Meta e atualize. Você verá os eventos recebidos (ex.: Compra) com Origem do evento: crm e status Processado, incluindo os parâmetros email, lead_id, phone.

Eventos de teste recebidos no Meta mostrando o evento Compra com origem crm e status Processado.
Evento Compra · Processado, origem crm — integração funcionando.
Pode levar alguns minutos Os eventos de teste costumam aparecer quase imediatamente, mas os eventos de produção podem levar até 30 minutos para constar no painel do Meta.

Confirmar o evento personalizado

Após o primeiro teste, o Meta pode solicitar a confirmação do evento personalizado Lead_disqualified:

Problemas comuns

"Falha ao conectar com serviço de teste"

Verifique se o Pixel ID (Identificação do conjunto de dados) e o Token de acesso foram colados corretamente no Imobilead, sem espaços extras.

Os eventos não aparecem no Meta

  • Aguarde até 30 minutos (eventos de produção);
  • Confirme que o pixel está Ativo no Imobilead;
  • Verifique se o conjunto de dados foi criado como tipo CRM — este é o erro mais frequente;
  • Confirme se o corretor está de fato alterando os status dos leads.

A interface do Meta está diferente do tutorial

O Facebook altera suas telas com frequência. Os conceitos permanecem os mesmos (conjunto de dados tipo CRM, ponto de extremidade e token de acesso), mas os menus podem mudar de lugar.

Benefícios esperados Melhoria na qualidade dos leads vindos do Facebook, redução no custo por lead qualificado, otimização automática das campanhas e dados mais precisos para análise de performance.