Daniel Digital
← Todos os posts

API de Conversões da Meta: o que é e como configurar (2026)

Site enviando o mesmo evento de lead para a Meta pelo pixel no navegador e pela API de Conversões no servidor

A API de Conversões da Meta (Conversions API, ou CAPI) envia os eventos do seu site, como leads e compras, para a Meta a partir de um servidor, e não do navegador do visitante. A Meta recomenda usar a API junto com o pixel, mandando o mesmo evento pelos dois caminhos com o mesmo ID, para que cada conversão conte uma vez só. Dá para configurar pela integração da sua plataforma (Shopify, Nuvemshop, WordPress), pelo Gateway da API de Conversões, pelo Google Tag Manager do lado do servidor ou por uma integração direta feita por um desenvolvedor.

Não sabe se os seus anúncios no Facebook e no Instagram estão contando cada lead, e uma vez só? Eu configuro e audito o pixel da Meta e a API de Conversões junto com o Google Ads, o GA4 e o seu CRM. Conheça o serviço de rastreamento de conversões.

Pixel da Meta x API de Conversões

O pixel da Meta é um script que roda no navegador do visitante. Quando alguém envia um formulário ou compra, o navegador manda o evento para a Meta. É rápido de instalar, mas depende do navegador: bloqueadores de anúncios, recursos de privacidade, página lenta e visitante que fecha a aba antes da hora custam eventos.

A API de Conversões manda o evento de um servidor: o back-end do site, a plataforma da loja, o CRM ou um servidor de tags. O navegador não consegue bloquear esse envio, e você decide exatamente quais dados vão junto.

Pixel da MetaAPI de Conversões
Onde rodaNo navegador do visitanteNum servidor seu ou de um parceiro
Afetado por bloqueadores e privacidade do navegadorSimNão (mas o consentimento continua valendo)
Envia eventos que acontecem fora do siteNãoSim, como uma etapa do CRM ou uma venda na loja física
Esforço de configuraçãoBaixoDe baixo a alto, conforme o método
Dados para correspondênciaCookies e o que o navegador temE-mail e telefone em hash, IP, user agent, fbp, fbc e outros

A recomendação da própria Meta é uma configuração redundante: manter o pixel e enviar os mesmos eventos também pela API de Conversões. O pixel contribui com sinais do navegador que o servidor não vê sozinho, e a API cobre os buracos que o navegador deixa.

Uma observação de nomes: o que a Meta mostra no Gerenciador de Eventos como conjunto de dados é o “recipiente” dos eventos do pixel e do servidor. O ID do conjunto de dados é o mesmo número do seu pixel. E o antigo Gerenciador de Negócios (Business Manager) agora é o portfólio empresarial, administrado no Meta Business Suite.

Por que a desduplicação não é opcional

Se o pixel e o servidor mandam “Lead” para o mesmo envio de formulário e a Meta não consegue saber que é o mesmo lead, você ganha dois leads no Gerenciador de Anúncios. O custo por lead cai pela metade no papel, e o algoritmo passa a otimizar para um número que não existe.

Um formulário gera um ID de evento único; o pixel da Meta envia o evento Lead com eventID lead-8841 e a API de Conversões envia event_name Lead com event_id lead-8841; a Meta compara nome e ID em até 48 horas e mantém um só; com IDs diferentes ou sem ID, o lead conta duas vezes

O método que a Meta recomenda, segundo a documentação dela:

  • Gere um ID único por evento no site (o número do pedido, ou um ID aleatório criado no momento do envio do formulário).
  • Envie esse ID como eventID no evento do pixel e como event_id no evento do servidor.
  • Use o mesmo nome de evento nos dois: Lead e Lead, não Lead e lead_enviado.

A Meta só desduplica eventos iguais recebidos em até 48 horas depois do primeiro com aquele ID, e em geral fica com o que chegou primeiro. Existe um plano B, que compara o event_name com o fbp ou o external_id, mas a própria Meta diz que ele normalmente só funciona quando o evento do navegador chega antes do evento do servidor. Trate como reserva, não como plano.

As formas de configurar em 2026

Todos os caminhos abaixo terminam no mesmo lugar: eventos no Gerenciador de Eventos, dentro do seu conjunto de dados. A escolha depende da plataforma do site e de quanto controle você precisa.

1. Integração da sua plataforma (Shopify, Nuvemshop, WordPress e outras)

Se o site roda numa plataforma com integração oficial com a Meta, esse costuma ser o melhor primeiro passo, porque a plataforma já sabe qual é o pedido, quem é o cliente e qual ID usar.

  • Shopify: o app de canal de vendas Facebook e Instagram. Nas configurações de compartilhamento de dados do app, o nível Máximo usa a API de Conversões junto com o pixel.
  • Nuvemshop: a integração do canal de vendas Facebook/Instagram instala o pixel e a API de Conversões juntos; a central de ajuda da Nuvemshop tem o passo a passo e recomenda não criar eventos manuais em paralelo.
  • WordPress e WooCommerce: o plugin oficial da Meta para WordPress inclui suporte à API de Conversões e se conecta pela Facebook Business Extension.
  • RD Station Marketing: tem uma integração nativa que envia para a Meta, pela API de Conversões, os eventos de venda marcados nos leads. Ela não substitui o pixel do site: complementa com o que aconteceu depois do formulário.
  • Tray, Wix, HubSpot e outras plataformas costumam ter integrações próprias. Leia a documentação de cada uma, porque algumas mandam só compras, e não leads.

A armadilha: a integração da plataforma mais um pixel que alguém colocou pelo Google Tag Manager é a contagem dupla clássica. Escolha uma fonte por evento.

2. Configuração feita pela própria Meta

Em 2026 a Meta passou a oferecer uma configuração da API de Conversões para sites em poucos cliques, operada por ela mesma, sem servidor e sem código, voltada a quem não tem equipe técnica ou tem poucos eventos chegando pelo servidor. É o jeito mais rápido de começar, com o menor controle sobre o que é enviado. Se você já usa uma integração de parceiro ou uma configuração própria, nada muda.

3. Gateway da API de Conversões

O Gateway da API de Conversões é a opção da Meta que roda na sua própria conta de nuvem: um pequeno servidor que repassa automaticamente os eventos do pixel para a API de Conversões, sem código. A configuração começa no Gerenciador de Eventos, na guia Configurações do conjunto de dados, e leva você ao provedor de nuvem (a Meta usa a AWS) para criar a estrutura. Alguns provedores de hospedagem oferecem o Gateway como serviço gerenciado.

Você paga a hospedagem ao provedor de nuvem. E como o Gateway espelha o que o pixel vê, ele melhora a confiabilidade, mas não consegue enviar eventos que nunca acontecem no navegador, como uma venda fechada no CRM.

4. Google Tag Manager do lado do servidor

Se você já usa (ou pretende usar) um contêiner do Tag Manager do lado do servidor, a Meta documenta uma tag da API de Conversões para ele, instalada pela galeria de modelos do contêiner de servidor. O site manda os eventos uma vez para o seu servidor de tags, e o servidor repassa para a Meta, o GA4 e o Google Ads. É a opção com mais controle sobre o que é enviado e permite acrescentar dados do servidor, com o custo de manter um servidor de tags. Se o seu GA4 ainda não está organizado no Tag Manager, comece por como instalar o GA4 com o Google Tag Manager.

5. Integração direta

O desenvolvedor chama a API de Conversões a partir do back-end do site, usando o ID do conjunto de dados e um token de acesso gerado no Gerenciador de Eventos, nas configurações do conjunto de dados. É a escolha certa para sites e sistemas feitos sob medida e para enviar eventos que acontecem depois do site, como um lead marcado como qualificado no CRM. Também é a que precisa de manutenção quando a Meta muda as versões da API.

A Meta também tem uma versão da API de Conversões para mensagens comerciais (WhatsApp e Messenger), para quem anuncia com clique para conversa. É outro assunto, com configuração própria, e fica para outro post.

Qualidade da correspondência do evento e dados do cliente

Cada evento do servidor precisa ser associado a uma conta da Meta para ser útil. A Meta mostra como isso está indo com a qualidade da correspondência do evento (Event Match Quality, ou EMQ), uma nota de 0 a 10 para cada evento, no Gerenciador de Eventos. Quanto maior, melhor, e a própria tela lista quais parâmetros você poderia acrescentar para subir a nota. A Meta não publica uma nota mínima única; siga as sugestões que aparecem para cada evento.

Os parâmetros de informação do cliente que mais pesam em eventos de site:

ParâmetroO que éHash?
emE-mailSim, SHA-256
phTelefone, só dígitos e com código do paísSim, SHA-256
fn, lnNome e sobrenomeSim
ct, st, zp, countryCidade, estado, CEP, paísSim
external_idO ID do cliente ou do lead no seu sistemaRecomendado
client_ip_addressIP do visitanteNunca
client_user_agentNavegador do visitanteNão (obrigatório em eventos de site)
fbpCookie de navegador da Meta (_fbp)Não
fbcCookie de clique da Meta (_fbc, vem do fbclid)Não

Normalize antes de gerar o hash. O e-mail vai sem espaços e em minúsculas. O telefone fica só com dígitos e com o código do país: um celular de Belo Horizonte, (31) 99999-1234, vira 5531999991234. O país vai como código de duas letras em minúsculas (br), mesmo que todos os seus clientes sejam brasileiros. Integrações de parceiros e o Gateway fazem isso por você; numa integração direta ou no Tag Manager do lado do servidor, é aqui que acontece a maioria dos erros.

Consentimento e LGPD

O servidor não é um jeito de passar por cima do banner de cookies. Se o seu site pede consentimento e o visitante recusa os cookies de publicidade, o envio pelo servidor deve respeitar essa escolha da mesma forma que o pixel. Do lado do pixel, a Meta tem um comando de consentimento (fbq('consent', 'revoke') e fbq('consent', 'grant')) que os templates de CMP costumam usar.

No Brasil, quem define o que você pode enviar é a LGPD: base legal, transparência na política de privacidade e os direitos do titular. Mandar e-mail e telefone em hash para a Meta continua sendo tratamento de dados pessoais. Se e como fazer isso no seu caso é uma decisão para tomar com um advogado; este post não é aconselhamento jurídico. O que eu faço do lado técnico é garantir que o envio siga a mesma regra de consentimento do resto do site, e que a política de privacidade diga que os dados são compartilhados com plataformas de anúncios. O lado Google da mesma questão está no post sobre modo de consentimento v2 e LGPD.

Como testar no Gerenciador de Eventos

  1. No Gerenciador de Eventos, abra o seu conjunto de dados e clique em Testar eventos.
  2. Para eventos do servidor, copie o código de teste e envie junto com os eventos (o parâmetro test_event_code, ou o campo de teste no plugin ou na tag do Tag Manager). Para eventos do navegador, digite o endereço do site e abra por ali.
  3. Faça uma conversão real no site: envie o formulário com um e-mail seu.
  4. Confira se o evento aparece pelo navegador e pelo servidor, e se a Meta marca o par como desduplicado.
  5. Tire o código de teste quando terminar, para os eventos reais não serem tratados como teste.

Depois de um ou dois dias de tráfego real, volte à Visão geral do conjunto de dados: a qualidade da correspondência de cada evento, a parte dos eventos que chega pelo servidor e os diagnósticos que a Meta apontar.

Erros comuns que eu vejo

  1. Sem desduplicação. O pixel e o servidor mandam o mesmo lead sem o mesmo ID de evento, ou com nomes de evento diferentes. Os leads dobram da noite para o dia e todo mundo comemora por uma semana.
  2. Duas integrações enviando o mesmo evento. A integração da Shopify ou da Nuvemshop, mais um pixel colocado à mão, mais uma tag no servidor. Uma fonte por evento.
  3. Sem fbp e fbc. O evento do servidor sai sem os cookies de navegador e de clique da Meta, não dá para ligar ao clique no anúncio e a qualidade da correspondência fica baixa. Leia os dois cookies no envio do formulário e mande junto com o lead.
  4. Hash no que não deve ter hash (o IP) ou hash sem normalizar (e-mail com maiúsculas, telefone sem o 55 do Brasil).
  5. Ignorar o consentimento. O servidor mandando tudo enquanto o banner diz que o visitante recusou. Além do problema com a LGPD, é o tipo de inconsistência que aparece numa auditoria.
  6. Portfólio empresarial errado. O conjunto de dados, a conta de anúncios e o token de acesso precisam estar no mesmo portfólio empresarial, ou o parceiro precisa ter acesso a ele.
  7. Mandar só compras. Para geração de leads, os eventos que importam são Lead e o que acontece depois no CRM. O servidor é exatamente onde você manda de volta “qualificado” ou “fechado”. O Google Ads aceita a mesma ideia com a importação de conversões off-line.

Se você anuncia nas duas plataformas, vale montar o rastreamento do Google e o da Meta a partir do mesmo evento de sucesso do formulário. Eu mostro a parte do Google no guia completo de rastreamento de conversões no Google Ads.

Perguntas frequentes

Preciso continuar com o pixel da Meta se usar a API de Conversões?

A Meta recomenda manter os dois, mandando os mesmos eventos por cada um com um ID de evento em comum para a desduplicação. O pixel traz sinais do navegador; o servidor deixa o envio confiável.

A API de Conversões da Meta é paga?

A API em si é gratuita. A configuração feita pela Meta e a maioria das integrações de plataforma não custam nada a mais. O Gateway e o Tag Manager do lado do servidor rodam em servidores que você paga, e uma integração direta custa horas de desenvolvimento.

Qual é uma boa nota de qualidade da correspondência do evento?

A Meta dá a nota de 0 a 10 e não publica um alvo único. Siga os parâmetros que o Gerenciador de Eventos sugere para cada evento; enviar e-mail e telefone em hash, fbp, fbc, IP e user agent cobre quase tudo o que ele pede.

Por que os meus leads da Meta estão contando em dobro?

Quase sempre é falta de desduplicação: o pixel e o servidor mandam o mesmo evento sem o mesmo event_id, ou com nomes de evento diferentes, ou duas integrações mandam o mesmo evento.

A API de Conversões manda eventos do CRM, como lead qualificado?

Manda. Com uma integração direta ou um CRM que se integra com a Meta (o RD Station Marketing, por exemplo, envia vendas), você manda etapas posteriores a partir do servidor, o que ajuda a Meta a otimizar pela qualidade do lead, e não só pelo formulário preenchido.

Precisa de ajuda com a API de Conversões?

Eu configuro o pixel da Meta e a API de Conversões com desduplicação correta, ligo ao seu formulário, ao WhatsApp e ao CRM, e testo no Gerenciador de Eventos antes de você confiar nos números, junto com o rastreamento do Google Ads e do GA4. Veja o meu serviço de rastreamento de conversões.

Daniel Timponi

Sou analista e consultor de marketing digital. Trabalho com Google Ads há mais de 17 anos e com SEO. Também sou responsável pelas campanhas de várias empresas no Facebook e no Instagram. Quando não estou atendendo clientes, dedico parte do meu tempo compartilhando meu conhecimento para ajudar empreendedores.

Fale comigo