← Todos os artigos

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:

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:

  1. 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.
  2. 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.
  3. 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:

  1. 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.
  2. Ela envia um formulário. Seu site, CRM ou integração salva os dados de contato junto com esse identificador de clique.
  3. 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.
  4. 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 funcionaNo navegador do visitanteNo seu servidor, CRM ou integração
Bloqueado por bloqueadores de anúnciosCom frequênciaNão
Vê vendas offline e etapas do CRMNãoSim
Vê o comportamento na página (visualizações, rolagem, carrinho)SimSó o que você enviar
ConfiguraçãoColar um trecho de códigoCó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

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

  1. No Gerenciador de Eventos → Testar eventos, envie um evento de teste e confirme que ele chega com a origem "Servidor".
  2. 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.
  3. Acompanhe a qualidade da correspondência de eventos. Se estiver baixa, provavelmente faltam e-mail, telefone ou identificadores de clique.
  4. 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.