O que é a API de Conversões do Meta e por que ela importa para quem vende no WhatsApp?
Por BAPI

A API de Conversões (CAPI) é a forma de enviar eventos como Lead e Purchase de um servidor direto para o Meta, sem depender do pixel no navegador. Para quem vende pelo WhatsApp, é o único jeito de a venda feita na conversa chegar até a campanha.
A API de Conversões do Meta, a CAPI, é uma forma de enviar eventos (contato, lead, compra) de um servidor direto para o Meta, sem passar pelo navegador do usuário. O pixel registra o que acontece no site. A CAPI registra o que acontece em qualquer lugar onde você tenha o dado, inclusive dentro de uma conversa de WhatsApp. Para quem vende por mensagem, ela é a ponte entre a venda e a campanha.
Qual a diferença entre pixel e API de Conversões?
O pixel é um código que roda na página. A pessoa entra no site, o navegador carrega o pixel e ele avisa o Meta: visualizou, adicionou ao carrinho, comprou. Depende do navegador, de cookie, de a página carregar inteira e de nenhum bloqueador atrapalhar.
A CAPI sai do servidor. Quem tem o dado da venda (sua loja, seu CRM, sua ferramenta de rastreio) monta o evento e envia ao Meta. Não importa se a pessoa usa iPhone, bloqueador ou fechou a aba.
Para e-commerce, o recomendado é usar os dois juntos, com um identificador de evento para o Meta não contar a mesma compra duas vezes. Para venda no WhatsApp a conta é outra: não existe página de obrigado, então o pixel simplesmente não vê a compra. A CAPI é o único caminho.
Quais eventos enviar quando a venda é no WhatsApp?
Pense no funil da conversa e mande um evento por etapa:
- Contact: a pessoa iniciou a conversa a partir do anúncio.
- Lead: a conversa mostrou interesse real (perguntou preço, prazo, detalhes).
- Purchase: a venda foi confirmada, com o valor.
O Purchase com valor é o mais importante. É ele que permite ao Meta otimizar para compra e calcular retorno sobre o investimento com base em dinheiro de verdade.
Como o Meta sabe quem comprou se a venda foi no WhatsApp?
Pelo casamento de dados. Junto com o evento você envia informações do cliente, principalmente o telefone, sempre criptografado com hash SHA-256. O Meta compara esse hash com os dados das contas dele e liga a compra à pessoa que viu ou clicou no anúncio. O telefone em texto aberto nunca sai do seu lado.
No Clique para WhatsApp isso fica ainda mais preciso, porque a conversa carrega o identificador de clique do anúncio (o ctwa_clid). Dá para dizer ao Meta exatamente qual clique virou venda.

O que muda na otimização da campanha?
O algoritmo do Meta aprende com o evento que recebe. Se você só entrega "conversa iniciada", ele procura quem inicia conversa. Muita gente inicia conversa e não compra. Quando o Purchase chega com valor, o sinal fica mais rico: ele começa a reconhecer o perfil de quem paga e a entrega tende a ir para gente parecida.
Alguns cuidados para isso funcionar:
- Volume: o algoritmo precisa de eventos suficientes para aprender. Conta pequena com poucas vendas por semana leva mais tempo.
- Qualidade: só envie Purchase de venda confirmada. Venda falsa ensina errado e é pior do que não enviar.
- Agilidade: envie o evento perto do momento da venda. Evento atrasado demais perde força.
- Paciência: não mexa no conjunto toda vez que o resultado oscila. Deixe a fase de aprendizado acontecer.
Preciso de programador para usar a CAPI?
Se for integrar por conta própria, sim. É preciso um servidor, token de acesso, montagem do evento no formato do Meta, hash dos dados e tratamento de erro. Parceiros como plataformas de loja já fazem isso para venda no site. Para venda no WhatsApp, a integração precisa ler a conversa, decidir quando houve venda e montar o evento. Esse é o trabalho que ferramentas de rastreio fazem.
No BAPI, os eventos vão automaticamente: Contact quando a conversa começa, Lead quando a IA qualifica, Purchase com valor quando a venda é confirmada. Telefone sempre com hash.
Como conferir se os eventos estão chegando?
No Gerenciador de Eventos, abra o conjunto de dados e veja a visão geral. Os eventos enviados pelo servidor aparecem identificados como vindos da API de Conversões. Vale olhar também a qualidade de correspondência do evento: quanto mais dados do cliente (com hash) você enviar, melhor o Meta consegue casar a compra com a pessoa.
Depois, no Gerenciador de Anúncios, crie colunas com Compras e Valor de conversão de compras. É ali que a venda do WhatsApp aparece ao lado do investimento, por campanha, conjunto e anúncio. A partir daí a discussão sobre o que funciona deixa de ser achismo. Para entender o que fazer com esse número, veja como calcular o ROAS de campanha de mensagens.
Perguntas frequentes
A API de Conversões substitui o pixel?
No site, o ideal é usar os dois juntos, com identificador de evento para evitar contagem dupla. Para venda feita no WhatsApp, a API de Conversões é o único caminho, porque o pixel não enxerga a conversa.
Enviar o telefone do cliente ao Meta é seguro?
O telefone é enviado criptografado com hash SHA-256. O Meta recebe só o hash e o usa para casar a compra com a pessoa que viu o anúncio.
Quais eventos enviar para venda no WhatsApp?
Contact quando a conversa começa, Lead quando há interesse real e Purchase com o valor quando a venda é confirmada.



