API de Conversões da Meta (CAPI) e Rastreamento Server-Side

A API de Conversões da Meta (Conversions API, ou CAPI) é a forma de enviar os eventos do seu negócio, como lead, compra e cadastro, direto do seu servidor ou do seu CRM para a Meta, sem depender do navegador do visitante. Ela funciona junto com o Pixel: o Pixel registra o que acontece na página e a API garante que o evento chegue mesmo quando o navegador bloqueia o Pixel ou quando a venda acontece fora do site.

Este guia explica o que a API resolve, como ela se encaixa no rastreamento server-side e no GTM server-side, como evitar evento contado duas vezes e quanto custa manter.

O que é a API de Conversões da Meta

O Pixel é um código que roda no navegador. Quando o visitante preenche um formulário, o navegador avisa a Meta. Se o navegador bloqueia o código, se a pessoa recusa os cookies ou se a página fecha antes do envio, o evento se perde.

A API de Conversões faz o mesmo aviso por outro caminho: o seu servidor (ou o sistema que recebe o lead) manda o evento para a Meta. A documentação oficial descreve a integração direta como uma conexão entre o servidor do anunciante e o endereço da API da Meta.

Por que usar a API de Conversões

• Menos evento perdido: bloqueadores de anúncio, restrições de privacidade dos navegadores e recusa de cookies cortam parte dos disparos do Pixel. O evento que vai pelo servidor não passa por esses filtros do navegador.
• Venda que acontece fora da página: em negócio local, boa parte do resultado fecha no WhatsApp, no telefone ou presencialmente. Só o servidor ou o CRM sabe que aquele lead virou cliente, e só a API leva essa informação para a Meta.
• Otimização melhor: a campanha aprende com os eventos que recebe. Com mais eventos, e eventos que representam venda de verdade, o algoritmo tem mais sinal para encontrar gente parecida com quem comprou. Ver também como reduzir o custo por lead no Meta Ads.

Pixel e API juntos: como evitar evento contado duas vezes

A Meta recomenda usar a API de Conversões junto com o Pixel, mandando o mesmo evento pelos dois caminhos. Ela chama isso de configuração redundante. Para a campanha não contar o mesmo lead duas vezes, os dois envios precisam ser reconhecidos como um só. É a desduplicação.

Pelo método recomendado na página oficial de desduplicação:

• o eventID enviado pelo Pixel precisa ser igual ao event_id enviado pela API;
• o nome do evento precisa ser o mesmo nos dois lados (por exemplo, Lead e Lead);
• quando dois eventos iguais chegam em até 48 horas, a Meta descarta o segundo.

Existe um segundo método, que usa o nome do evento com o identificador do navegador (fbp) ou um identificador seu (external_id). Se você manda pela API só eventos que o Pixel nunca envia, como a venda fechada no CRM, não há o que desduplicar.

Dados do cliente e qualidade da correspondência

Para ligar o evento a uma pessoa que viu o anúncio, a API aceita dados como e-mail e telefone. Pelas regras dos parâmetros de cliente, esses campos precisam ir criptografados com hash SHA-256, e a Meta não aceita e-mail e telefone sem hash.

O Gerenciador de Eventos mostra uma nota de qualidade da correspondência (Event Match Quality) de 1 a 10. A página de verificação diz que a Meta costuma recomendar 6,0 ou mais. Enviar e-mail, telefone, fbp e fbc quando você os tem costuma subir essa nota.

Sobre a LGPD: o hash protege o dado no envio, mas não torna o dado anônimo. O tratamento precisa de base legal e precisa estar descrito na política de privacidade do site.

Como implantar: os quatro caminhos

O que é o GTM server-side

O tagueamento do lado do servidor do Google Tag Manager cria um contêiner que roda num servidor seu, em geral num subdomínio do próprio site (por exemplo, dados.suaempresa.com.br). O site manda os eventos para esse contêiner, e é dele que saem os envios para a Meta, o Google e outras plataformas. É assim que o rastreamento server-side e a API de Conversões costumam se encontrar na prática: a tag da Meta dentro do contêiner é quem faz a chamada à API.

O contêiner pode ficar no Google Cloud ou num provedor especializado, como o Stape, que cobra conforme o volume de requisições.

Quanto custa manter

• API de Conversões: a Meta não cobra pelo envio de eventos.
• Hospedagem do GTM server-side: o guia do Google para o Cloud Run estima cerca de US$ 45 por mês por servidor e recomenda pelo menos 2 servidores em produção (consultado em novembro de 2026). Em provedores especializados, o preço depende do volume de requisições, e há plano gratuito para volume baixo em alguns deles.
• Implantação e manutenção: é a maior parte do custo. Depende de quantas plataformas recebem evento, se o CRM entra no fluxo e de quanto teste a operação exige.

Para site com pouco tráfego e lead que fecha no próprio site, a configuração pelo Gerenciador de Eventos ou a integração pronta resolvem sem custo de hospedagem.

Lead de WhatsApp e venda no CRM

Em negócio que vende pelo WhatsApp, o formulário do site é só uma parte. O evento que mais ensina a campanha é o lead que virou cliente, e essa informação está no CRM. O caminho é o CRM avisar a Meta pela API quando o lead muda de etapa, por exemplo de "novo" para "venda fechada".

Para isso funcionar, a origem do lead precisa ser guardada no primeiro contato. Explicamos como em rastreamento de leads do clique à venda e em CRM com WhatsApp.

Funciona para Google Ads e TikTok?

Cada plataforma tem o seu equivalente:

• Google Ads: as Conversões Otimizadas enviam dados do cliente com hash SHA-256 para melhorar a medição. Para venda fechada fora do site, existe a importação de conversões off-line pelo identificador do clique (gclid).
• TikTok: a Events API faz o papel da API de Conversões.

Com o GTM server-side, um único contêiner pode alimentar as três plataformas.

Como conferir se está funcionando

1. No Gerenciador de Eventos, abra o evento (por exemplo, Lead) e confira se ele chega pelo navegador e pelo servidor.
2. Veja se a desduplicação aparece. Se o número de eventos dobrou depois da implantação, o event_id não está batendo.
3. Olhe a nota de qualidade da correspondência e quais dados do cliente estão chegando.
4. Compare, numa semana, a quantidade de leads no Gerenciador com a do CRM. A diferença nunca é zero, mas uma diferença grande aponta evento perdido ou duplicado.

Erros comuns

• Mandar o mesmo evento pelo Pixel e pela API sem event_id, o que dobra os leads no relatório e confunde a otimização.
• Usar nomes diferentes para o mesmo evento nos dois lados (Lead no Pixel e lead_form na API).
• Enviar e-mail e telefone sem hash, ou com formato errado antes do hash (espaços, letras maiúsculas, telefone sem o código do país).
• Implantar e não conferir. O Gerenciador de Eventos mostra os problemas, mas alguém precisa olhar.
• Ligar a API só para eventos de página e deixar de fora a venda do CRM, que é o evento mais valioso.