API de conversões da Meta: o que é e a venda que chega depois de sete dias

Quase todo anunciante que instala a API de conversões da Meta faz isso pelo mesmo motivo: o Pixel do navegador perde eventos, e a campanha passa a otimizar com menos sinal do que de fato aconteceu. Os tutoriais resolvem bem essa parte — onde gerar o token, como ligar pelo Gerenciador de Eventos, para que serve o event_id.

O que quase nenhum deles conta é que a documentação da Meta impõe dois prazos que decidem se o esforço vale: um para enviar o evento e outro para deduplicar. Para quem vende no site, os dois passam despercebidos. Para quem fecha a venda no CRM ou no WhatsApp semanas depois do lead, eles mudam o desenho inteiro. Este guia explica a ferramenta e, em seguida, o envio pensado pelo relógio.

O que é a API de conversões da Meta?

A API de conversões (em inglês, Conversions API, ou CAPI) é a forma de enviar eventos de negócio para a Meta a partir do seu servidor, e não do navegador de quem visita o site. Um lead, uma compra, um cadastro ou uma venda fechada no CRM viram uma chamada de sistema para sistema, com nome do evento, data, origem e dados do cliente.

O Facebook e o Instagram usam esses eventos para três coisas: medir o resultado das campanhas, montar públicos e, principalmente, alimentar a otimização da entrega. Quanto mais completo e confiável o sinal, melhor o algoritmo encontra pessoas parecidas com quem converteu.

A diferença prática é de onde o dado sai. O Pixel depende do navegador: bloqueador de anúncio, cookie recusado, página fechada antes do script carregar — tudo isso apaga o evento. O servidor não depende de nada disso, e ainda consegue mandar o que nunca passou pelo site, como a venda fechada por telefone.

Qual a diferença entre a API de conversões e o Pixel da Meta?

Não é uma escolha entre um e outro. A própria Meta trata os dois como camadas complementares: o Pixel capta o comportamento no navegador, a API garante o evento pelo servidor, e a deduplicação evita que o mesmo fato seja contado duas vezes. O quadro abaixo resume o que cada camada faz bem.

Quadro elaborado pela Alliance Comunicação com base na documentação de desenvolvedor da Meta, consultada em 01/10/2026.

A linha que mais pesa no dia a dia é a quarta. O Pixel não tem prazo porque dispara no momento; a API tem, porque pode chegar atrasada — e é aí que o desenho começa a importar.

Por que a API de conversões tem dois relógios?

Porque são duas regras diferentes, que contam a partir de momentos diferentes. A primeira olha para o fato: quando o evento aconteceu e quando ele chegou à Meta. A segunda olha para o par: quanto tempo a Meta espera pela cópia do mesmo evento vinda do outro canal.

Repare no detalhe que mais custa caro: o erro não é por evento, é por lote. Basta uma linha velha no meio de cem para que as cem voltem recusadas. Quem exporta vendas do CRM uma vez por mês, num arquivo só, está montando exatamente o lote que a Meta devolve.

O que acontece com a venda que chega depois de sete dias?

Ela não entra. E, se estiver no mesmo envio de outras vendas recentes, leva as outras junto. É por isso que o problema raramente aparece como "erro": a integração roda, o painel mostra algum volume de eventos, e ninguém percebe que parte das vendas nunca chegou.

Vale separar duas coisas que costumam ser confundidas. O prazo de 7 dias conta a partir da data da venda, não da data do clique ou do lead. Uma venda fechada no dia 30 depois do lead pode ser enviada normalmente até o dia 37. O que a regra pune não é o ciclo longo — é o atraso entre fechar a venda e avisar a Meta.

O ciclo longo tem outro custo, mais sutil: a campanha otimiza com o que recebe, e uma venda que só aparece um mês depois do anúncio chega tarde para orientar a entrega daquela semana. A plataforma de mídia também atribui conversões dentro da janela de atribuição configurada na conta. Por isso, em vendas consultivas, o evento mais útil para a otimização costuma ser um marco anterior à venda, como o lead qualificado — tema da seção sobre qual evento mandar.

Como funciona a deduplicação de 48 horas?

Quando o mesmo lead é enviado pelo Pixel e pela API, a Meta precisa saber que é um fato só. Ela faz isso comparando o nome do evento e um identificador que você mesmo define, o event_id. Se os dois batem e chegam dentro da janela, um deles é descartado.

Duas consequências práticas saem daí. A primeira: se o servidor envia em lote no dia seguinte, a janela de 48 horas costuma ser suficiente; se envia uma vez por semana, a cópia do servidor chega quando a janela já fechou, e o mesmo lead pode ser contado duas vezes.

A segunda: a regra de "o primeiro que chega" significa que o evento do navegador, que é instantâneo, tende a ganhar. Se o servidor manda dados mais ricos — e-mail, telefone, valor real da venda —, vale enviá-lo o mais perto possível do momento do fato, para que ele não chegue sempre em segundo lugar.

A documentação ainda descreve uma alternativa, por fbp ou external_id em vez de event_id, mas com limites claros: em geral só funciona quando o navegador envia primeiro e o servidor depois, e não deduplica quando o evento existe em uma fonte só. Para quem está desenhando do zero, o event_id é o caminho mais previsível.

Quais dados vão com hash e quais vão sem?

A qualidade da correspondência — a capacidade da Meta de ligar o evento a uma pessoa que viu o anúncio — depende dos dados do cliente enviados junto. E aqui a documentação é específica sobre o tratamento de cada campo.

O erro mais comum aqui não é esquecer o hash: é aplicar o hash antes de normalizar. "Maria@Empresa.com " e "maria@empresa.com" geram resumos diferentes, e o primeiro não encontra ninguém. O mesmo vale para telefone salvo com parênteses, traço ou sem o 55 do Brasil.

O outro cuidado é de privacidade. Hash não transforma dado pessoal em dado anônimo, e IP, user agent e os identificadores do navegador vão em texto aberto. A base legal e o registro de consentimento precisam estar resolvidos antes do envio, e o banner de cookies do site deve conversar com o que o servidor manda — não adianta o visitante recusar o rastreamento no navegador se o servidor envia tudo do mesmo jeito.

Como conectar o CRM à API de conversões?

A busca por "conectar CRM à API de conversões" cresceu justamente porque é onde os dois relógios mordem. O caminho seguro tem cinco decisões, nesta ordem.

1. Escolha os eventos pelo funil, não pelo menu

Liste os marcos que o seu CRM já registra com data confiável: lead recebido, lead qualificado, reunião feita, proposta enviada, venda fechada. Envie à Meta os que acontecem com frequência suficiente para a campanha aprender e que têm relação real com receita.

2. Guarde os identificadores no momento do lead

O CRM precisa salvar, junto do lead, o fbc e o fbp lidos do navegador, o event_id usado pelo Pixel, o e-mail e o telefone. Sem isso, a venda que acontece semanas depois chega à Meta sem nada que a ligue ao clique. É o passo que mais falta nas integrações prontas de formulário.

3. Defina o action_source certo

Cada evento declara de onde veio. A documentação lista valores como website, phone_call, chat, physical_store, system_generated, business_messaging e other. Uma venda fechada pelo comercial por telefone não é "website", e marcar errado distorce o relatório e a leitura da campanha.

4. Envie em até 24 horas, não por mês

A regra de 7 dias permite atraso, mas não recomenda. Uma rotina diária, ou disparada a cada mudança de etapa no CRM, mantém todo evento muito longe do limite e dentro da janela de deduplicação quando há cópia no navegador. Se o envio precisa ser em lote, separe os eventos por data e descarte do lote o que já passou do prazo, em vez de deixar a Meta recusar tudo.

5. Monitore a resposta, não só o envio

A integração precisa registrar o que a Meta devolveu em cada chamada. Lote recusado sem alerta é o motivo de tantas contas descobrirem meses depois que as vendas do CRM nunca entraram.

Qual evento mandar quando o ciclo de venda é longo?

A resposta muda conforme o tempo entre o clique e a receita. Quanto mais longo o ciclo, mais cedo no funil precisa estar o evento que orienta a campanha — e a venda passa a servir mais para medir do que para otimizar.

Quadro elaborado pela Alliance Comunicação a partir das regras de prazo da documentação da Meta.

O raciocínio por trás da tabela é simples: a campanha aprende com volume e com rapidez. Se o evento escolhido é raro ou chega tarde, a fase de aprendizado se arrasta — o post sobre o orçamento que a fase de aprendizado do Meta Ads cobra mostra por que o volume de resultados por semana pesa tanto na entrega.

Quais os erros mais comuns na API de conversões?

• Exportar vendas do CRM uma vez por mês, num lote só: a primeira venda com mais de 7 dias derruba o envio inteiro.
• Gerar o event_id de um jeito no navegador e de outro no servidor: a deduplicação não acontece e o mesmo lead é contado duas vezes.
• Mandar a data do envio no event_time em vez da data real do fato: a venda parece ter acontecido no dia em que a rotina rodou.
• Fazer hash sem normalizar e-mail e telefone, o que derruba a correspondência sem gerar erro nenhum.
• Fazer hash do IP, do user agent ou do fbc, campos que a Meta pede sem hash.
• Usar "website" como origem de tudo, inclusive da venda fechada pelo telefone ou no WhatsApp.
• Ignorar o consentimento: enviar pelo servidor o que o visitante recusou no banner do site.

Como medir se a API de conversões está funcionando?

1. Compare, por semana, as vendas registradas no CRM com as vendas recebidas pela Meta. A diferença não precisa ser zero, mas precisa ser explicável.
2. Confira no Gerenciador de Eventos se os eventos aparecem com as duas origens, navegador e servidor, e se a contagem não dobrou depois da ativação da API.
3. Acompanhe a qualidade da correspondência dos eventos e veja quais dados do cliente estão faltando.
4. Registre os lotes recusados pela Meta e o motivo de cada recusa, com alerta para o time.
5. Meça o atraso médio entre o fato e o envio. Se ele cresce, o relógio dos 7 dias está chegando perto.

Esse confronto entre fontes quase sempre revela que os números não batem — e isso é esperado, porque cada ferramenta conta a seu modo. O artigo sobre por que os números do dashboard de marketing não batem mostra como decidir qual fonte responde a qual pergunta, em vez de forçar todas a coincidir.

A API de conversões substitui o gerenciador de tags?

Não. A API cuida do caminho do servidor; o Pixel e as outras tags do site continuam vivendo no navegador e precisam de alguém que as organize. Em muitos sites, quem lê o fbc e o fbp, gera o event_id e o entrega ao formulário é justamente a camada de tags.

Antes de adicionar mais uma peça, vale saber se o site precisa de um gerenciador ou se a tag nativa resolve — o guia sobre quando o Google Tag Manager vale a pena e quando a tag do Google basta traz o critério. A lógica é a mesma aqui: a ferramenta certa é a que o time consegue manter funcionando.

Por onde começar hoje

Comece pelo diagnóstico, não pela integração. Liste os eventos que o seu CRM registra com data confiável, meça quanto tempo cada venda leva para ser lançada e verifique se os identificadores do navegador estão sendo guardados junto do lead. Com isso em mãos, a configuração técnica é a parte mais curta do trabalho.

Se a sua operação mistura site, WhatsApp e comercial, a ponte entre CRM e mídia é o ponto em que um projeto de web analytics bem estruturado faz diferença — eventos definidos pelo funil, prazos respeitados e números que o time confia. E, para ver onde a mensuração da sua empresa está hoje antes de investir, faça o diagnóstico de marketing gratuito da Alliance.