API de Conversões da Meta e Pixel: por que o lead some da medição e como corrigir
A API de Conversões da Meta envia ao Meta Ads, a partir do servidor da empresa, eventos como lead, agendamento e venda, inclusive os que acontecem fora do site. O Pixel registra o que o navegador vê; a API, o que o sistema da empresa sabe. Juntos, devolvem ao anúncio a venda feita no WhatsApp ou no CRM.
O que é a API de Conversões da Meta
A API de Conversões (Conversions API, ou CAPI) é uma ferramenta da Meta para enviar eventos de marketing a partir de um servidor, e não do navegador do visitante. Segundo a documentação oficial, ela conecta dados de eventos de site, de app, de conversas (business messaging) e de conversões off-line aos sistemas da Meta, que usam esses dados para segmentar, otimizar custo e medir resultado (Meta for Developers, Conversions API).
O Pixel da Meta é um código instalado no site que dispara eventos a partir do navegador de quem visita: página vista, formulário enviado, compra concluída. Ele só enxerga o que acontece dentro do site, no navegador, enquanto a página está aberta.
A diferença prática está em quem sabe do evento:
| Pixel da Meta | API de Conversões | |
|---|---|---|
| De onde sai o evento | navegador do visitante | servidor da empresa (site, CRM, plataforma de WhatsApp) |
| O que consegue ver | ações dentro do site | ações no site e fora dele: conversa, ligação, venda no CRM |
| Depende de a página estar aberta | sim | não |
| Precisa de desenvolvimento | pouco (código ou integração pronta) | mais (servidor, integração ou parceiro) |
| Evento típico de quem vende por conversa | formulário enviado | lead qualificado, agendamento, venda fechada |
A Meta recomenda usar os dois ao mesmo tempo: "use a API de Conversões em adição ao Pixel da Meta e compartilhe os mesmos eventos usando as duas ferramentas" (Meta, Best Practices, tradução nossa).
Por que o lead some da medição
O lead some da medição quando o evento que importa acontece num lugar que o Pixel não vê. Em empresas que vendem por conversa, isso acontece com frequência. Pontos de perda frequentes:
| Onde o lead some | O que acontece | Consequência no Meta Ads |
|---|---|---|
| Anúncio leva direto ao WhatsApp | não há página, então não há Pixel; a conversa começa no app | a campanha só conhece "conversa iniciada" |
| Venda fecha dias depois, no CRM ou na loja | o navegador do lead já não está no site | a plataforma nunca sabe qual lead comprou |
| Pixel e API mandam o mesmo evento sem identificador comum | o evento é contado duas vezes | lead e conversão inflados, CPL artificialmente baixo |
| O identificador do clique não é guardado | a conversa no WhatsApp perde o vínculo com o anúncio | o evento até chega, mas sem atribuição |
| Evento com poucos dados do cliente | a Meta não consegue ligar o evento a uma pessoa | evento recebido, mas pouco útil para otimizar |
O efeito no orçamento é direto: a campanha aprende a buscar quem gera o evento que ela recebe. Se o único evento é "conversa iniciada", ela otimiza para conversa, e não para venda. É por isso que o custo por lead sozinho engana.
Como a API de Conversões resolve cada perda
Conversa no WhatsApp: API de Conversões para Business Messaging
A API de Conversões para Business Messaging é a versão da CAPI para eventos que acontecem dentro de conversas iniciadas por anúncios de clique para Messenger, WhatsApp ou Instagram Direct (Meta, Business Messaging Onboarding Guide). Para o WhatsApp, a peça-chave é o ctwa_clid (Click-to-WhatsApp Click ID), um identificador único por clique que chega no webhook da primeira mensagem. A documentação orienta guardar esse identificador junto com a conversa e enviá-lo quando a conversão acontecer.
Os eventos aceitos nesse canal incluem, entre outros, LeadSubmitted, QualifiedLead e Purchase. Duas regras da documentação mudam o desenho da integração:
- Só vale o que acontece na conversa. Eventos de mensageria devem representar interações dentro da conversa; conversões fora dela, como uma compra no site, vão pelo produto da CAPI correspondente.
- A deduplicação é de quem integra. A Meta informa que não ajuda a deduplicar eventos da CAPI para Business Messaging.
A Meta também oferece os eventos automáticos do WhatsApp: com autorização da empresa (opt-in), a Meta analisa as conversas novas vindas de anúncios de clique para WhatsApp e avisa por webhook quando identifica um lead (LeadSubmitted) ou uma compra (Purchase). O recurso não está disponível na União Europeia, no Reino Unido e no Japão (Meta, Automatic Events API). É uma detecção automática da Meta; a empresa decide se quer ativá-la e confere se os eventos batem com o CRM.
Venda no CRM: integração com o CRM
A API de Conversões para CRM envia à Meta os estágios do lead registrados no CRM, como "qualificado" e "vendido". Esses dados alimentam a meta de desempenho Conversion Leads, que otimiza a entrega para leads com mais chance de chegar ao estágio escolhido. Pela documentação, a meta de desempenho hoje é compatível com os formulários de lead da Meta (Instant Forms) e tem critérios de entrada, como volume mínimo de leads por mês e envio de dados ao menos diário (Meta, Conversions API for CRM). Confira os critérios vigentes antes de planejar a campanha.
Evento duplicado: deduplicação
A deduplicação é o processo que faz a Meta contar uma vez só o evento que chegou pelo Pixel e pela API. Para isso, os dois precisam mandar o mesmo nome de evento (event_name) e o mesmo identificador (event_id na API, eventID no Pixel). A Meta deduplica eventos que chegam em até 48 horas do primeiro com aquele identificador, e em geral fica com o que chegou primeiro (Meta, deduplicação). A alternativa é mandar fbp e/ou external_id iguais nas duas pontas.
Evento sem dono: qualidade da correspondência
A qualidade da correspondência de eventos (Event Match Quality, ou EMQ) é uma nota de 1 a 10, no Gerenciador de Eventos, que indica o quanto os dados do cliente enviados com o evento permitem ligá-lo a uma conta da Meta. A Meta lista e-mail, telefone, nome e IP como parâmetros de alta qualidade, pede external_id em todos os eventos e exige que esses dados sejam enviados com hash quando a empresa não usa o SDK oficial (Meta, Best Practices). Pela mesma página, a EMQ hoje está disponível só para eventos de site.
Como corrigir: a ordem de implantação
Este é o roteiro que recomendamos para quem vende por conversa, do mais simples ao mais completo:
- Escreva o funil em eventos. Liste as etapas que importam (conversa iniciada, lead qualificado, agendamento, venda) e dê a cada uma um nome de evento fixo.
- Garanta a origem do lead no CRM. Cada lead precisa chegar ao CRM com a campanha de origem; nas conversas de anúncio de clique para WhatsApp, isso inclui guardar o
ctwa_clid. - Mantenha o Pixel e ligue a API em paralelo para os eventos do site, com
event_idigual nas duas pontas. - Envie do CRM os estágios que acontecem depois: qualificação e venda, com o identificador do clique ou os dados do cliente com hash.
- Confira no Gerenciador de Eventos se os eventos chegam, se a deduplicação funciona e qual é a qualidade da correspondência.
- Só então troque o objetivo da campanha para otimizar pelo evento mais fundo que tenha volume suficiente.
Com os eventos chegando, o relatório deixa de parar na conversa: dá para ler o custo por conversa iniciada e por agendamento campanha a campanha.
Mapa de exemplo: etapa do funil para evento
| Etapa | Quando dispara | Evento enviado à Meta | Por onde |
|---|---|---|---|
| Conversa iniciada pelo anúncio | primeira mensagem do cliente | nenhum (o Gerenciador de Anúncios já conta) | — |
| Lead com dados mínimos | IA ou vendedor coletou os dados mínimos | LeadSubmitted | API de Conversões para Business Messaging |
| Lead qualificado | atende ao critério escrito de qualificação | QualifiedLead | API de Conversões para Business Messaging |
| Venda | contrato ou pagamento confirmado na conversa | Purchase, com valor | API de Conversões para Business Messaging |
| Formulário enviado no site | envio do formulário | Lead | Pixel + API de Conversões, com o mesmo event_id |
| Agendamento confirmado no site | horário confirmado | Schedule | Pixel + API de Conversões, com o mesmo event_id |
As linhas de conversa são o mapeamento que a Equipe Rush Sales recomenda (a Meta não define em que etapa cada evento deve disparar). As duas linhas de site são o que o código do site da Rush dispara hoje: o formulário envia Lead e o agendamento envia Schedule, pelo Pixel e pela API de Conversões com o mesmo identificador, e o CRM recebe esse identificador junto com o lead. Os nomes de evento são os da documentação da Meta em 15/10/2026.
Confira a lista vigente de eventos antes de implantar, porque ela muda.
Erros comuns
- Ligar a API e desligar o Pixel. A recomendação oficial é usar os dois, com deduplicação.
- Mandar o mesmo evento por dois caminhos sem
event_id. O resultado é conversão em dobro e CPL que parece melhor do que é. - Tratar "conversa iniciada" como venda. O evento existe, mas otimizar só por ele traz conversa, e não cliente.
- Mandar a venda sem o vínculo com o clique. Sem
ctwa_clid,fbcou dados do cliente, o evento não volta para o anúncio que o gerou. - Mandar dados pessoais sem hash e sem base legal. Dados de cliente compartilhados com plataformas de anúncio exigem cuidado com a LGPD; avalie com o seu jurídico.
Perguntas frequentes
Preciso da API de Conversões se já tenho o Pixel?
A API de Conversões é necessária quando eventos importantes acontecem fora do navegador, como conversa no WhatsApp ou venda registrada no CRM. Para quem vende só pelo site, o Pixel cobre o básico, e a Meta ainda recomenda a API em paralelo. Para quem vende por conversa, sem a API a venda não volta ao anúncio.
A API de Conversões funciona para anúncios de clique para WhatsApp?
A API de Conversões funciona para anúncios de clique para WhatsApp pela versão Business Messaging. Ela exige guardar o ctwa_clid de cada conversa e enviar os eventos com ele. A integração costuma ser feita por um parceiro de mensageria ou pela plataforma de atendimento que a empresa já usa.
Quanto tempo depois do clique posso enviar a venda?
O tempo aceito depende do produto da API e da janela de atribuição configurada na conta. A documentação da Meta trata do tema por produto, e a regra de deduplicação, por exemplo, vale para eventos que chegam em até 48 horas. Confira a documentação vigente do canal que você usa antes de definir a rotina de envio.
Medição que chega até a venda
A API de Conversões não aumenta venda sozinha: ela devolve ao anúncio a informação de quem comprou, para que a campanha aprenda com ela. O trabalho real é ter o funil escrito em eventos e o CRM registrando cada etapa. Se você quer essa ligação montada entre anúncio, WhatsApp e CRM, conheça a integração de CRM com as plataformas de anúncio da Rush Sales.
Por Equipe Rush Sales · Publicado em 15/10/2026 · Atualizado em 15/10/2026
Fontes (acessadas em 15/10/2026)
- Meta for Developers, Conversions API
- Meta for Developers, Conversions API Best Practices
- Meta for Developers, Handling Duplicate Pixel and Conversions API Events
- Meta for Developers, Conversions API for Business Messaging: Onboarding Guide
- Meta for Developers, Automatic Events API (WhatsApp Business Platform)
- Meta for Developers, Conversions API for CRM Integration
Histórico de alterações
- 15/10/2026: publicação.
Fontes
- Meta for Developers, Conversions API (visão geral)
- Meta for Developers, Conversions API Best Practices
- Meta for Developers, Handling Duplicate Pixel and Conversions API Events
- Meta for Developers, Conversions API for Business Messaging: Onboarding Guide
- Meta for Developers, WhatsApp Business Platform: Automatic Events API
- Meta for Developers, Conversions API for CRM Integration (Conversion Leads)