Próximo Nível Ads Próximo Nível Ads
Agendar com estrategistaAgendar
Blog API de Conversões da Meta: o que é e como ligar ao CRM Faltam 10 min

API de Conversões da Meta: o que é e como ligar ao CRM

O que é a API de Conversões da Meta, como usar junto com o pixel sem contar duas vezes e como enviar as etapas e as vendas do CRM para a Meta.

Mauricio Almeida · 10 min de leitura
Título Leve a venda do CRM até a Meta sobre quatro cartões: pixel no site, servidor com event_id, venda de R$ 7.200 no CRM e evento recebido pela Meta

Resposta rápida

A API de Conversões da Meta (Conversions API, ou CAPI) é a forma de enviar eventos do seu servidor, da sua plataforma ou do seu CRM direto para a Meta, sem depender do navegador do usuário. Ela trabalha junto com o pixel: o pixel registra o que acontece na página, e a API envia o mesmo evento pelo servidor e também o que acontece fora do site, como a venda fechada no WhatsApp ou no comercial. Com os dois juntos e a deduplicação configurada, a Meta recebe mais conversões, com dados melhores, e os lances aprendem com o que de fato vira cliente.

Para ligar a API ao CRM, são cinco passos:

  1. Guardar no lead, desde a entrada, o identificador do clique (fbclid, que vira o parâmetro fbc), o e-mail e o telefone.
  2. Definir no CRM quais etapas viram eventos (lead qualificado, proposta, venda).
  3. Enviar cada etapa para a Meta pela API, com horário real, valor e dados do cliente com hash.
  4. Usar o mesmo ID de evento no pixel e na API quando o evento acontecer nos dois, para não contar duas vezes.
  5. Acompanhar a qualidade da correspondência no Gerenciador de Eventos e corrigir o que faltar.

O que é a API de Conversões da Meta

A API de Conversões é uma integração de servidor para servidor. Em vez de o evento sair do navegador da pessoa, como acontece com o pixel, ele sai do seu sistema (o site, a loja virtual, o CRM, a ferramenta de atendimento) e chega à Meta por uma requisição na API. Segundo a documentação oficial da Meta, ela serve para eventos de site, de aplicativo, de mensagens e de vendas offline, todos ligados ao mesmo conjunto de dados que o pixel usa.

Três termos ajudam a entender o resto do texto:

  • Pixel: o código que roda no navegador e registra visitas, cliques e formulários.
  • Conjunto de dados (dataset): o lugar no Gerenciador de Eventos que recebe os eventos do pixel e da API.
  • Deduplicação: a regra que faz a Meta contar uma vez só o evento que chegou pelo pixel e pela API ao mesmo tempo.
Pronto para o próximo nível?Sessão de até 60 minutos com um especialista sênior, que devolve o mapa de onde a sua receita está vazando e um plano de 90 dias. O documento é seu, com ou sem contrato.
Agendar com estrategista

Por que o pixel sozinho não basta

O pixel depende do navegador. Bloqueadores de anúncio, restrições de cookies, conexões ruins e a pessoa que fecha a página antes do código carregar fazem parte dos eventos se perder. Além disso, o pixel só enxerga o que acontece na página. Para quem vende pelo WhatsApp, pelo telefone ou com time comercial, a parte mais importante do funil acontece onde o pixel não chega.

A API resolve as duas coisas. Ela envia pelo servidor os eventos que o navegador perdeu e leva para a Meta os eventos que nascem no CRM. É por isso que a Meta recomenda usar pixel e API juntos, e não um no lugar do outro.

Pixel e API juntos: como evitar contar duas vezes

Quando o mesmo evento é enviado pelo pixel e pela API, a Meta precisa saber que é um evento só. O jeito recomendado é usar o mesmo event_id nos dois envios, com o mesmo nome de evento. Pela regra de deduplicação da Meta, eventos com o mesmo ID e o mesmo nome que chegam em até 48 horas são tratados como um só, e a Meta mantém o primeiro que recebeu.

Existe um método alternativo, que compara o nome do evento com o cookie fbp ou com um ID externo do cliente. Ele funciona principalmente quando o evento do navegador chega antes do evento do servidor, e por isso é menos confiável. Na prática, se o seu site gera um ID para o pedido ou para o lead, use esse ID como event_id nos dois lados.

O que cada evento precisa ter

Todo evento enviado pela API tem alguns campos obrigatórios. Sem eles, a Meta recusa o envio.

CampoO que éCuidado comum
event_nameNome do evento (Lead, Purchase, um evento personalizado)Usar o mesmo nome do pixel quando houver deduplicação
event_timeHorário real em que o evento aconteceuMandar o horário do envio em vez do horário da venda
user_dataDados para encontrar a pessoa: e-mail e telefone com hash, fbc, fbp, IP, navegador, ID externoTelefone sem DDI e e-mail com espaço ou maiúscula antes do hash
action_sourceOnde o evento aconteceu: website, physical_store (loja ou venda offline), entre outrosMarcar venda do CRM como website
event_source_urlEndereço da página, obrigatório em eventos de siteEsquecer em eventos de formulário do site

Há também um limite de tempo. Para eventos em geral, o horário do evento pode ser de até 7 dias antes do envio. Para vendas em loja ou offline (physical_store), a Meta orienta enviar em até 62 dias, mas recomenda envio diário ou em tempo real para que a otimização funcione bem. Envio mensal, em planilha acumulada, chega tarde demais para o lance aprender.

Como implementar: as quatro formas mais comuns

FormaPara quem serveLimite
Integração nativa da plataforma (loja virtual, CRM com conector pronto)Quem usa plataforma que já oferece a conexãoControle limitado sobre quais dados vão e quando
Gateway da API de Conversões, oferecido pela MetaQuem quer eventos de site pelo servidor sem programarCobre o site, não traz a venda que acontece no CRM
Google Tag Manager server-sideQuem já usa GTM e quer um ponto único para Meta, Google e outras plataformasExige servidor e manutenção técnica
Integração própria pela API (CRM, n8n, backend)Quem precisa enviar etapas do funil e vendas do CRMExige desenvolvimento e monitoramento

Na maioria das empresas que vendem por WhatsApp ou com time comercial, a combinação que funciona é: pixel e API para os eventos do site, com deduplicação, mais uma integração do CRM que envia as etapas do funil e a venda.

Como ligar a API de Conversões ao CRM

  1. Capture os identificadores na entrada. O formulário e o botão de WhatsApp precisam guardar o fbclid da URL, o fbp do navegador, o e-mail e o telefone. No caso de formulário instantâneo da Meta, guarde o ID do lead (lead_id).
  2. Leve esses dados para o CRM. Crie campos para eles e confira que a integração entre site, atendimento e CRM não os apaga.
  3. Escolha as etapas que viram evento. Uma etapa intermediária (lead qualificado, reunião marcada) e a venda são o mínimo. Etapas que acontecem rápido e com volume ajudam o algoritmo a aprender.
  4. Envie automaticamente quando a etapa muda. O gatilho é a mudança de etapa no CRM, que dispara o envio pela API com o horário real, o valor e os dados do cliente com hash (SHA-256).
  5. Use o evento para otimizar. Depois de algumas semanas de envio estável, crie campanhas otimizadas para o evento do CRM, e não só para o formulário.

Para quem usa os formulários instantâneos da Meta, existe uma integração específica de CRM ligada à meta de otimização Leads de conversão. A documentação da Meta pede pelo menos 200 leads por mês, envio diário e uma etapa-alvo que aconteça em até 28 dias depois do lead, com taxa de conversão entre 1% e 40%. O aprendizado leva de 2 a 4 semanas.

Qualidade da correspondência: o número que mostra se está certo

No Gerenciador de Eventos, cada evento recebido pela API tem uma nota de qualidade da correspondência, que indica quanto a Meta consegue ligar o evento a uma pessoa. Nota baixa quase sempre tem uma destas causas:

  • Telefone sem DDI e DDD no formato internacional antes do hash.
  • E-mail com letra maiúscula ou espaço antes do hash.
  • fbc e fbp ausentes, porque o site não guardou os cookies ou o identificador do clique.
  • Poucos campos enviados, só e-mail, quando o CRM tem telefone, nome e cidade.

Os erros mais comuns

  • Enviar pelo pixel e pela API sem event_id. O relatório dobra e o lance aprende com conversões que não existiram.
  • Mandar a venda do CRM com o horário do envio. A venda fica atribuída ao dia errado e às vezes cai fora da janela.
  • Enviar só o Purchase. Com poucas vendas por mês, o algoritmo não tem volume para aprender. Uma etapa intermediária ajuda.
  • Configurar e não monitorar. Uma mudança no site ou no CRM quebra o envio, e ninguém percebe por semanas.

O mesmo raciocínio vale para o Google Ads, que recebe a venda do CRM pela importação de conversões. O passo a passo das duas plataformas está em Conversão offline: como devolver a venda do CRM aos anúncios. E como boa parte da perda acontece antes da venda, vale ler também Tempo de resposta ao lead: quanto custa cada minuto de espera.

Como saber se a API está funcionando

  • Os eventos aparecem no Gerenciador de Eventos com a origem "servidor" e sem duplicação.
  • A qualidade da correspondência dos eventos principais está boa e estável.
  • O número de vendas que a Meta recebe se aproxima do número de vendas do CRM com origem Meta.
  • As campanhas otimizadas para eventos do CRM passam a trazer leads com taxa de fechamento maior.

Onde a Próximo Nível Ads entra nisso

A Próximo Nível Experts implementa a API de Conversões junto com o pixel, com deduplicação, GTM server-side e envio das etapas do CRM, como parte da gestão de tráfego que fazemos desde 2017. O Vision, plataforma de atribuição da Próximo Nível Ads, cruza Meta Ads, Google Ads e o CRM para mostrar se o que a plataforma registra bate com a venda real.

Perguntas frequentes

A API de Conversões substitui o pixel?

Não. A recomendação é usar os dois juntos, com o mesmo event_id para deduplicar. O pixel registra o comportamento na página, e a API garante o envio pelo servidor e leva os eventos que acontecem fora do site.

Preciso de programador para usar a API de Conversões?

Depende da forma. Plataformas com integração nativa e o Gateway da Meta dispensam programação para eventos do site. Enviar etapas e vendas do CRM quase sempre exige uma integração, feita por desenvolvimento próprio, por um parceiro ou por uma ferramenta de automação.

A API de Conversões funciona para vendas no WhatsApp?

Funciona, desde que o lead do WhatsApp esteja registrado no CRM com os dados de origem e de contato. Quando a venda é marcada, o CRM envia o evento para a Meta com esses dados.

Enviar dados de clientes pela API está de acordo com a LGPD?

Os dados pessoais são enviados com hash, e a Meta os usa para correspondência e medição. A empresa continua responsável por ter base legal, informar o uso na política de privacidade e respeitar o consentimento.

Quanto tempo leva para ver resultado?

Os eventos aparecem no Gerenciador de Eventos em minutos. A mudança nos lances depende do volume: com envio diário e uma etapa com volume suficiente, as campanhas costumam precisar de algumas semanas de aprendizado.

Compartilhe com o seu time
Newsletter · toda quinta, 8h

Um e-mail por semana. Só o que mexe na receita.

As matérias novas do blog, direto na caixa de entrada. Sem promoção.

Temas de interesse
Cancelamento em um clique. Seus dados seguem a Política de Privacidade.

Continue lendo

Todas as matérias
Instagram · LinkedIn

Acompanhe a Próximo Nível

@proximonivelads Últimos posts no Instagram
Seguir
Próximo Nível Ads LinkedIn · último post hoje

Checklist para medir o resultado real da Black Friday: linha de base, origem das vendas, antecipação, devoluções e margem, além do número da plataforma.

Ler no blog
Seguir no LinkedIn