Voltar

API de Conversões da Meta explicada em língua de dono

A API de Conversões da Meta, ou CAPI, é o canal direto entre o seu sistema e a Meta: em vez de depender do navegador do visitante para avisar que uma conversão aconteceu, o seu servidor, o seu CRM ou a sua ferramenta de atribuição enviam o evento diretamente, de máquina para máquina. Ela existe porque o pixel, que faz esse aviso pelo navegador, perde cada vez mais sinal: bloqueadores de anúncio, as restrições de privacidade do iPhone e o sumiço progressivo dos cookies fazem parte das conversões nunca chegar à Meta.

E o efeito de fechar esse buraco é medido pela própria plataforma: segundo dado publicado pela Meta em abril de 2026, anunciantes usando a API de Conversões em eventos de site tiveram custo por resultado em média 17,8% menor. Este guia explica o que a CAPI é, o que ela envia, como convive com o pixel e os caminhos para implementar, do mais simples ao mais técnico.

Pixel e CAPI: o carteiro e a linha direta

O pixel é um carteiro que mora no navegador do visitante: quando alguém converte, ele sai correndo para avisar a Meta. O problema é que esse carteiro depende do navegador cooperar, e o navegador de 2026 coopera cada vez menos, porque o visitante usa bloqueador, porque o iPhone pergunta se ele quer ser rastreado, porque o cookie que identificava a visita expira em dias. A CAPI é a linha direta: o aviso sai do seu lado, do servidor do site ou do seu CRM, e chega inteiro, sem depender do que acontece na máquina do visitante.

A comparação honesta: o pixel continua necessário e não vai ser aposentado, porque ele captura o comportamento na página em tempo real. O desenho recomendado pela Meta é os dois juntos, cada um cobrindo a fraqueza do outro.

O que a CAPI envia, e o envio que quase ninguém faz

O uso mais comum é reenviar pelo servidor os mesmos eventos do site, compra e lead, para recuperar o que o navegador perde. É útil e já paga a implementação. Mas o envio mais valioso é outro, e é o que a maioria das empresas nunca configura: os eventos que o site nem tem como ver, porque acontecem depois, no seu CRM. O lead que virou oportunidade qualificada. A proposta que virou contrato assinado, com valor. Quando esses eventos voltam pela CAPI, o algoritmo da Meta para de otimizar por quem preenche formulário e passa a otimizar por quem compra, que é a tese que atravessa este blog desde o guia de como saber qual campanha gerou venda.

Esse envio ficou ainda mais importante em 2026, depois que a Meta mudou a régua de atribuição duas vezes e derrubou o número reportado de muita conta sem a performance real ter mudado, história que contamos no post sobre a mudança de atribuição da Meta. Quando a régua da plataforma muda por decreto, o dado que continua de pé é o seu.

Os dois contando o mesmo evento: a deduplicação

A pergunta óbvia de quem roda pixel e CAPI juntos: a Meta não vai contar a mesma venda duas vezes? Não, desde que a implementação marque cada evento com um identificador único, o event_id, enviado igual pelos dois caminhos. A Meta recebe as duas cópias, reconhece que são o mesmo evento e descarta a repetição. É um detalhe técnico, mas é o detalhe que separa implementação boa de relatório inflado, então vale a pergunta direta para quem for implementar: “a deduplicação por event_id está configurada?”.

Outro termo que aparece no painel e assusta à toa é a qualidade de correspondência do evento (event match quality): uma nota que a Meta dá para o quanto os dados enviados em cada evento, como e-mail e telefone com hash, permitem casar aquele evento com uma pessoa real. Nota baixa não é multa, é diagnóstico: significa que os eventos estão chegando com pouca informação de correspondência, e que parte deles não está sendo aproveitada.

Os caminhos para implementar

CaminhoPara quemEsforço
Integração de parceiroQuem usa plataforma que já tem CAPI embutida (lojas, CRMs, ferramentas de atribuição)Baixo: ativar e conectar por login
Gateway da MetaQuem quer o caminho intermediário hospedado, sem construir servidor próprioMédio: configuração guiada no gerenciador
Implementação própria (API direta ou GTM server-side)Quem tem time técnico e quer controle total sobre cada eventoAlto: projeto de desenvolvimento

Para o dono de PME, a leitura prática: se a sua operação de venda vive no CRM, o caminho de menor atrito é uma ferramenta que já fale com o seu CRM e com a CAPI ao mesmo tempo. No ROI Reveal, por exemplo, a venda marcada como ganha no RD Station ou no HubSpot (a integração com o Salesforce está em desenvolvimento) vira evento de CAPI enviado sozinho, com deduplicação e hash cuidados pela ferramenta. Quem prefere construir por conta própria encontra na documentação da Meta o caminho completo, e este guia continua valendo como mapa do que exigir da implementação.

E os dados dos meus clientes?

O mesmo princípio dos outros guias desta série: os dados pessoais usados para correspondência, como e-mail e telefone, são transformados em código irreversível (hash SHA-256) antes de sair do seu lado, e a Meta só os usa para casar o evento com um usuário que ela já conhece. Do lado da LGPD, valem base legal, transparência na política de privacidade e respeito ao descadastro. Implementação oficial não é o risco; improviso é.

Perguntas frequentes

A CAPI substitui o pixel?

Não, os dois trabalham juntos. O pixel captura o comportamento no navegador em tempo real, a CAPI garante que os eventos cheguem mesmo quando o navegador falha, e a deduplicação por event_id impede contagem dupla.

Preciso de programador para ter CAPI?

Depende do caminho. Integrações de parceiro e ferramentas de atribuição ativam por login, sem código; o gateway da Meta pede configuração guiada; a implementação própria é projeto de desenvolvimento. O que não muda em nenhum caminho é a pergunta de controle: deduplicação configurada e dados com hash.

O que é a qualidade de correspondência do evento?

É a nota que a Meta dá para o quanto cada evento enviado traz dados suficientes, como e-mail e telefone com hash, para ser ligado a uma pessoa. Nota baixa indica eventos chegando com pouca informação, e melhora enviando mais campos de correspondência corretamente formatados.

Funciona para leads que chegam pelo WhatsApp?

Funciona quando a venda ligada àquele lead é registrada no CRM com os dados de contato e o identificador de origem. O rastreamento do caminho anúncio até conversa tem particularidades próprias, que tratamos no guia de vendas pelo WhatsApp.

Quanto custa usar a API de Conversões?

A API em si é gratuita, oferecida pela Meta. O custo real é de implementação e manutenção: horas de desenvolvimento no caminho próprio, ou a assinatura de uma ferramenta que faça isso pronta.


Seus anúncios da Meta ainda aprendem só com o formulário? O ROI Reveal envia suas vendas do CRM pela API de Conversões e devolve ao algoritmo o sinal de quem compra. Criar minha conta grátis. Sem código, configuração em 5 minutos, cancele quando quiser.