A API de Conversões para imobiliária conta à Meta o que acontece depois do clique no anúncio: o lead foi qualificado, agendou visita, recebeu proposta, fechou negócio. Junto com o Pixel do Facebook no site, ela ensina a Meta a trazer quem compra ou aluga, e não só quem clica. Na Viniun, isso sai do funil do CRM sem planilha e sem programador; o resumo das novidades apresentou o recurso, e aqui está o passo a passo.
Qual a diferença entre o Pixel e a API de Conversões?
O Pixel é um código no site que avisa a Meta, pelo navegador, quando alguém vê uma página ou clica em contato. Bloqueador de anúncios e as restrições do iPhone escondem parte desses avisos.
A API de Conversões (CAPI) manda os eventos pelo servidor. Ela recupera o que o navegador perdeu e, principalmente, leva à Meta o que acontece fora do site: atendimento no WhatsApp, visita e venda registradas no CRM.
Quais etapas do funil do CRM vão para a Meta?
Cada etapa vira um evento no Pixel (conjunto de dados) da imobiliária, uma vez só por lead e por etapa:
| O que acontece no CRM | Evento na Meta |
|---|---|
| Lead criado | Lead |
| Qualificação concluída | Lead qualificado (evento personalizado) |
| Visita agendada ou confirmada | Schedule (agendamento) |
| Proposta enviada, contraproposta ou aceita | SubmitApplication |
| Contrato ativo ou venda concluída | Purchase, com o valor em reais |
Só vai o lead que veio de anúncio da Meta: clique para o WhatsApp, formulário de anúncio, comentário em anúncio ou visita ao site vinda de anúncio. Lead de portal ou de indicação não é enviado, porque não foi a Meta que trouxe.
Se a Meta estiver fora do ar, o envio é tentado de novo algumas vezes. Evento com mais de 7 dias não é enviado, porque a Meta recusa.
Como o site da imobiliária manda eventos pelo servidor?
Com a opção Site pelo servidor (Pixel + API de Conversões), cada página vista, ficha de imóvel, busca e clique de contato do site também vai à Meta pelo servidor, com o mesmo código do Pixel. Assim a Meta conta uma vez só e recupera o que o bloqueador e o iPhone escondem.
- Página vista e ficha de imóvel (com código e valor do imóvel);
- busca com filtros na lista de imóveis;
- contato por WhatsApp ou telefone;
- favorito, simulação e proposta pelo portal.
Os eventos saem em lote a cada 10 segundos, sem pesar no site. Só entram visitantes que aceitaram os cookies, e robôs ficam de fora.

O que são as conversões personalizadas na Meta?
São metas que aparecem no conjunto de anúncios, para otimizar por "lead qualificado" ou "venda" em vez de só "lead". A Viniun cria na conta de anúncios, com o prefixo "Viniun ·": Lead qualificado, Visita agendada, Proposta, Venda (VGV), Contato e Ficha de imóvel.
No assistente de campanha, o objetivo Lead no site (otimizado pela API de Conversões) usa esses sinais: a Meta entrega para quem tende a deixar o contato, não só a clicar. Ele precisa do Pixel escolhido em Conexões.
A API de Conversões respeita a LGPD?
Telefone, e-mail, nome, cidade e a identificação do cliente vão só em hash SHA-256, que é o formato que a própria Meta pede. Nenhum contato sai em claro.
Em claro vão apenas os códigos que a própria Meta criou (do clique ou do formulário) e, no evento do site, o IP e o navegador, que a Meta exige sem hash. Quem pediu exclusão dos dados não recebe mensagem do robô, e os públicos usam o mesmo hash.
Dá para mandar o funil ao Google Ads e ao GA4?
Sim, pela mesma aba. São dois envios diferentes:
Google Ads
Conta ao Google o que o clique virou: lead, qualificado, visita, proposta e venda com valor. Só vai o lead que veio de anúncio do Google. Para cada etapa, você cria uma ação de conversão do tipo "Importar › Outras fontes / CRM" no Google Ads e cola o ID dela na Viniun; etapa em branco não é enviada.
Google Analytics 4
Manda o funil ao GA4 (generate_lead, qualify_lead, visita, proposta e close_convert_lead com valor), usando o ID de medição (G-...) e uma chave secreta do Measurement Protocol do fluxo do site. Aqui vai todo lead, de qualquer origem, e o Tag Manager do site recebe o evento viniun_lead quando o visitante já é um lead.
Quais as condições para ligar?
- Conectar a Meta em Conexões com a conta de anúncios do portfólio da empresa e escolher o Pixel. Com Pixel e token, a API de Conversões liga sozinha; quem desmarcar na tela não é religado.
- Token do conjunto de dados (opcional): gerado no Gerenciador de Eventos, não expira. Em branco, a Viniun usa o token do Marketing.
- Clique para o WhatsApp: o evento de mensagem com a marca do anúncio exige o número oficial do WhatsApp (API da Meta) e o conjunto de dados vinculado à conta do WhatsApp Business. Com número por QR code, o lead é casado pelo telefone em hash.
- Google: conta do Google Ads conectada e as ações de conversão criadas por você.
Como começar a usar a API de Conversões para imobiliária na Viniun?
- Em Conexões, entre com o Facebook e escolha conta de anúncios, página, Instagram e Pixel.
- Em Marketing & Campanhas › Configuração › Conversões (Meta, Google), confira se "Enviar os eventos do funil para a Meta" está marcado.
- Cole o código de teste do Gerenciador de Eventos e clique em "Testar evento". O teste não conta nos resultados.
- Marque "Enviar os eventos do site pelo servidor" e clique em "Criar conversões na Meta".
- Se usa Google, preencha os IDs das ações e os dados do GA4 na mesma aba.
A tela mostra os envios dos últimos 30 dias, os erros e o que está na fila. Com o funil chegando à Meta, vale usar o remarketing dinâmico de imóveis, os públicos da Meta e as regras de desempenho. O funil sai do CRM imobiliário com WhatsApp e IA e faz parte do módulo de integração e marketing. As telas são da conta de demonstração da Viniun, com dados fictícios.
Quer ver a API de Conversões ligada ao seu funil? Peça uma demonstração.
Perguntas frequentes
Todo lead do CRM vai para a Meta?
Não. Só vai o lead que veio de anúncio da Meta: clique para o WhatsApp, formulário de anúncio, comentário em anúncio ou site com marcação da Meta. Para o GA4, sim, vai todo lead.
Preciso de programador para instalar a API de Conversões?
Não. Com a Meta conectada e o Pixel escolhido em Conexões, a Viniun liga a API de Conversões sozinha. O token próprio do conjunto de dados é opcional.
Como sei se os eventos estão chegando?
Use o código de teste do Gerenciador de Eventos e o botão "Testar evento". A aba mostra também os envios dos últimos 30 dias, os erros e a fila.
O evento conta em dobro com o Pixel do navegador?
Não. O site manda pelo servidor com o mesmo código do evento do Pixel, e a Meta conta uma vez só. Cada etapa do funil também é enviada uma vez por lead.
O que precisa para o clique no WhatsApp virar evento de mensagem?
O número oficial do WhatsApp (API da Meta) e o conjunto de dados vinculado à conta do WhatsApp Business. Com número por QR code, o lead é casado pelo telefone em hash.
Equipe Viniun
Time de produto e conteúdo da Viniun
Quem constrói a Viniun — CRM, site, WhatsApp com IA e gestão para imobiliárias, corretores e construtoras — conta aqui cada novidade da plataforma e o que aprende no dia a dia do mercado imobiliário.
Gostou? Receba os próximos no seu e-mail
O que muda na plataforma, explicado para quem usa, e ideias que dá para aplicar no mesmo dia em marketing, atendimento e gestão.
- No máximo 1 e-mail por semana
- Sem spam e sem repassar seus dados
- Cancele quando quiser, com um clique
