Vazante
EntrarComeçar

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:

  1. O cliente toca no anúncio e manda a primeira mensagem.
  2. O sistema ligado à API recebe o aviso e guarda o identificador junto da conversa.
  3. A conversa segue, com a equipe no app ou com um robô. Dias depois, a venda fecha.
  4. Alguém, ou algum sistema, registra que a venda aconteceu.
  5. 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.
  6. 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:

MomentoEventos
Interesse e leadViewContent, LeadSubmitted, QualifiedLead
CompraAddToCart, InitiateCheckout, CartAbandoned, Purchase
PedidoOrderCreated, OrderShipped, OrderDelivered, OrderCanceled, OrderReturned
AvaliaçãoRatingProvided, 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 AAnúncio B
Gasto na semanaR$ 800R$ 800
Conversas8040
Custo por conversaR$ 10R$ 20
Vendas26
Custo por vendaR$ 400R$ 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

  1. Vocês guardam o identificador do clique no momento em que a primeira mensagem chega?
  2. Quais dos 14 eventos vocês enviam, e o que dispara cada um?
  3. Para qual conjunto de dados os eventos vão, e como eu confiro que chegaram?
  4. Como vocês evitam mandar a mesma venda duas vezes?
  5. 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.

Leia também