--- titulo: API de Conversões da Meta para imobiliária: guia completo url: https://viniun.com.br/api-de-conversoes-meta-para-imobiliaria/ descricao: API de Conversões da Meta para imobiliária: o que é, pixel ou API, deduplicação e como mandar visita e venda do CRM para a Meta. Na Viniun, liga sozinha. gerado_em: 2026-11-09 --- 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](https://viniun.com.br/teste-gratis/) [Falar no WhatsApp](https://wa.me/5513991635583?text=Ol%C3%A1!%20Vim%20da%20p%C3%A1gina%20API%20de%20Convers%C3%B5es%20Meta%20e%20quero%20saber%20mais.) (imagem: 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](https://viniun.com.br/quem-somos/) · 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 (imagem: 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). (imagem: 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](https://viniun.com.br/planos-e-precos/). ## Números conferidos no código e na conta **6** conversões personalizadas criadas sozinhasConversoesPersonalizadasMeta · desde 10/10/2026 **4** etapas do funil enviadas (qualificado, visita, proposta, venda)ConversoesFunil · 14/10/2026 **5.693** imó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. [Testar 7 dias grátis](https://viniun.com.br/teste-gratis/)[Falar no WhatsApp](https://wa.me/5513991635583?text=Ol%C3%A1!%20Vim%20da%20p%C3%A1gina%20API%20de%20Convers%C3%B5es%20Meta%20e%20quero%20saber%20mais.) (imagem: Família recebendo as chaves do imóvel novo) ## Veja também ### [Remarketing dinâmico na Meta](https://viniun.com.br/remarketing-dinamico-meta-ads/) Catálogo + content_ids na prática ### [Facebook Ads para imobiliária](https://viniun.com.br/facebook-ads-para-imobiliaria/) A campanha do imóvel pelo painel ### [Facebook Lead Ads](https://viniun.com.br/facebook-lead-ads-para-imobiliaria/) Formulário do anúncio direto no CRM ### [Google para imobiliária](https://viniun.com.br/google-para-imobiliaria/) GTM, GA4 e Ads em 1 clique ### [Marketing imobiliário digital](https://viniun.com.br/marketing-imobiliario-digital/) O ciclo completo do anúncio à venda (imagem: Danilo Luiz, fundador da Viniun) **Danilo Luiz** , fundador da Viniun: 26 anos de marketing digital, 20 deles no mercado imobiliário. Publicado em 09/11/2026, atualizado em 09/11/2026. [Quem somos](https://viniun.com.br/quem-somos/)