A API de Conversões da Meta é um canal que envia os eventos do seu negócio, como compra, cadastro ou venda fechada, do seu servidor, da sua plataforma de site ou do seu CRM direto para a Meta, sem depender só do navegador do cliente. Ela complementa o Pixel e não o substitui. Para uma pequena empresa vale a pena quando a venda acontece fora do site, no WhatsApp ou no CRM, ou quando o Pixel sozinho perde eventos. Para conferir se funciona, use a ferramenta Eventos de Teste e confirme que cada evento chega uma vez só.
Este guia mostra o que a API de Conversões da Meta faz, quando ela compensa para uma empresa pequena, os cuidados que evitam evento duplicado e o teste de dez minutos para saber se a sua está funcionando. Tudo o que é regra técnica vem da documentação oficial da Meta, que abrimos para este texto em 30 de outubro de 2026.
O que é a API de Conversões da Meta
É uma conexão entre os dados de marketing do anunciante e a Meta, feita pelo servidor, pela plataforma do site, pelo aplicativo ou pelo CRM. A documentação oficial diz que ela serve para ajudar na segmentação dos anúncios, na redução do custo por resultado e na medição de resultados.
Os eventos que chegam por ela entram no mesmo conjunto de dados que recebe os eventos do Pixel da Meta. Por isso são usados para medição, relatório e otimização de forma parecida. Uma só integração pode mandar eventos de site, aplicativo, mensagens de negócio e vendas offline.
O Pixel é um código que roda no navegador de quem visita o site. A API de Conversões é o seu sistema avisando a Meta. O que o navegador não viu, o servidor viu.
O interesse de busca é pequeno e bem específico. Pelo Planejador de palavras-chave do Google Ads, em 30 de outubro de 2026, “api de conversões da meta” tem cerca de 110 buscas por mês no Brasil, com lance de topo estimado em R$ 32,08. É o lance estimado pelo Google para o topo da página, não o que cada empresa paga. Quem pesquisa isso normalmente já está com um problema real de medição, e não só curioso.
Pixel e API de Conversões: como se complementam
O Pixel registra o que acontece no navegador, e a API registra o que o seu sistema sabe. Usar os dois juntos, com o mesmo evento chegando pelas duas vias, é a configuração que a Meta chama de redundante, e ela depende de uma regra de deduplicação, explicada adiante.
| Pixel da Meta | API de Conversões | |
|---|---|---|
| Onde roda | No navegador do visitante | No servidor, na plataforma ou no CRM |
| O que enxerga | Páginas vistas, cliques, formulário enviado | Qualquer coisa que o seu sistema registre, inclusive venda fechada depois |
| Depende do navegador | Sim | Não |
| Precisa de código | Um snippet no site | Depende do método de integração |
| Risco principal | Evento perdido | Evento duplicado ou mal identificado |
O ponto da última linha é o que mais pega. A API de Conversões não quebra a medição por ser complexa. Quebra por ser configurada sem checar a duplicidade.
Quando vale para pequena empresa
Vale quando uma parte importante da venda acontece onde o Pixel não enxerga. Esse é o nosso critério, não uma regra da Meta, e funciona melhor do que a pergunta “devo ter ou não”.
Sinais de que compensa.
- A conversa de venda acontece no WhatsApp ou por telefone, e o site só gera o primeiro contato.
- Você usa um CRM e sabe quais contatos viraram cliente, mas a Meta não sabe.
- O número de compras ou cadastros na Meta é visivelmente menor do que o da loja ou da planilha.
- Você investe o suficiente em anúncios para que cada evento perdido atrapalhe a otimização.
Ainda não é prioridade se o Pixel nem está instalado direito ou se o objetivo é só alcance, sem conversão que você consiga registrar.
A documentação da Meta informa que, se você já tem um Pixel, dá para ativar a API de Conversões para eventos de site a partir do Gerenciador de Eventos, com uma opção de um clique, sem código nem taxa de configuração. Em muitas plataformas de site, esse é o caminho mais curto para uma empresa pequena. Antes de contratar qualquer desenvolvimento, confira se a sua plataforma já oferece isso.
Se a dúvida é entre investir primeiro na Meta ou no Google, o nosso comparativo Google Ads ou Meta Ads ajuda a decidir onde o dinheiro rende mais para o seu tipo de negócio.
Deduplicação de eventos: o cuidado que evita contar a venda duas vezes
Se o mesmo evento chega pelo Pixel e pela API, a Meta só desconta a duplicata se os dois tiverem o mesmo identificador. Sem isso, uma compra aparece como duas, o custo por resultado parece menor do que é e a otimização aprende errado.
A documentação oficial descreve dois métodos. O recomendado usa o `event_id` e o nome do evento.
- O `eventID` enviado pelo Pixel precisa ser igual ao `event_id` enviado pela API.
- O nome do evento no Pixel precisa ser igual ao `event_name` da API.
- Se a mesma combinação chegar das duas fontes para o mesmo Pixel em até 48 horas, o evento que chegou depois é descartado.
O segundo método usa o `event_name` mais o `fbp` ou o `external_id`, enviados da mesma forma pelo navegador e pelo servidor. Nele, só se deduplica o evento do servidor que chega depois de um evento do navegador, dentro das mesmas 48 horas. Dois eventos só do navegador ou só do servidor, ainda que idênticos, não são deduplicados.
A documentação não diz o que acontece quando o `event_id` está ausente, nem se a Meta recorre ao segundo método. Por isso a regra prática é gerar o `event_id` no momento do evento, mandar o mesmo valor pelas duas vias e conferir no teste. O detalhe completo está na página oficial de deduplicação.
Quais dados enviar com o evento
O evento precisa de pelo menos um dado do usuário em formato correto, e para eventos de site o `client_user_agent` também é obrigatório. Quanto mais dados válidos, maior a chance de a Meta ligar o evento a uma pessoa.
A documentação de parâmetros de informações do cliente resume o formato de cada um.
| Parâmetro | O que é | Formato |
|---|---|---|
| `em` | Sem espaços nas pontas, minúsculas, com hash SHA-256 | |
| `ph` | Telefone | Sem símbolos, letras e zeros à esquerda, com código do país, com hash SHA-256 |
| `fbc` | ID do clique | Vem do cookie `_fbc`, sem hash |
| `fbp` | ID do navegador | Vem do cookie `_fbp`, sem hash |
| `client_ip_address` | IP | Sem hash, nunca |
| `client_user_agent` | Navegador do usuário | Sem hash |
Para eventos enviados pelo servidor, o IP e o navegador precisam ser informados manualmente. No navegador, o Pixel os adiciona sozinho. Quem usa uma plataforma com integração pronta não precisa montar isso à mão, mas vale saber o que está sendo mandado.
Os dados pessoais vão com hash por segurança, e o seu site precisa explicar na política de privacidade o que coleta. Antes de enviar dados de pessoas, confirme com o seu jurídico o que a sua política e o consentimento do visitante cobrem. Para o lado do Google, o guia de consent mode v2 mostra como o consentimento afeta a medição.
Como conferir se a API de Conversões da Meta está funcionando
Abra o Gerenciador de Eventos, vá em Fontes de dados, escolha o Pixel e use a aba Eventos de Teste, que gera um código de teste para os eventos do servidor. A documentação oficial descreve esse caminho. É o jeito de ver a API funcionando antes de depender dela.
O teste, em seis passos.
- No Gerenciador de Eventos, abra o seu Pixel e entre em Eventos de Teste.
- Copie o código de teste que a ferramenta gera.
- Envie um evento de servidor com esse código no parâmetro `test_event_code`.
- Veja o evento aparecer na janela de testes.
- Faça a mesma ação no site, para o Pixel mandar o mesmo evento, e confirme que os dois aparecem com o mesmo `event_id`.
- Remova o `test_event_code` do envio de produção.
Segundo a documentação, eventos enviados com `test_event_code` não são descartados. Eles entram no Gerenciador de Eventos e são usados para segmentação e medição. O código serve só para testar e não deve ficar na configuração final.
Depois de começar a enviar, a documentação diz que dá para verificar os eventos em até 20 minutos. Em Visão Geral, o Gerenciador mostra a contagem de eventos brutos, correspondidos e atribuídos, e a coluna Método de Conexão indica por qual canal cada evento chegou.
Se algum `event_time` tiver mais de 7 dias, a documentação informa que a requisição inteira retorna erro e nenhum evento é processado. Envie os eventos perto da hora em que acontecem.
O que a API de Conversões muda no seu tráfego pago
Ela não aumenta a venda sozinha. Ela melhora o que a Meta sabe sobre quem comprou, e a campanha aprende com isso. Se a venda fecha no WhatsApp, enviar essa venda de volta é o que separa uma campanha que otimiza para conversa de uma que otimiza para cliente.
Para quem trabalha com Google Ads, a lógica é a mesma. O Google também aprende melhor com a venda do que com o clique, e o caminho é parecido, registrando a origem do contato e devolvendo o resultado. Explicamos essa parte em rastreamento de conversões com GA4 e CRM e, para sites que querem mais controle sobre o envio, em server side tagging.
Como a Ciclicko trabalha o rastreamento
Na Ciclicko, a medição vem antes do anúncio. Mapeamos onde a venda acontece, definimos qual evento representa dinheiro de verdade, instalamos e testamos o rastreamento e conferimos se o número da plataforma bate com o do CRM ou da loja. Esse trabalho é feito para o Google Ads e para o GA4, que é a nossa especialidade como agência Google Partner.
A mesma disciplina vale para a Meta. Evento sem identificador, sem teste e sem conferência contra o caixa gera relatório bonito e decisão errada. Não prometemos aumento de venda, só um número em que você possa confiar.
Perguntas frequentes
O que é a API de Conversões da Meta? É uma conexão que envia eventos do seu servidor, da plataforma do site, do aplicativo ou do CRM para a Meta, para ajudar na segmentação, na medição e na redução do custo por resultado.
A API de Conversões substitui o Pixel? Não. Ela complementa o Pixel. O uso conjunto exige que o mesmo evento tenha o mesmo identificador nas duas vias, para a Meta descartar a duplicata.
Como fazer a API de Conversões da Meta? Se você já tem um Pixel, dá para ativá-la para eventos de site pelo Gerenciador de Eventos, com uma opção de um clique. A outra via é a integração direta, em que o seu servidor envia as requisições à API.
Como saber se a API de Conversões está funcionando? Use a aba Eventos de Teste do Gerenciador de Eventos, envie um evento com o `test_event_code` e confira se ele aparece uma vez só, com Pixel e servidor deduplicados.
Quanto tempo a Meta leva para mostrar os eventos? Segundo a documentação oficial, dá para verificar em até 20 minutos depois de começar a enviar.
Preciso de desenvolvedor para usar a API de Conversões? Nem sempre. Plataformas de site com integração pronta e a opção de um clique para quem já tem Pixel resolvem muitos casos. Integração direta e envio de vendas do CRM costumam pedir quem programe.
Quer medir a venda de verdade, e não só o clique?
Conheça o nosso trabalho de rastreamento de conversões do Google Ads com CRM e peça uma avaliação de como a sua venda está sendo medida hoje.