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: a entrada no canal acontece dentro do app, sem navegador nem página rodando, então o CAPI deixa de ser um complemento do Pixel e vira o único caminho possível pra esse evento chegar ao Meta. É por CAPI que a Track4you manda a entrada (enter_channel) e a saída (left_channel) pro seu pixel — e, via Integrações (planos Pro e Enterprise), também o registro, o FTD e o depósito que a plataforma devolve por postback. Junto com cada evento, a Track4you envia IP, user agent e os identificadores fbp/fbc, quando disponíveis — é o que alimenta a correspondência do evento com quem clicou no anúncio (Event Match Quality). A lista completa de eventos e onde cada um aparece no Gerenciador de Eventos está na central de ajuda da Track4you.

O que uma chamada de CAPI carrega

Uma chamada de evento pra CAPI inclui: o nome do evento (padrão, como Purchase, ou personalizado, como o enter_channel num funil de Telegram), o momento em que ele aconteceu de verdade, a origem do evento (action_source), os dados do usuário disponíveis e, quando o mesmo evento também pode sair pelo navegador, um identificador de deduplicação (event_id). Nos dados do usuário, só os identificadores pessoais (e-mail, telefone, nome) vão hasheados em SHA-256; IP, user agent e os cookies fbp/fbc vão sem hash.

CAPI não substitui o Pixel na maioria dos casos

Num site comum (loja, landing page com checkout), 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 pelo mesmo nome de evento com o mesmo event_id. É só em contextos sem navegador — como a entrada no canal do Telegram — que o CAPI passa a ser o único sinal possível, em vez de um reforço.

Na página do funil da Track4you, a recomendação é outra: não instalar o seu próprio Pixel ali. O script da Track4you já manda ViewContent (visita) e Lead (clique no botão) pro pixel escolhido no funil, e a entrada e a saída do canal vão por CAPI. Se você instalar o seu Pixel mesmo assim, a Meta deduplica automaticamente.

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.