Rastreamento de Conversões com Meta (CAPI)

O envio de conversões está ativo. Depois de configurado (é rápido — veja Como configurar), o ConvertaFlow envia os eventos de Lead e Purchase direto do nosso servidor para a sua conta de anúncios, e a Meta passa a saber qual anúncio gerou qual venda.

Isso é diferente da origem do anúncio, que funciona sozinha e não precisa de configuração nenhuma: identificar qual anúncio trouxe cada conversa que chega por Click-to-WhatsApp, e mostrar isso no contato e no Funil de Anúncios.

O que é, e por que importa

O Pixel instalado no site captura conversões pelo navegador do cliente. Esse método tem limitações conhecidas: bloqueadores de anúncios, restrições de cookies de terceiros e mudanças no iOS fazem o Pixel perder parte das conversões reais.

A Conversions API (CAPI) contorna isso enviando os eventos direto do servidor para a Meta. O ganho é:

Eventos que o navegador perde passam a ser contabilizados
A Meta passa a saber qual anúncio gerou qual venda — não só qual gerou o clique
O algoritmo otimiza para quem compra, não para quem apenas conversa

Quais eventos são enviados

Evento	Quando
LeadSubmitted	Quando alguém clica num anúncio de WhatsApp e manda a primeira mensagem (o lead "chegou")
Lead	Quando um contato preenche um formulário nativo da Meta (Lead Ads) e entra no ConvertaFlow — o evento leva a identificação do formulário, para a Meta ligar as etapas seguintes ao anúncio
QualifiedLead	Quando a sua equipe coloca a tag Qualificado no contato, com Enviar lead qualificado para a Meta Ads ligado (Contatos → Tags) — a MAIA não qualifica
Purchase	A cada venda registrada (ao levar o negócio para Fechado ou pelo Registrar venda)

Cada venda envia uma compra (Purchase): o cliente que compra três vezes gera três conversões. Os sinais de lead (como o QualifiedLead) saem uma vez por anúncio: se o cliente clica num anúncio novo, esse anúncio passa a ser o da vez, e a compra seguinte é atribuída a ele.

Lead que veio de formulário: ao aceitar o lead na triagem, o ConvertaFlow guarda de qual formulário e de qual anúncio ele veio. Os sinais seguintes desse contato — QualifiedLead e Purchase — saem com essa identificação, então a Meta consegue mostrar, dentro do próprio lead, que ele foi qualificado e que comprou.

Lead não qualificado e reunião agendada também chegam à Meta, como eventos de CRM — o não qualificado pela tag de sistema Não qualificado (vermelha), a reunião por tag ou pela Agenda. Veja Funil de CRM para a Meta.

Para que servem os sinais (e como configurar a campanha)

O conjunto de anúncios da Meta otimiza para um evento. Se ele estiver otimizando para "conversa iniciada", o algoritmo aprende a trazer quem manda mensagem — inclusive curiosos. Com os sinais do ConvertaFlow, você pode subir a régua:

Otimizar para lead qualificado — no conjunto de anúncios, escolha o evento QualifiedLead (aparece no Gerenciador de Eventos depois do primeiro envio). A Meta passa a procurar pessoas parecidas com quem chegou à sua etapa de qualificação.
Otimizar para compra — escolha Purchase. Exige volume (dezenas de conversões por semana); com pouco volume, fique em lead qualificado.

Para enviar o lead qualificado, abra Contatos → Tags, edite a tag Qualificado (ela já vem com o sistema, dourada) e ligue Enviar lead qualificado para a Meta Ads. A tag é colocada pela sua equipe, no chat ou na ficha (a MAIA não qualifica); o card aberto ganha o selo em qualquer etapa e o sinal sai uma vez por anúncio que trouxe o cliente. O diálogo da tag mostra se as Conversões para a Meta estão ativas. A irmã dela, Não qualificado (vermelha), funciona do mesmo jeito para o sinal negativo — e as duas se excluem: colocar uma tira a outra.

No Pipeline, o selo Enviado à Meta de cada card mostra o último evento que saiu para aquele lead e se a Meta recebeu, e o filtro Falta qualificar lista os leads de anúncio de 2 a 7 dias que ainda não receberam nenhuma das duas tags.

Várias contas de anúncio, cada uma com o seu pixel

Quem anuncia por mais de uma conta costuma ter um conjunto de dados por conta — uma para as campanhas de WhatsApp, outra para as de formulário, e assim por diante. Mandar tudo para o mesmo conjunto faz a conta que pagou pelo lead não receber o sinal, e ela continua otimizando no escuro.

Em Conexões → Conversões para o Meta (CAPI), abaixo do Pixel ID, fica Destino por conta de anúncio: cada conta que você conectou aparece com a lista de conjuntos de dados do Gerenciador de Negócios dela. Escolha o destino de cada uma e salve. Conta deixada em Usar o padrão envia para o Pixel ID de cima.

A lista vem da Meta — você não precisa colar mais nenhum Pixel ID.
Se a conta disser reconecte esta conta, é porque ela foi ligada antes de a permissão de envio existir. Reconecte em Conexões e a lista aparece.
A plataforma envia as conversões do que passa por ela: conversas de WhatsApp e leads de formulário da Meta. Campanhas para site ou formulário de terceiro continuam sendo medidas pelo pixel do próprio destino.

Deduplicação com o Pixel do seu site

Não há deduplicação automática entre o CAPI do ConvertaFlow e o Pixel do seu site.

A Meta só reconhece dois registros como o mesmo evento quando ambos chegam com o mesmo identificador de evento. Esse identificador precisa ser combinado entre quem dispara no navegador e quem dispara no servidor — e o ConvertaFlow não tem como entregá-lo ao Pixel que roda no seu site.

Na prática: se o seu site já dispara um evento equivalente pelo Pixel, os dois são contados em separado. Escolha um dos dois como fonte para cada tipo de evento, ou os números vão divergir do seu faturamento real.

Como configurar

São duas informações, as duas pegas no Gerenciador de Eventos da Meta: o Pixel ID e o Token de Acesso da API de Conversões.

Antes de começar — o pixel precisa estar no seu portfólio

O token só pode ser gerado por quem é administrador do portfólio empresarial (o antigo Gerenciador de Negócios) em que o pixel está. Se o pixel estiver solto na conta pessoal, ou num portfólio em que você não é administrador, a Meta mostra "Pré-requisito ausente" no lugar do botão de gerar token. Resolva antes de seguir: mova o pixel para o seu portfólio ou peça a quem administra o portfólio que faça os passos abaixo ou lhe dê acesso de administrador.

Passo 1 — abrir o conjunto de dados

Entre no Gerenciador de Eventos e, no menu da esquerda, clique em Conjuntos de dados. Selecione o conjunto (o Pixel) que você usa nas campanhas. Logo abaixo do nome dele aparece Identificação seguida de um número — esse número é o Pixel ID. Guarde: é o primeiro dos dois campos.

Passo 2 — gerar o Token de Acesso

Ainda dentro do conjunto de dados, abra a aba Configurações e role até a seção Configurar integração direta. Faça exatamente o que as duas setas mostram:

Na aba Configurações, marque "Configurar com a Dataset Quality API" e clique em "Gerar token de acesso"

Deixe marcada a opção "Configurar com a Dataset Quality API" (vem marcada por padrão). Não troque para a opção de baixo. É essa escolha que libera as métricas de qualidade de correspondência de eventos — sem ela, o ConvertaFlow não consegue mostrar a você o quanto a Meta está conseguindo casar os seus eventos com pessoas reais.
Clique em "Gerar token de acesso". Abre uma janela pedindo para selecionar os conjuntos de dados da Dataset Quality API. Marque só o seu próprio pixel — o mesmo do passo 1. A lista pode trazer pixels de outros negócios a que você tem acesso, e essa escolha não pode ser desfeita depois.
A Meta mostra o token uma única vez: copie na hora. Se fechar a janela antes de copiar, é só gerar outro.

Esse token é uma senha. Ele dá acesso de escrita ao seu Pixel. Não cole em conversa, em e-mail nem em planilha compartilhada — leve direto do Gerenciador de Eventos para o campo do ConvertaFlow. Ele não é o mesmo que o Token da Página, que é usado para mensagens.

Passo 3 — colar no ConvertaFlow

No painel, vá em Integrações > Conexões (canais) e procure o card Conversões para o Meta (CAPI). Ele fica sempre visível, não depende de nenhuma conexão estar ligada. Cole o Pixel ID do passo 1 e o token do passo 2, e clique em Salvar.

Ao salvar, a plataforma confere a dupla com a Meta na hora, enviando um evento de teste interno pelo mesmo caminho das conversões reais (ele não aparece no seu Gerenciador nem entra em nenhum número). Se o Pixel ou o token estiverem errados, o card mostra o motivo em vez de deixar você descobrir depois, quando as conversões não aparecerem. O botão Testar conexão repete essa checagem quando você quiser.

O token fica criptografado no nosso banco: nem a nossa equipe consegue lê-lo depois de salvo. Para trocá-lo, basta colar um novo por cima — deixando o campo em branco, o token atual é mantido.

Passo 4 — conferir que chegou

A primeira prova é o próprio card: depois de salvar, ele mostra Credencial conferida. Isso já garante que o Pixel e o token estão certos.

Para ver um evento chegando, volte ao Gerenciador de Eventos, na aba Eventos de teste do mesmo conjunto de dados. Em "Selecione um canal de marketing", escolha Mensagem se ele aparecer; num pixel criado como Web a lista costuma trazer só Site e Offline — escolha qualquer um. A tela mostra um código que começa com TEST.

Copie esse código, cole no campo Código de teste do card e salve. Agora o botão Enviar evento de teste fica disponível: ele manda um evento de verdade, pelo mesmo caminho que os eventos reais usam, e ele aparece na aba Eventos de teste sem entrar nos números das suas campanhas. Clicar duas vezes não conta a conversão duas vezes — é assim que dá para conferir que a deduplicação está funcionando.

O botão só funciona com o código de teste preenchido, e isso é de propósito: sem ele, a Meta trataria o evento como uma conversão real e ele entraria nos números das suas campanhas.

Os eventos do funil de CRM (lead não qualificado, reunião agendada) não aparecem na aba Eventos de teste — a Meta não os mostra lá. Para eles, a prova é o card e, depois do uso real, a Visão geral do conjunto de dados.

Passo 5 — acompanhar o que foi enviado

Abaixo do status da credencial, o card mostra um resumo dos últimos 7 dias: quantas conversões foram enviadas, quantas aguardam reenvio e quantas falharam. Quando há falha, o último motivo aparece em texto pequeno logo abaixo.

Aguardando reenvio significa que a Meta não aceitou o evento naquele momento (instabilidade, limite de consultas, ou o lead ainda sem a página do anúncio identificada) e o ConvertaFlow vai tentar de novo sozinho, em intervalos crescentes, por até 5 vezes. Você não precisa fazer nada.

Falhou significa que o reenvio esgotou ou que o motivo não se resolve sozinho — o mais comum é token vencido ou revogado: gere um novo token no Gerenciador de Eventos e cole no card. Depois de salvar, os próximos eventos voltam a sair normalmente.

O que a Meta usa para casar o evento com a pessoa

Cada evento sai com os dados de correspondência do contato que a plataforma conhece: telefone, e-mail (quando cadastrado), nome e sobrenome, país e um identificador interno — todos protegidos por hash antes de sair do nosso servidor. Quanto mais campos preenchidos no contato, maior a qualidade da correspondência que o Gerenciador de Eventos mostra, e melhor a campanha aprende. Se o seu CRM tem cidade e estado do contato em campos personalizados chamados "cidade" e "estado" (ou "city"/"state"), eles também são enviados.

Boas práticas

Tokens de acesso da Meta expiram e podem ser revogados — confira periodicamente
Verifique se o Pixel está vinculado à conta de anúncios correta antes de iniciar campanhas
Use a ferramenta de Teste de Eventos do Gerenciador de Eventos para confirmar o recebimento

Dúvidas frequentes

Preciso configurar para a origem do anúncio funcionar? Não. Identificar qual anúncio trouxe cada conversa funciona sozinho, sem Pixel ID nem token. A configuração desta página serve para o passo seguinte: devolver a conversão para a Meta.

Preciso ter o Pixel instalado no meu site? Para o CAPI do ConvertaFlow, não. Mas veja a seção de deduplicação acima: os dois não se conversam, então mantenha os eventos separados para não contar a mesma venda duas vezes.

O CAPI funciona com todas as campanhas da Meta? Sim — eventos enviados por CAPI valem para campanhas no Facebook, Instagram e Messenger.

Meus dados de clientes são compartilhados com a Meta? A Meta recebe apenas o necessário para a correspondência de eventos (hash de e-mail ou telefone, quando disponíveis), conforme as políticas de dados da Meta e a legislação de privacidade aplicável.

Como ler o funil da tela Funil de Anúncios

Leads captados — todo contato que chegou por um anúncio (clique para o WhatsApp ou formulário).
Leads atendidos — desses, quantos já têm uma conversa (atendimento) na plataforma.
Atendimentos finalizados — quantos tiveram o atendimento encerrado. Não é venda: venda é o negócio movido para a etapa de ganho no Pipeline, e é ela que alimenta o ROAS e o evento de compra enviado ao Meta.

Quem vende pelo WhatsApp (sem site) depende desse registro: o Meta só libera a otimização "maximizar compras por mensagens" depois de receber compras suficientes (a referência informada pelo Meta é de 10 nos últimos 30 dias). Marque o negócio como ganho sempre que fechar uma venda.

Registrar venda pela conversa

Quem vende pelo WhatsApp não tem carrinho nem página de pagamento para avisar o Meta de que a venda aconteceu. Na plataforma, esse aviso é o Registrar venda:

No Chat, abra o painel do contato e clique no card Negócios (ou em + Novo negócio).
Clique em Registrar venda, informe o valor e, se quiser, os itens vendidos.
A plataforma grava a venda dentro do card do cliente e move o card para a etapa de venda ganha do seu funil (se ainda não estiver lá). Se o contato chegou por um anúncio, a compra é enviada ao Meta na hora.

Toda venda registrada é uma compra nova e envia o seu próprio Purchase: é assim que a recompra conta como resultado da campanha. Digitou o valor errado? Abra o card no Pipeline e, na seção Compras, use Corrigir valor (não envia nada novo ao Meta) ou Cancelar venda. Assim o Meta não aprende duas compras onde houve uma só. Levar o card para Fechado no Pipeline abre a mesma janela de venda: o botão do chat é o atalho para fazer tudo sem sair da conversa.

No Funil de Anúncios, a faixa Compras por mensagem mostra quantas vendas o Meta recebeu nos últimos 30 dias, contra o volume de referência de 10 compras. Só entram vendas de contatos que chegaram por anúncio de clique para o WhatsApp.

A etapa de venda ganha é a Fechado, que é fixa em todo funil (veja o artigo do Pipeline). É para ela que o Registrar venda move o negócio.

CAPI da Meta — Como funciona