API de Conversões Meta: Instalação em HTML Puro (2026)

Se você chegou até aqui, provavelmente já sabe a importância de configurar a API de Conversões do Meta (Facebook e Instagram) para turbinar suas campanhas, certo? E, vamos ser sinceros, nem sempre dá pra depender daqueles parceiros de integração “oficiais”. Às vezes, a gente precisa meter a mão na massa, especialmente quando a landing page é feita em HTML puro. Em 2026, essa ainda é uma realidade para muitos.

Visão Geral do Processo

A API de Conversões, também conhecida como CAPI, permite enviar dados diretamente do seu servidor para o Meta. Isso garante uma atribuição mais precisa, driblando as limitações do pixel (bloqueios de ad blockers, restrições de privacidade, etc.). A instalação em HTML puro pode parecer intimidadora, mas, com o passo a passo certo, você vai ver que não é nenhum bicho de sete cabeças.

Métodos de Integração

Existem algumas formas de fazer essa integração. A mais comum (e que vou te mostrar aqui) envolve o uso de JavaScript no front-end para capturar os eventos e, em seguida, enviar esses dados para o seu back-end. No back-end, você vai formatar esses dados e enviá-los para a API do Meta.

Identificação do Pixel

Primeiro, você precisa do ID do seu pixel. Encontre essa informação no Gerenciador de Eventos do Meta. Acesse facebook.com, navegue até o Gerenciador de Eventos e copie o ID do pixel que você deseja usar.

Token de Acesso

Além do ID do pixel, você vai precisar de um token de acesso. Esse token é como uma senha que autoriza o seu servidor a enviar dados para o Meta. Para gerar um token, vá nas configurações do seu pixel, procure pela seção “API de Conversões” e siga as instruções para gerar um token.

Requisitos

Antes de começar, certifique-se de que você tem o seguinte:

• Uma landing page em HTML puro.
• Acesso ao código HTML da sua landing page.
• Um servidor back-end para receber os dados e enviar para a API do Meta (pode ser em n8n, Make, PHP, Node.js, Python, etc.).
• Conhecimentos básicos de JavaScript e da linguagem do seu back-end.

Recursos

Você vai precisar da documentação da API de Conversões do Meta: https://developers.facebook.com/docs/marketing-api/conversions-api/

E, claro, de um bom editor de código para editar o HTML da sua landing page.

Passo a Passo Simplificado

1. Adicione o JavaScript na sua landing page: Cole o código que captura os eventos (visualização de página, cliques, envios de formulário, etc.) e envia para o seu back-end.
2. Crie o endpoint no seu back-end: Configure uma rota (URL) no seu servidor para receber os dados da landing page.
3. Envie os dados para a API do Meta: No seu back-end, formate os dados recebidos e envie para a API de Conversões usando o ID do pixel e o token de acesso.
4. Teste a integração: Use o Gerenciador de Eventos do Meta para verificar se os eventos estão sendo recebidos corretamente.

Exemplo prático: Capturando o evento de visualização de página

No seu HTML, adicione o seguinte código JavaScript:

 <script>
  document.addEventListener('DOMContentLoaded', function() {
   fetch('/api/conversoes', {
    method: 'POST',
    headers: {
     'Content-Type': 'application/json'
    },
    body: JSON.stringify({
     evento: 'PageView',
     url: window.location.href
    })
   });
  });
 </script>

No seu back-end (exemplo em Node.js):

const express = require('express');
const app = express();
app.use(express.json());

app.post('/api/conversoes', (req, res) => {
 const evento = req.body.evento;
 const url = req.body.url;

 // Enviar para a API do Meta (código omitido para brevidade)
 console.log(`Evento: ${evento}, URL: ${url}`);
 res.status(200).send('OK');
});

app.listen(3000, () => console.log('Servidor rodando na porta 3000'));

Lembre-se: este é um exemplo simplificado. Você precisará adaptar o código para sua realidade e adicionar tratamento de erros, validação de dados, etc.

Se precisar de ajuda para implementar a API de Conversões Meta sem parceiro de integração, entre em contato comigo: https://henriquearsego.com.br.