Relatórios de Meta Ads
Conversions API para WhatsApp: devolver a venda para a Meta otimizar o anúncio
Como a Conversions API leva a venda feita na conversa de volta ao anúncio de clique para o WhatsApp, o que ela exige e o que o Vazante faz (e ainda não faz).
A campanha de clique para o WhatsApp está otimizada para conversas, e entrega conversas. Muitas. O problema aparece no fim do mês: o anúncio que mais trouxe conversa não é o que mais vendeu, e a Meta não tem como saber disso. A venda aconteceu dentro da conversa, dias depois, e ninguém contou para o algoritmo.
A Conversions API para mensagens comerciais existe para fechar esse buraco. Ela aplica ao chat a mesma ideia de enviar conversões pelo servidor que se usa no site. Se essa ideia ainda é nova para você, comece por Conversions API vale a pena?, que trata do site. Aqui o assunto é só o WhatsApp.
Transparência antes de tudo: o Vazante ainda não envia conversões para a Meta. No fim do texto está o que ele faz hoje e o que perguntar a quem diz que envia.
O que ela é, no caso do WhatsApp
É a ferramenta pela qual um parceiro manda à Meta, do próprio servidor, os eventos que acontecem dentro de uma conversa iniciada por anúncio de clique para o WhatsApp, o Messenger ou o Instagram. O objetivo declarado pela Meta é medir e melhorar o desempenho desses anúncios.
Duas diferenças em relação à Conversions API do site:
- O evento acontece na conversa. A Meta pede que os eventos representem o que aconteceu no chat. Compra feita no site segue pela Conversions API de web; compra no aplicativo, pela de app.
- A chave é o clique no anúncio, não o navegador. Quem liga a venda ao anúncio é um identificador de clique que chega junto com a primeira mensagem.
A peça que liga a venda ao anúncio
Quando alguém toca num anúncio de clique para o WhatsApp e escreve, o aviso (webhook) da mensagem traz um objeto de origem, o referral, com o identificador único daquele clique, o ctwa_clid. Daí em diante, o caminho é este:
- O cliente toca no anúncio e manda a primeira mensagem.
- O sistema ligado à API recebe o aviso e guarda o identificador junto da conversa.
- A conversa segue, com a equipe no app ou com um robô. Dias depois, a venda fecha.
- Alguém, ou algum sistema, registra que a venda aconteceu.
- O servidor manda o evento à Meta com o identificador do clique, a identificação da conta do WhatsApp, a origem "business_messaging" e o canal "whatsapp", para o conjunto de dados (dataset) ligado à conta.
- A Meta liga a venda àquele clique e passa a ter o sinal.
O passo 2 não tem conserto depois. Se o número não estava conectado quando a conversa começou, não há identificador guardado para enviar quando a venda fechar.
Há também uma limitação documentada: desde 20/10/2025, conversas iniciadas em anúncios no Status do WhatsApp não trazem o identificador de clique no aviso. Essas vendas ficam fora do envio.
Como a origem chega e por que a conexão precisa vir antes da campanha está explicado em qual anúncio gerou a conversa no WhatsApp.
Os 14 eventos aceitos
A Meta aceita 14 eventos nesse canal. Agrupados pelo momento do funil:
| Momento | Eventos |
|---|---|
| Interesse e lead | ViewContent, LeadSubmitted, QualifiedLead |
| Compra | AddToCart, InitiateCheckout, CartAbandoned, Purchase |
| Pedido | OrderCreated, OrderShipped, OrderDelivered, OrderCanceled, OrderReturned |
| Avaliação | RatingProvided, ReviewProvided |
Para quem vende serviço ou produto de valor alto pela conversa, os dois que mais contam costumam ser QualifiedLead e Purchase. O primeiro marca a conversa que virou oportunidade de verdade. O segundo, a venda. Quem vende produto e despacha pedido ganha com a família de eventos de pedido.
Qual deles usar para otimizar, e quando subir de um para o outro, é a discussão de evento de qualidade ou de volume.
Por que isso melhora a otimização
O algoritmo procura mais gente parecida com quem fez o evento que ele enxerga. Sem retorno, o único evento visível é a conversa iniciada, e ele vai buscar gente que conversa. Não é o mesmo que gente que compra.
Segundo a Meta, a Conversions API habilita a otimização para compra nos anúncios de clique para o WhatsApp e para o Messenger. Para o Instagram, ainda não.
Um exemplo com números redondos:
| Anúncio A | Anúncio B | |
|---|---|---|
| Gasto na semana | R$ 800 | R$ 800 |
| Conversas | 80 | 40 |
| Custo por conversa | R$ 10 | R$ 20 |
| Vendas | 2 | 6 |
| Custo por venda | R$ 400 | R$ 133 |
Otimizando por conversa, a Meta tende a empurrar verba para o A. Com a venda devolvida, ela passa a ter o dado que mostra que o B traz quem compra. Sem o envio, essa conta continua possível do seu lado, num relatório, mas a decisão de verba fica com você, não com o algoritmo.
O que precisa estar no lugar
Do lado de quem envia, seja o provedor ou o sistema da sua empresa, a Meta pede:
- app com acesso avançado à permissão de gerenciar a conta do WhatsApp e à permissão de eventos do WhatsApp, que é aprovada automaticamente para quem já tem acesso avançado à de mensagens;
- o nível de acesso à Marketing API;
- integração com a Cloud API, que ela recomenda;
- cliente conectado pelo cadastro incorporado (Embedded Signup) ou pelo login do Facebook para empresas.
Do lado da sua empresa:
- Um dono para o evento. Alguém precisa dizer que a venda aconteceu: o vendedor marcando no CRM, o sistema de pedidos, o checkout. Sem gatilho, não há evento.
- Deduplicação. A Meta não faz; é responsabilidade do anunciante. Se o CRM e outra integração mandarem a mesma venda, ela conta duas vezes, e você otimiza por um número inflado.
- Coexistência não impede. Segundo a Meta, clientes conectados por coexistência, com app e API no mesmo número, podem rodar anúncios de clique para o WhatsApp, e o parceiro pode reportar compras e leads deles pela Conversions API.
Onde a etapa de venda costuma ser registrada, e por que ela mora no CRM e não no provedor do WhatsApp, está em Tech Provider e CRM.
Cinco perguntas para quem diz que envia
- Vocês guardam o identificador do clique no momento em que a primeira mensagem chega?
- Quais dos 14 eventos vocês enviam, e o que dispara cada um?
- Para qual conjunto de dados os eventos vão, e como eu confiro que chegaram?
- Como vocês evitam mandar a mesma venda duas vezes?
- Funciona com o número em coexistência, com a equipe no celular?
Uma resposta vaga na primeira já diz muito. Sem o identificador guardado na chegada, não existe o que enviar depois.
O que o Vazante faz hoje, e o que ainda não faz
Sem rodeio: o Vazante ainda não envia conversões para a Meta. Ele não manda eventos de conversa, nem de venda, de volta para as suas campanhas.
O que ele faz é a parte de leitura dessa história. O Vazante é Tech Provider (provedor de tecnologia) da Meta: com o número conectado pelo cadastro oficial, o painel mostra qual anúncio gerou cada conversa, com o custo, ao lado das métricas de Meta Ads, Google Ads e TikTok Ads. Isso responde a "qual criativo traz conversa, e a que preço", a primeira linha da tabela do exemplo. Levar a venda de volta ao algoritmo, hoje, depende de outra integração. Como essa leitura funciona no dia a dia está em qual anúncio gerou cada conversa.
O Coexistence vem incluído nos planos com assinatura ativa, a equipe continua no celular e a Meta cobra as mensagens direto da sua empresa. Veja a página do WhatsApp Coexistence e os planos.
Perguntas frequentes
O Vazante envia as vendas do WhatsApp para a Meta?
Ainda não. Hoje o Vazante mostra qual anúncio gerou cada conversa, com o custo, ao lado das métricas de mídia. Devolver a venda à Meta exige uma integração de Conversions API, que o Vazante não faz.
Qual a diferença para a Conversions API do site?
A do site envia o que acontece na página. A de mensagens comerciais envia o que acontece dentro da conversa iniciada por um anúncio de clique para o WhatsApp, o Messenger ou o Instagram, ligado ao clique por um identificador próprio.
Funciona com o número em coexistência?
Sim. A Meta afirma que clientes em coexistência podem rodar anúncios de clique para o WhatsApp e que o parceiro pode reportar compras e leads deles pela Conversions API.
Por que algumas conversas vindas de anúncio não podem ser enviadas?
Desde 20/10/2025, conversas iniciadas em anúncios no Status do WhatsApp não trazem o identificador do clique. E a conversa que começou antes de o número estar conectado não teve esse identificador guardado.