Guia técnico · Meta Ads

API de Conversões da Meta para imobiliária: visita e venda voltam para o anúncio

O pixel só vê o que acontece no navegador. A venda de imóvel acontece no WhatsApp, na visita e no cartório. A API de Conversões leva esses fatos do CRM para a Meta, pelo servidor.

Testar 7 dias grátis Falar no WhatsApp

Tela Eficiência das campanhas da Viniun com custo por lead, visita, proposta e venda de cada campanha de imóvel

Resposta curta

A API de Conversões da Meta (CAPI) envia eventos do servidor direto para a Meta, sem depender do navegador. Para imobiliária, ela serve para mandar lead qualificado, visita agendada, proposta e venda do CRM. Na Viniun, a API liga sozinha ao conectar a Meta, deduplica com o pixel e manda o código do imóvel.

Por Danilo Luiz · atualizado em 09/11/2026

Em resumo

6 conversões personalizadas criadas sozinhas na Meta: lead qualificado, visita agendada, proposta, venda (VGV), contato do site e ficha de imóvel vista.
Deduplicação por event_id fixo (conta, etapa, lead e referência): o mesmo fato nunca conta duas vezes.
Imóvel visto vai com content_type = home_listing e content_ids = [código do imóvel], o mesmo id do catálogo.
Eventos do site enviados em lote pelo servidor (fila Redis), sem pesar o carregamento da página. Recurso ligado desde 10/10/2026.

Para quem é (e quando não é indicado)

É indicado para

Imobiliária que anuncia no Facebook e no Instagram e quer que a Meta otimize para visita e venda, não para clique.
Gestor de tráfego que perdeu sinal com bloqueador de anúncio, iOS e cookies.
Quem já tem pixel e quer saber se ainda precisa da API (precisa).

Não é indicado quando

Quem não anuncia na Meta: os eventos só servem para otimizar e medir anúncio.
Quem não registra visita e venda no CRM: a API manda o que o sistema sabe; funil vazio não gera sinal.

Como conferir no Gerenciador de Eventos e o que é qualidade da correspondência

No Gerenciador de Eventos da Meta, abra o conjunto de dados (pixel) da conta. Os eventos que vêm do servidor aparecem com a origem "Servidor"; os do navegador, "Navegador". Quando o mesmo evento chega pelos dois, a Meta marca como deduplicado — isso é bom, não é erro.

Cada evento tem uma nota de "qualidade da correspondência" de 0 a 10. Ela mede quantos dados de identificação vieram junto para a Meta achar a pessoa. A Viniun manda telefone, e-mail, nome e cidade sempre em SHA-256 (nunca em claro), e os identificadores que a própria Meta emitiu — fbp, fbc, ctwa_clid do anúncio de WhatsApp, lead_id do formulário. No evento do site vão também IP e navegador, que a Meta exige sem hash.

Quanto mais desses dados, maior a nota e mais a Meta consegue ligar a venda ao anúncio certo. Lead que chegou por portal ou indicação não é da Meta e não é enviado — de propósito, para não ensinar o algoritmo errado.

Erros comuns na API de Conversões (e o que a Viniun já resolve)

Evento duplicado: navegador e servidor contando duas vezes. A Viniun usa um event_id fixo por fato e trava no banco: o mesmo fato não gera segunda linha nem segundo envio.
Evento atrasado demais: a Meta recusa evento com mais de 7 dias. A Viniun envia em fila logo após o fato e nem tenta o que passou do prazo.
Dado pessoal em claro: proibido. Tudo vai com hash, menos o que a Meta exige cru.
Conversão no navegador: lead, visita, proposta e venda não saem do navegador — vão só pelo servidor, que é confiável e não é bloqueado.
Token vencido: o envio para de funcionar sem aviso. O painel avisa quando a conexão com a Meta precisa ser refeita.
Venda sem valor: a Meta não aprende quanto vale cada cliente. A Viniun manda o valor do negócio quando ele existe.

Pixel ou API de Conversões? As duas, cada uma com um papel

A dúvida "api de conversões ou pixel" aparece muito. Para imobiliária, a resposta é: os dois, e o servidor manda as conversões que importam.

	Pixel da Meta (navegador)	API de Conversões (servidor)
Onde roda	No navegador do visitante	No servidor do sistema
Bloqueador de anúncio e iOS	Perde parte dos eventos	Não é afetado
Vê o que acontece fora do site	Não	Sim: WhatsApp, visita, proposta, venda
Exemplo de evento	PageView, ViewContent do imóvel	Schedule (visita), Purchase (venda com valor)
Precisa de deduplicação	Sim, com o mesmo event_id do servidor	Sim, com o mesmo event_id do navegador
Na Viniun	Instalado sozinho no site e no portal	Liga sozinha ao conectar a Meta

Quais eventos da imobiliária vão para a Meta

Cada etapa do funil do CRM vira um evento padrão da Meta. A tabela é a lista exata que o sistema usa.

Fato no CRM	Evento da Meta	Conversão personalizada criada
Lead qualificado	QualifiedLead	Lead qualificado
Visita agendada	Schedule	Visita agendada
Proposta enviada	SubmitApplication	Proposta
Negócio fechado	Purchase (com valor)	Venda (VGV)
Clique no WhatsApp ou telefone do site	Contact	Contato WhatsApp/telefone do site
Ficha do imóvel aberta no site	ViewContent (home_listing)	Ficha de imóvel vista

A conversão "Ficha de imóvel vista" filtra content_type = home_listing, o que a liga ao catálogo de imóveis.

Como configurar a API de Conversões da Meta numa imobiliária

O roteiro técnico, na ordem. Ao lado, o que o sistema já faz.

Tenha um Pixel (conjunto de dados) na conta de anúncios Na Viniun, a conexão Meta em 1 clique lê o Pixel da conta de anúncios escolhida.
Gere o token de acesso do servidor No modo manual, você gera no Gerenciador de Eventos. Na Viniun, o token vem da conexão oficial da Meta; dá para colar um token do conjunto de dados se preferir.
Defina o event_id de cada fato Ele precisa ser o mesmo no navegador e no servidor e não pode mudar se o evento for reenviado. O sistema usa um id determinístico: conta, etapa, lead e referência (por exemplo, a visita nº 12).
Mande os dados de correspondência com hash E-mail e telefone em SHA-256, mais fbp/fbc quando existirem. Sem isso, a Meta não acha a pessoa.
Envie as etapas do funil Lead qualificado, visita, proposta e venda, cada uma no momento em que o lead muda de etapa no CRM.
Crie as conversões personalizadas Para otimizar campanha por visita ou venda. O sistema cria as seis sozinho e guarda o link de cada uma.
Teste no Gerenciador de Eventos Há um botão de teste que manda um evento Lead e mostra se a Meta aceitou.

Deduplicação: o detalhe que dobra (ou zera) seus números

Quando o mesmo fato chega pelo navegador e pelo servidor, a Meta só conta uma vez se os dois tiverem o mesmo nome de evento e o mesmo event_id. Se o id mudar a cada envio, a conversão conta em dobro e o custo por resultado parece metade do real.

Na Viniun, o event_id é fixo para o mesmo fato. Exemplo: a visita nº 12 do lead 340 tem sempre o mesmo id. Do nosso lado, há ainda uma trava no banco: o mesmo id não é gravado duas vezes. Se o lead andar no funil sozinho e a visita for registrada depois, os dois caminhos caem na mesma linha.

Conversão que não sai do navegador é regra da casa: lead, visita, proposta e venda vão só pelo servidor, que deduplica. O navegador fica com as visitas ao site e ao imóvel.

Por que o código do imóvel no evento importa

Quando alguém abre a ficha de um imóvel no site, o evento ViewContent sai com content_type = home_listing e content_ids = [código do imóvel]. É o mesmo id usado no catálogo de imóveis da Meta.

Com isso a Meta sabe qual imóvel cada pessoa viu. É a base do remarketing dinâmico: quem viu o apartamento AP100 recebe o anúncio do AP100 e de parecidos. Sem o código, o evento serve só para contar visita.

Desempenho: por que os eventos do site vão em lote

Um envio à Meta por página vista seguraria o servidor e gastaria a cota da API. Por isso os eventos do site entram numa fila (Redis) e saem em lote. O visitante não espera nada, e a Meta recebe tudo em poucos minutos.

Os eventos do CRM (visita, proposta, venda) também passam por fila: se a Meta estiver fora do ar, o envio é refeito depois, sem perder o fato.

Checklist de qualidade da API de Conversões

Pixel e servidor usam o mesmo event_id para o mesmo fato.
E-mail e telefone vão com hash, nunca em texto puro.
Venda vai com valor e moeda BRL.
O catálogo de imóveis está em BRL (a Meta cria em dólar se ninguém disser; o sistema corrige).
Visita e venda estão sendo registradas no CRM, senão não há o que enviar.
Campanhas de imóvel otimizam para conversão personalizada (visita ou lead qualificado), não só para clique.

Como a Viniun faz

Ao conectar a Meta em Conexões, a API de Conversões já sai ligada: Pixel e token configurados, as seis conversões personalizadas criadas e a moeda do catálogo acertada em BRL. Contas que estavam conectadas antes de 10/10/2026 foram ligadas por uma rotina própria, que respeita quem desligou na mão.

A partir daí, cada vez que um lead muda de etapa no CRM, o evento correspondente vai para a Meta pelo servidor. O site manda as visitas ao imóvel com o código. Você não cola script, não monta planilha de UTM e não sobe arquivo de conversões offline.

O resultado aparece na tela Eficiência das campanhas: quanto cada anúncio custou por lead, por visita, por proposta e por venda. A mesma lógica vale para o Google Ads e para o TikTok, cada um pela sua API.

Importante: Conversões das conversas do WhatsApp (dataset do WhatsApp) estão prontas no código, mas exigem número oficial da API do WhatsApp (WABA). Com WhatsApp comum, os eventos do CRM e do site funcionam normalmente; só esse conjunto específico fica de fora.

Anúncio medido até a venda: Seu anúncio gera mensagem. Mas gera venda? | Viniun

Funil de 13 conversas, 13 leads, 9 visitas, 3 propostas e 2 fechados e custo por etapa de cada campanha na conta demo da Viniun — As etapas que a API manda para a Meta são as mesmas que a tela mede (conta demo).

Painel da Viniun com leads, imóveis e tempo de resposta — O funil do CRM é a fonte dos eventos.

Quanto custa

A API de Conversões faz parte do módulo Marketing: vem no Profissional ou no opcional Marketing pago. O pixel no site vem em todos os planos com site.

Plano	Plano mensal	Plano anual (por mês)	Usuários	Atendimentos de IA por mês
Básico	R$ 263,35	R$ 229	3	200
Imobiliária	R$ 456,55	R$ 397	5	300
Profissional	R$ 916,55	R$ 797	12	1.000

Valores lidos do painel da Viniun em 09/11/2026. Teste grátis de 7 dias com todos os recursos, sem cartão. Tabela completa e simulador em planos e preços.

Números conferidos no código e na conta

6conversões personalizadas criadas sozinhasConversoesPersonalizadasMeta · desde 10/10/2026

4etapas do funil enviadas (qualificado, visita, proposta, venda)ConversoesFunil · 14/10/2026

5.693imóveis da Vini Imóveis aceitos no catálogo que recebe os content_idsde 5.710 enviados · leitura de 10/10/2026

Perguntas frequentes

O que é a API de Conversões da Meta?

É o envio de eventos do servidor direto para a Meta. Ela complementa o pixel e não depende do navegador, então não é afetada por bloqueador de anúncio nem pelas regras do iOS.

Se já tenho pixel, preciso da API de Conversões?

Sim. O pixel não vê visita, proposta nem venda, que acontecem fora do site. São justamente os eventos que ensinam a Meta a achar comprador.

Como evitar conversão duplicada?

Use o mesmo nome de evento e o mesmo event_id no navegador e no servidor. Na Viniun, o id é fixo por fato e há trava no banco contra repetição.

Preciso de programador para configurar?

Não na Viniun: ao conectar a Meta, a API liga sozinha. No modo manual, sem sistema, é preciso alguém técnico para o token, o hash e o event_id.

A venda vai com valor?

Sim. O negócio fechado vai como Purchase com valor em reais, o que permite ver o retorno sobre o investimento.

Funciona com o WhatsApp comum?

Os eventos do CRM e do site, sim. O dataset de conversas do WhatsApp exige número oficial da API do WhatsApp.

E o Google e o TikTok?

O Google Ads recebe as conversões pela API dele (offline e otimizadas). O TikTok tem Pixel e Events API em 1 clique, ainda em aprovação pela plataforma.

Teste a Viniun por 7 dias

Todos os recursos, sem cartão de crédito. A migração dos seus imóveis é grátis em qualquer plano.