O que é CAPI (API de Conversões)

CAPI é a sigla pra API de Conversões (Conversions API) do Meta: um mecanismo que permite enviar eventos de conversão pro Meta Ads diretamente do servidor, sem depender de um script (Pixel) rodando no navegador de quem converteu. O mesmo conceito existe em outras plataformas de anúncio sob outros nomes, mas CAPI especificamente se refere à API do Meta.

Por que ela existe

O Pixel do Meta é código JavaScript que roda numa página web — funciona bem em contextos onde existe navegador e página, mas perde sinal com bloqueadores de anúncio, restrições de privacidade, ou simplesmente porque o evento acontece fora de qualquer navegador. O CAPI resolve isso permitindo que o próprio backend de uma aplicação, bot ou ferramenta confirme o evento de forma mais resistente a esse tipo de perda de sinal.

CAPI e Telegram

No Telegram, a diferença é mais radical: não existe navegador nem página rodando durante a interação com o bot, então o CAPI deixa de ser um complemento do Pixel e vira o único caminho possível pra um evento (entrada no canal, saída, depósito) chegar ao Meta.

O que uma chamada de CAPI carrega

Uma chamada de evento pra CAPI inclui, no mínimo: o nome do evento (Lead, Purchase, ou personalizado), o momento em que ele aconteceu de verdade, a origem do evento, um identificador de deduplicação (event_id) e dados do usuário disponíveis, sempre hasheados em SHA-256 antes do envio.

CAPI não substitui o Pixel na maioria dos casos

Fora do Telegram, a recomendação padrão é rodar Pixel e CAPI juntos: o Pixel captura o que consegue no navegador, o CAPI reforça com o mesmo evento (ou eventos que o navegador perdeu), e os dois se deduplicam via event_id compartilhado. É só em contextos sem navegador — como a interação dentro do Telegram — que o CAPI passa a ser o único sinal possível, em vez de um reforço.

Ver o guia completo de API de Conversões pra entender a fundo como ela funciona, e o guia prático de Pixel/CAPI no Telegram pro passo a passo de implementação.