Tutorial · CAPI

Como configurar a Meta Conversions API Gateway

Passo a passo completo para conectar a API de Conversões do Meta ao seu pixel — sem escrever uma linha de código. Da criação da conta no Stape à validação de eventos em produção.

10 min de leitura Atualizado em 23 mai 2026 Fonte: stape.io

01 O que é a Meta Conversions API Gateway

Adaptado de conteúdo original em inglês Este artigo é uma tradução e adaptação do tutorial publicado pelo Stape em https://stape.io/blog/how-to-set-up-meta-conversions-api-gateway. Imagens reproduzidas com fins educativos — todos os direitos pertencem ao Stape.io.

A Meta Conversions API Gateway (CAPIG) é uma solução no-code que simplifica radicalmente a implementação da API de Conversões do Meta. Em vez de integrar a CAPI diretamente ao seu servidor ou plataforma — o que exige desenvolvimento backend —, a Gateway cria uma camada intermediária gerenciada pelo Stape.

Você conecta o pixel, e os eventos passam a ser enviados via servidor automaticamente. A deduplicação com o pixel do navegador é configurada sem escrever uma única linha de código. O resultado: cobertura de rastreamento próxima de 100%, mesmo com ad blockers e restrições do iOS 14+.

CAPI Gateway vs. integração manual

A integração manual da CAPI exige um endpoint de servidor próprio, autenticação com token de acesso do Meta e lógica de deduplicação implementada pelo desenvolvedor. A CAPI Gateway elimina todas essas etapas — você configura em menos de 1 hora, sem código.

Nas seções a seguir, detalhamos cada passo do processo de configuração, do zero ao primeiro evento validado em produção.

02 Passo 1: Criar conta no Stape

Para novos usuários

Acesse a página de cadastro do Stape e preencha:

  1. E-mail
  2. Nome da sua Conversions API Gateway
  3. Localização do servidor (Estados Unidos, Europa, América do Sul, Ásia-Pacífico ou Ásia Nordeste)

Clique em Create para prosseguir.

Criação de conta nova no Stape — registro e escolha da localização do servidor
Imagem: Criação de conta nova no Stape — registro e escolha da localização do servidor — Fonte: stape.io

Para usuários com conta existente no Stape

  1. Faça login no Stape
  2. Clique em FB CAPI Gateways no menu principal
  3. Clique em Create CAPIG
  4. Preencha o nome da Gateway e o e-mail
  5. Selecione a localização do servidor
Criação de nova Gateway em conta Stape já existente
Imagem: Criação de nova Gateway em conta Stape já existente — Fonte: stape.io

03 Passo 2: Escolher o plano de assinatura

O Stape oferece dois planos para a CAPI Gateway:

  • Pay as you go — $10/mês por pixel: até 10 milhões de eventos por mês. Ideal para quem tem 1–3 pixels ativos.
  • Unlimited — $100/mês para 100 pixels: até 200 milhões de eventos. Ideal para agências ou quem opera múltiplos pixels simultaneamente.

Os dois planos incluem 7 dias de teste gratuito — sem necessidade de cartão de crédito para ativar o trial.

Qual plano escolher?

Para a maioria dos infoprodutores com 1–3 pixels ativos, o plano pay-as-you-go de $10/mês é suficiente. Um lançamento com 500.000 eventos por mês fica bem dentro do limite de 10 milhões. O plano Unlimited só se justifica quando você gerencia 10+ pixels ou tem volume acima de 10M de eventos mensais.

04 Passo 3: Finalizar o cadastro

Para concluir o setup inicial, três etapas são necessárias:

  1. Adicionar dados de cobrança — cartão de crédito ou PayPal
  2. Verificar o e-mail de convite — o Stape envia um convite para criar sua conta no hub da CAPIG; verifique a caixa de entrada (e o spam)
  3. Criar a senha do hub — acesse o link do convite e defina e-mail + senha para login no painel da Gateway
Etapas de finalização do cadastro: cobrança, e-mail de convite e criação de conta no hub
Imagem: Etapas de finalização do cadastro: cobrança, e-mail de convite e criação de conta no hub — Fonte: stape.io

05 Passo 4: Conectar seu pixel

Com a conta criada, o próximo passo é conectar o pixel do Meta à Gateway. Existem dois métodos:

Método 1: Login com Facebook (recomendado)

Este método conecta automaticamente a Gateway à sua conta de anúncios e pixel.

Botão Add Data Source para iniciar a conexão do pixel
Imagem: Botão Add Data Source para iniciar a conexão do pixel — Fonte: stape.io
  1. Clique em Connect
  2. Opção de conexão via login com Facebook
    Imagem: Opção de conexão via login com Facebook — Fonte: stape.io
  3. Faça login no Facebook e clique em Trust this device
  4. Tela Trust this device durante autenticação no Facebook
    Imagem: Tela Trust this device durante autenticação no Facebook — Fonte: stape.io
  5. Autorize os cookies e tecnologias
  6. Diálogo de permissão de cookies e tecnologias do Facebook
    Imagem: Diálogo de permissão de cookies e tecnologias do Facebook — Fonte: stape.io
  7. Selecione a conta de negócios
  8. Seleção da conta de negócios do Facebook
    Imagem: Seleção da conta de negócios do Facebook — Fonte: stape.io
  9. Escolha o pixel que deseja conectar e confirme

Método 2: Conexão manual

Caso prefira não usar o login do Facebook, preencha manualmente o ID do pixel e o token de acesso da API de Conversões, disponíveis no Gerenciador de Eventos do Meta.

Formulário de conexão manual com ID do pixel e token de acesso
Imagem: Formulário de conexão manual com ID do pixel e token de acesso — Fonte: stape.io

Automatic Advanced Matching

Após conectar o pixel, ative o Automatic Advanced Matching para aumentar o Match Quality Score. Essa função coleta automaticamente os dados de identificação do usuário disponíveis na página (e-mail, telefone, nome, etc.) e os envia hasheados ao Meta — sem nenhuma configuração adicional no seu site.

Configuração do Automatic Advanced Matching e seleção de parâmetros de cliente
Imagem: Configuração do Automatic Advanced Matching e seleção de parâmetros de cliente — Fonte: stape.io
Por que o Match Quality importa?

O Match Quality Score indica com que precisão o Meta consegue associar cada evento a um usuário real. Score acima de 8.0 garante melhor atribuição, otimização de campanha mais precisa e públicos de Lookalike mais qualificados. O Advanced Matching é a forma mais simples de elevar esse score sem modificar o código do site.

06 Passo 5 (opcional): Configurar domínio personalizado

Por padrão, a CAPIG usa o domínio capig.stape.biz. Para usar seu próprio domínio (ex: capig.seusite.com.br), siga os passos abaixo.

Um domínio personalizado oferece duas vantagens: (1) reduz a chance de bloqueio por ad blockers que filtram domínios conhecidos de terceiros e (2) melhora a aparência dos eventos no painel do Meta.

Configuração de domínio personalizado no menu Data Routing da CAPIG
Imagem: Configuração de domínio personalizado no menu Data Routing da CAPIG — Fonte: stape.io

Como configurar

  1. No painel da Gateway, clique em Data Routing no menu lateral esquerdo
  2. Clique em Optimize
  3. Anote o subdomínio e o domínio exibidos (ex: capig.seudominio.com)
  4. Acesse o painel do seu provedor de DNS
  5. Crie um registro CNAME apontando o subdomínio escolhido para o domínio da Gateway

Exemplo de configuração no Cloudflare:

Painel do Cloudflare com a opção de adicionar registro DNS
Imagem: Painel do Cloudflare com a opção de adicionar registro DNS — Fonte: stape.io
Botão Add record no Cloudflare para criar o CNAME
Imagem: Botão Add record no Cloudflare para criar o CNAME — Fonte: stape.io
Exemplo de registro CNAME configurado para o domínio da Gateway
Imagem: Exemplo de registro CNAME configurado para o domínio da Gateway — Fonte: stape.io
Aguarde a propagação do DNS

Após criar o registro CNAME, aguarde até 30 minutos para que o DNS propague. Se a página retornar erro 404 antes disso, é normal — aguarde e tente novamente. Para verificar se o registro está ativo, acesse dns.google e pesquise pelo seu subdomínio.

07 Passo 6 (opcional): Adicionar novos pixels

Uma mesma Gateway pode gerenciar múltiplos pixels — útil para agências ou infoprodutores com mais de um produto/domínio.

Processo de adição de novo pixel a uma Gateway já configurada
Imagem: Processo de adição de novo pixel a uma Gateway já configurada — Fonte: stape.io

Para adicionar um novo pixel:

  1. Faça login na sua conta no Stape
  2. Acesse o container da Gateway desejada
  3. Localize a URL da Conversions API Gateway e faça login no hub
  4. Clique em Add data source e selecione o pixel

No plano pay-as-you-go, cada pixel adicional custa $10/mês. No plano Unlimited, até 100 pixels estão incluídos no valor fixo de $100/mês.

08 Passo 7: Setup concluído — visualizando os dados

Com o pixel conectado e a Gateway ativa, o painel exibe o Meta Pixel no ambiente da Conversions API Gateway. Você consegue visualizar:

  • Nome e ID do pixel conectado
  • Status da conexão (ativo/inativo)
  • Volume de eventos recebidos
  • Últimos eventos processados com nome e timestamp
Interface da CAPIG com o pixel do Meta conectado e eventos sendo exibidos
Imagem: Interface da CAPIG com o pixel do Meta conectado e eventos sendo exibidos — Fonte: stape.io

09 Passo 8: Testar a configuração

Antes de confiar nos dados em produção, valide que a CAPIG está recebendo e processando os eventos corretamente.

Verificação no painel da Gateway

Dentro de 30 minutos após a configuração, o contador de eventos deve ser maior que zero e os nomes dos eventos devem aparecer na interface.

Painel da Gateway mostrando contagem de eventos e nomes dos eventos processados
Imagem: Painel da Gateway mostrando contagem de eventos e nomes dos eventos processados — Fonte: stape.io

Verificação no console do navegador

Abra o DevTools do seu navegador (F12 → aba Network) e filtre por capig ou pelo domínio da sua Gateway. Você deve ver requisições sendo enviadas para a URL da CAPIG a cada evento disparado na página.

Console do navegador mostrando requisições enviadas para a URL da CAPIG
Imagem: Console do navegador mostrando requisições enviadas para a URL da CAPIG — Fonte: stape.io

A URL padrão tem o formato: https://capig.stape.biz/ — ou seu domínio personalizado, se configurado no Passo 5.

Valide também no Gerenciador de Eventos do Meta

Acesse o Gerenciador de Eventos na sua conta do Meta Ads. Em poucos minutos, os eventos enviados pela Gateway devem aparecer na coluna 'Recebido pelo servidor' — separados dos eventos do pixel do navegador. A deduplicação automática garante que o Meta não conte o mesmo evento duas vezes.

10 Perguntas frequentes

A CAPIG usa uma conexão servidor a servidor. Se não estiver recebendo eventos, verifique se o pixel está disparando corretamente no frontend e se não há conflito com outras integrações de CAPI (como o sGTM rodando simultaneamente). A recomendação é usar pixel + CAPI com deduplicação ativa — ao invés de substituir um pelo outro.
Plano Pay as you go ($10/mês por pixel): até 10 milhões de eventos por mês. Plano Unlimited ($100/mês): até 200 milhões de eventos para até 100 pixels. Os dois planos oferecem 7 dias de teste gratuito.
Aguarde até 30 minutos para a propagação do DNS. Se o erro persistir, verifique se o registro CNAME foi criado corretamente: o nome deve ser o subdomínio escolhido (ex: capig) e o valor deve apontar para o domínio da Gateway. Use o Google DNS para verificar se o registro está propagado.
Não. A deduplicação é configurada automaticamente pela CAPIG. Um event_id único é gerado para cada evento — o Meta usa esse identificador para eliminar duplicatas entre o disparo do pixel (navegador) e o da Gateway (servidor). Nenhuma configuração adicional é necessária.
Esse é o domínio padrão do Google Cloud Platform, usado quando você tem o Google Tag Manager no modo servidor (sGTM) configurado. Se você já usa sGTM com integração de CAPI, desative-a antes de ativar a CAPIG do Stape — para evitar envio duplicado sem deduplicação adequada.
Ative o Automatic Advanced Matching nas configurações da Gateway e selecione todos os parâmetros de informação do cliente disponíveis: e-mail, telefone, nome, sobrenome, cidade, estado, CEP, país e data de nascimento. Quanto mais identificadores enviados (hasheados), maior o score de correspondência — o ideal é acima de 8.0.
O Stape oferece: Estados Unidos, Europa, América do Sul, Ásia-Pacífico e Ásia Nordeste. Para infoprodutores brasileiros, o servidor na América do Sul oferece menor latência — o que pode reduzir marginalmente o tempo de envio dos eventos ao Meta.
Existem três modelos: (1) Um hub, vários pixels — um único e-mail gerencia múltiplos pixels, cada pixel paga $10/mês; (2) Contas separadas por cliente — cada cliente tem seu próprio hub, com faturamento independente; (3) Plano Multiusuário Privado — $500/mês, até 1 bilhão de requisições, 25 localizações de servidor e painel centralizado para agências.
Precisa de ajuda com a configuração?

Configuramos pixel + CAPI por você

Se você prefere não lidar com a parte técnica, nosso time instala, configura e valida o pixel do Meta com CAPI Gateway — garantindo Match Quality acima de 8.0 antes do seu próximo lançamento.

Ver o serviço