O que é a API de Conversões da Meta (CAPI)? Guia direto para anunciantes
Se você anuncia na Meta, com certeza alguém já disse para você "configurar a CAPI". Geralmente logo depois de você reclamar que o Gerenciador de Anúncios mostra 12 compras e a sua loja registrou 31.
O conselho está certo. Mas quase tudo o que se escreve sobre a API de Conversões é feito para desenvolvedores, ou por quem quer vender alguma coisa sem explicar nada. Este guia é para anunciantes e donos de negócio que querem entender o que ela faz antes de mexer em qualquer coisa.
A API de Conversões em um parágrafo
A API de Conversões da Meta (Conversions API ou CAPI) é uma forma de enviar eventos de conversão — leads, cadastros, compras — para a Meta a partir do seu servidor, CRM ou backend, em vez do navegador do visitante. O Pixel da Meta observa o que acontece numa página. A API de Conversões informa o que acontece no seu negócio. Quando os dois funcionam juntos, a Meta tem uma visão mais completa e confiável de quem converteu depois de ver seus anúncios, e usa essa visão para decidir para quem mostrar os anúncios em seguida.
Por que só o pixel não basta mais
O pixel é um trecho de JavaScript. Ele só funciona se carregar, rodar e tiver permissão para enviar dados. Hoje, muita coisa atrapalha:
- Bloqueadores de anúncios e navegadores com foco em privacidade bloqueiam diretamente as requisições para os domínios do Facebook.
- As restrições de rastreamento do iOS e a vida mais curta dos cookies no Safari quebram a ligação entre o clique no anúncio e uma conversão que acontece alguns dias depois.
- Muitas vezes a conversão nem acontece no site. A pessoa preenche um formulário e o seu vendedor fecha a venda pelo WhatsApp ou por telefone uma semana depois. O pixel nunca vê essa venda.
- Páginas lentas e saídas rápidas. Se a pessoa fecha a página de obrigado antes de o pixel disparar, o evento se perde.
Os dois últimos pontos são os mais subestimados. Em negócios de geração de leads — clínicas, imobiliárias, educação, turismo, serviços B2B — o evento que importa (uma venda paga) está no CRM, não numa página da web. O pixel simplesmente não consegue informá-lo. A API de Conversões consegue.
O que a API de Conversões da Meta pretende resolver
A Meta descreve o objetivo como uma conexão mais confiável entre os dados de marketing e os resultados dos anúncios. Na prática, são três coisas:
- Mensuração melhor. Mais conversões reais aparecem no Gerenciador de Anúncios, então o seu custo por resultado fica mais próximo da realidade.
- Otimização melhor. O sistema de entrega da Meta aprende com as conversões. Se ele só vê metade delas, aprende com uma amostra distorcida. Quando você envia vendas reais — e não só formulários preenchidos — ele aprende a encontrar pessoas que de fato compram.
- Menos dependência do navegador. Seus dados deixam de se perder toda vez que um navegador muda as regras.
Como funciona, passo a passo
Veja como funciona uma configuração típica de geração de leads:
- A pessoa clica no seu anúncio. A Meta adiciona um identificador de clique (
fbclid) à URL da página de destino, e o pixel o guarda no cookie_fbc. - Ela envia um formulário. Seu site, CRM ou integração salva os dados de contato junto com esse identificador de clique.
- Quando algo importante acontece — o lead é criado, qualificado ou paga — o seu servidor envia um evento para a Meta: o nome do evento, o horário e dados do cliente, como e-mail e telefone.
- Os dados pessoais passam por hash (SHA-256) antes de saírem do seu servidor. A Meta compara esses hashes com os usuários dela e atribui a conversão ao anúncio que a pessoa viu.
A Meta chama de qualidade da correspondência de eventos (Event Match Quality, EMQ) o quanto ela consegue ligar seus eventos a pessoas reais. A nota vai de 0 a 10 no Gerenciador de Eventos. Só os eventos correspondidos são usados para atribuição e otimização dos anúncios; os demais contam apenas para a mensuração básica. Quanto mais identificadores você envia — e-mail, telefone, nome, endereço IP, user agent, fbc, fbp, external_id — maior costuma ser a nota.
API de Conversões vs Pixel da Meta: preciso dos dois?
Sim, na maioria dos casos. Eles não competem. A Meta recomenda usar os dois juntos, e o motivo é simples: cada um enxerga coisas que o outro não enxerga.
| Pixel da Meta | API de Conversões | |
|---|---|---|
| Onde funciona | No navegador do visitante | No seu servidor, CRM ou integração |
| Bloqueado por bloqueadores de anúncios | Com frequência | Não |
| Vê vendas offline e etapas do CRM | Não | Sim |
| Vê o comportamento na página (visualizações, rolagem, carrinho) | Sim | Só o que você enviar |
| Configuração | Colar um trecho de código | Código no servidor, um gateway ou uma integração pronta |
Quando o mesmo evento chega pelos dois caminhos, a Meta precisa saber que é um só, e não dois. Isso é a desduplicação: as duas cópias precisam ter o mesmo event_name e o mesmo event_id (ou external_id e fbp iguais). Se isso der errado, suas compras aparecem em dobro no Gerenciador de Anúncios — um erro muito comum em configurações feitas por conta própria. Vamos detalhar isso num artigo separado sobre API de Conversões vs Pixel.
Limites que vale conhecer antes de começar
- A regra dos 7 dias. O
event_timede um evento pode ter no máximo 7 dias no momento do envio. Se um único evento do lote for mais antigo, a Meta rejeita a requisição inteira. Isso pesa se você quer informar vendas que fecham semanas depois da chegada do lead: é preciso enviá-las assim que a etapa muda, e não numa exportação mensal. - Vendas em loja física devem ser enviadas em até 62 dias após a conversão, mas cada evento ainda precisa respeitar o limite de 7 dias do
event_timena hora do envio. - O hash é obrigatório para dados pessoais. E-mails e telefones em texto puro não devem sair do seu servidor.
- Envie perto do tempo real. A Meta recomenda envio em tempo real ou em lotes próximos disso. Lotes de um dia funcionam, mas a otimização reage mais rápido a dados recentes.
- CAPI não é só para sites. Os eventos podem vir de um site, ligação, chat, loja física, e-mail ou mensagens comerciais — o campo
action_sourcediz à Meta onde a conversão aconteceu.
Três formas de configurar a API de Conversões
1. Integração direta (com desenvolvedor)
Seu desenvolvedor escreve o código que chama o endpoint da API de Conversões, cuida do hash, das novas tentativas e da desduplicação, e guarda com segurança um token de acesso de usuário do sistema. Máxima flexibilidade, mas é trabalho de engenharia de verdade — e alguém precisa manter tudo funcionando quando a Meta muda a versão da API.
2. Conversions API Gateway
A opção self-service da própria Meta. Você sobe um gateway na sua própria conta de nuvem (AWS ou Google Cloud), aponta o pixel para ele, e ele replica os eventos do navegador no lado do servidor. A Meta não cobra licença, mas você paga os recursos da nuvem. O detalhe: ele foi pensado para eventos do site. Ele não sabe quando uma venda fecha no seu CRM.
3. Uma integração pronta
Plataformas como a Shopify já trazem CAPI para e-commerce. Para quem trabalha com leads, a lacuna sempre foi o CRM: a venda acontece no HubSpot, Pipedrive, Kommo, Bitrix24 ou numa planilha do Google, e nada envia isso para a Meta.
Foi para essa lacuna que o LeadMe foi criado. Você conecta o seu pixel da Meta e a sua fonte — um CRM, um formulário, uma planilha —, escolhe quais etapas do funil viram quais eventos (Lead, Lead qualificado, Compra) e o LeadMe envia tudo pela API de Conversões, com hash, desduplicação e identificadores de clique resolvidos automaticamente. Sem servidor para contratar e sem código. Também funciona com TikTok, Google Ads e outras plataformas, então os mesmos dados do CRM podem alimentar todos os canais em que você anuncia.
Como saber se está funcionando
- No Gerenciador de Eventos → Testar eventos, envie um evento de teste e confirme que ele chega com a origem "Servidor".
- Confira a aba Visão geral um dia depois: você deve ver eventos recebidos tanto do navegador quanto do servidor, com a desduplicação indicada nos que se repetem.
- Acompanhe a qualidade da correspondência de eventos. Se estiver baixa, provavelmente faltam e-mail, telefone ou identificadores de clique.
- Compare o Gerenciador de Anúncios com o seu CRM por uma ou duas semanas. Os números nunca batem perfeitamente, mas a diferença deve cair de forma visível.
Respostas rápidas para dúvidas comuns
A API de Conversões é gratuita?
A Meta não cobra pela API em si. Você paga pelo que a faz funcionar: horas de desenvolvimento, a hospedagem em nuvem do Gateway ou a assinatura de uma integração.
É a mesma coisa que a "API de Conversões do Facebook"?
Sim. É o mesmo produto; a plataforma de anúncios do Facebook agora se chama Meta. Você vai ver "CAPI", "Facebook CAPI" e "API de Conversões da Meta" usados como sinônimos.
Preciso dela se só recebo leads e não vendo online?
Negócios de leads provavelmente precisam ainda mais. Sem ela, a Meta otimiza para formulários preenchidos — inclusive números falsos e pessoas que nunca atendem o telefone. Com as etapas do CRM enviadas pela CAPI, ela pode otimizar para leads que viram clientes pagantes.
Ela vai atrapalhar o pixel que já tenho?
Não. A CAPI funciona junto com o pixel. A única coisa que precisa estar certa é a desduplicação, para que a mesma compra não seja contada duas vezes.
Próximo artigo da série: Conversions API Gateway — quanto custa de verdade e quando não é a melhor escolha.