trizup blog Testar grátis

Início→Blog→Devolver a venda

API de Conversões da Meta para quem anuncia no WhatsApp

O mapa de devolver a venda à Meta no WhatsApp: o que ela não enxerga, qual evento e valor enviar, como o ctwa_clid liga a venda ao anúncio e como conferir.

Compartilhar
SF Sylas Filho · 12 min de leitura

Siga o caminho de uma pessoa que clica no seu anúncio de clique para WhatsApp. A Meta vê a impressão, vê o clique e vê a conversa abrir. A partir daí, a visão acaba. Ela não sabe se o lead respondeu ao vendedor, se pediu orçamento, se sumiu no terceiro dia ou se pagou por PIX na semana seguinte. Tudo isso acontece dentro de um chat que a plataforma não lê.

Essa ausência tem consequência em cadeia. Sem saber quem comprou, a Meta otimiza para o último evento que conhece: a conversa iniciada. Quem inicia conversa com mais facilidade nem sempre é quem compra. O custo por conversa melhora, o caixa do cliente não, e o relatório da campanha passa a contar uma história que o balcão desmente.

Este texto é o mapa de como fechar esse buraco: o que a plataforma sabe e não sabe, o que é a API de Conversões, o que muda quando a venda mora no WhatsApp, qual evento e qual valor devolver, como o anúncio é ligado à venda, o que costuma dar errado e como conferir se está chegando. Em cada ponto que tem texto próprio, você recebe o essencial aqui e o link para aprofundar.

O que a plataforma sabe e o que ela não sabe sozinha

A Meta sabe tudo que acontece dentro dos próprios sistemas: quem viu, quem clicou, quem abriu a conversa. Também sabe o que o pixel contou, quando existe um site. O que ela não sabe é o que o seu cliente registrou depois: a venda fechada por vendedor, o pagamento confirmado dias depois, o orçamento que não avançou.

O sistema de entrega aprende só com os eventos que recebe. Cada evento é um exemplo de "esse perfil de pessoa produz isso", e a entrega busca mais gente parecida. Se o evento mais fundo que chega é "iniciou conversa", é esse o perfil que a campanha aprende a procurar.

Destaque

"lead ruim" costuma ser o nome que o gestor dá à diferença entre o evento que a campanha otimizou e a venda que ele queria. A Meta cumpriu o pedido. O pedido é que ficou raso.

O mecanismo, a conta de custo por venda e o trade-off de volume estão em Por que a Meta otimiza para lead que não compra. O que importa para o mapa: o remédio é contar de volta o que aconteceu depois da conversa. E contar de volta tem um canal próprio.

Erro comum desta etapa: tratar o relatório da campanha como termômetro de qualidade. Ele mede o que a plataforma enxerga. Sem sinal de venda, um custo por conversa baixo pode ser sintoma de problema, não de acerto.

O que é a API de Conversões e por que ela existe

A API de Conversões é o envio de eventos feito pelo seu lado, de servidor para servidor. Segundo a documentação da Meta, os eventos partem do servidor do anunciante, de uma plataforma de site, de um app ou de um CRM. Quem manda é um sistema que sabe da venda, não o navegador de quem visitou a página.

Isso a diferencia do pixel, que é um código rodando no navegador do visitante. O pixel só existe onde há uma página carregada. A API existe onde houver um sistema que registrou o fato. Os dois carregam o mesmo tipo de informação (evento, hora, valor, dados para identificar a pessoa), mas saem de pontos diferentes da cadeia.

Para site, a orientação da Meta é usar a API além do pixel, com os mesmos eventos nos dois lados, e deduplicar por identificador do evento e nome do evento. Segundo a página da Meta sobre eventos duplicados, a deduplicação só acontece se os dois eventos chegarem dentro de 48 horas. A comparação completa, a tabela do que cada um perde e os motivos de contagem em dobro estão em Pixel ou API de Conversões: o que cada um enxerga.

Erro comum desta etapa: entender "ligue a API" como "troque o pixel". Para site, a recomendação é redundância. Para WhatsApp, como a próxima seção mostra, o pixel nem entra na conversa.

O caso do WhatsApp: a venda acontece onde o pixel não chega

No anúncio de clique para WhatsApp não há página de destino, carrinho nem confirmação num navegador. A pessoa clica e cai numa conversa. A venda se fecha ali, às vezes dias depois, às vezes com o preço combinado em áudio. O lugar onde a venda acontece não carrega pixel.

A documentação da Meta para mensagens comerciais descreve o desenho para esse caso. O evento de conversa usa action_source igual a business_messaging, com o canal identificado em messaging_channel (no caso, whatsapp). A página afirma que eventos de mensagem devem representar apenas interações que ocorrem dentro da conversa, e que conversão de site segue pelo caminho de site.

Na prática, três coisas mudam para quem anuncia para WhatsApp:

  1. A pergunta "pixel ou API?" já vem respondida. Para a venda de conversa, só o servidor serve.
  2. O medo de conversão em dobro encolhe, porque não há pixel disparando a mesma venda. O risco que sobra é o mesmo evento enviado duas vezes pelo mesmo caminho, por duas ferramentas ou por reenvio.
  3. O trabalho de verdade é capturar e guardar o identificador do clique, assunto de uma das seções adiante.

Há também o caso misto: a campanha leva a uma página, e dali ao WhatsApp. O pixel mede o topo (visita, clique no botão) e a API de mensagens mede o fundo. São momentos diferentes do funil, não o mesmo evento visto por dois lados. O cuidado é não dar o mesmo nome de conversão a dois momentos.

Erro comum desta etapa: instalar pixel e esperar que ele registre a venda fechada no chat. Ele registra, no máximo, a visita à página que antecede o clique no botão.

Qual evento devolver e com que valor

Existe uma escada de eventos: conversa iniciada, lead qualificado, proposta enviada, venda. Quanto mais fundo o degrau, mais raro o evento e mais forte o filtro que ele aplica sobre o público. A regra prática é devolver o evento mais profundo que ainda gere sinal suficiente, e não o mais profundo que existe.

O raciocínio do volume é simples. O sistema precisa de uma quantidade mínima de eventos para estabilizar a entrega, e negócio local com ticket alto fecha poucas vendas por semana. Otimizar direto para venda pode deixar o conjunto sem sinal. Um evento intermediário (lead qualificado, orçamento enviado) costuma ocorrer em volume suficiente e já filtra melhor que "iniciou conversa". Não cito o piso numérico aqui: ele muda com o tipo de campanha e com o tempo, então confira o vigente no status do conjunto no Gerenciador de Anúncios.

A decisão de qual degrau escolher, e como definir o que é um lead qualificado de modo que a equipe do cliente marque igual todo dia, está em Lead qualificado no WhatsApp com tráfego pago. Trocar o evento também pede combinar a expectativa com o cliente: o custo por conversa sobe e o volume cai antes de a venda por real investido melhorar. Quem abandona no fundo desse vale reinicia o ciclo.

O valor, e por que ele pesa mais que o evento

Quando o evento leva valor, a plataforma usa esse número para decidir que tipo de cliente vale mais. Valor errado ensina a lição errada, em escala. As falhas mais comuns são o valor lido em formato errado (o texto "1.500,00" interpretado como 150000, ou centavos tratados como reais), o valor fixo que ignora a diferença entre o pacote grande e o básico, e a moeda do evento diferente da moeda da conta.

Uma verificação que custa pouco: some o valor enviado à Meta num período e compare com o faturamento que o cliente informa para o mesmo período. Muito acima, há inflação. Muito abaixo, há venda que não está voltando. Faça isso antes de a verba depender do sinal.

Evento enviado com valor errado não é retratado com facilidade. A correção vale dali em diante, e o sistema aprendeu com o dado ruim durante o período. Por isso: poucos eventos para validar, depois a verba.

Erro comum desta etapa: escolher o evento pelo que parece mais importante para o cliente, e não pelo que alcança volume. O segundo erro, mais caro, é mandar valor sem conferir contra o caixa.

Como a atribuição liga a venda ao anúncio

Devolver "uma venda" sem dizer de qual clique ela veio serve de pouco. O que liga a venda ao anúncio, no WhatsApp, é o ctwa_clid, o identificador do clique para WhatsApp. Segundo a documentação da Meta, ele vem no objeto referral do webhook de mensagens, é único por clique, deve ser guardado junto com a conversa e enviado em user_data quando a conversão acontece.

Isso desenha o fluxo inteiro:

  1. A pessoa clica no anúncio e manda a primeira mensagem. O referral chega com o ctwa_clid.
  2. Alguém (um sistema seu) guarda o identificador amarrado àquela conversa.
  3. Dias depois, a venda é marcada.
  4. O sistema envia o evento à API de Conversões, com o ctwa_clid em user_data.

A Meta recomenda enviar o ctwa_clid sempre que ele existir, porque casa com mais confiabilidade que dados do cliente com hash. Sem ele, dá para mandar telefone ou e-mail com hash e a Página, mas a documentação avisa que esse casamento não é garantido, atribui só eventos dos últimos sete dias e está disponível num subconjunto de países.

O ponto sensível é o passo 2. O identificador chega na primeira mensagem vinda do anúncio. Se o sistema que recebe as mensagens não o guarda, ou se a pessoa já tinha conversado antes com o número, a venda perde o elo com o anúncio. Como ler o identificador, onde ele aparece e por que algumas conversas chegam sem ele estão em CTWA: como saber de qual anúncio veio cada conversa.

O Google funciona diferente, e vale não misturar. No clique do Google, o identificador não vem dentro da mensagem do WhatsApp: ele precisa ser carregado por um link ou por uma página até a conversa. Para quem roda as duas plataformas, o caminho da venda ao Google está em Conversão offline no Google Ads com venda do WhatsApp, e a diferença entre os três identificadores, em gclid, gbraid e wbraid: a diferença e quando cada um vale.

Erro comum desta etapa: tratar atribuição como algo que se resolve na hora de enviar. Ela se decide na primeira mensagem, quando o identificador chega ou não.

O que dá errado com mais frequência

Quase todo problema de devolução cai numa destas famílias.

Venda que nunca vira evento. A venda foi anotada numa planilha, num caderno ou na cabeça do vendedor, e ninguém a converte em envio. É a falha silenciosa: o relatório não mostra erro, mostra ausência. O sinal é o número de vendas do cliente bem acima do número de eventos de compra.

Evento recusado na entrada. O envio acontece, mas a Meta o rejeita. As causas típicas são token expirado, Página ou conjunto de dados mal configurados e campo obrigatório faltando. Se o sistema que envia não mostra a falha, o gestor só descobre semanas depois.

Conversão em dobro. A mesma venda sai duas vezes: reenvio de lote, duas ferramentas configuradas para o mesmo evento ou, em campanha que passa por site, pixel e API sem identificador comum. O sintoma é o inverso do primeiro: o Gerenciador mostra mais do que o cliente vendeu.

Valor errado. Descrito na seção de valor: formato de número, moeda, valor fixo que não representa o ticket.

Identificador ausente. O evento chega, mas sem o ctwa_clid, e perde a ligação com o anúncio. A Meta recebe um sinal sem dono.

Evento atrasado. Venda que demora a ser marcada, ou lote enviado de uma vez no fim do mês. O casamento e a deduplicação têm janelas, e evento fora delas perde força. Enviar perto do fato é mais seguro que acumular.

Esta lista é leitura do mecanismo e da documentação, não uma tabela de frequência. Não conheço dado público sobre qual causa pesa mais, e não vou ordenar por um peso que não medi.

Erro comum desta etapa: olhar só a falha visível. O dano maior costuma vir das que não aparecem como erro: a venda que não saiu e o valor que saiu errado.

Como conferir se está chegando

Conferir tem três camadas, e cada uma responde a uma pergunta diferente.

  1. O evento chegou? No Events Manager, abra o conjunto de dados e veja se o evento de compra aparece, vindo de mensagens, no volume esperado. Se não aparece nada, o problema está antes do envio. Eu não confirmei na documentação o texto exato das telas de diagnóstico, então não cito rótulos.
  2. Chegou ligado ao anúncio? Compare o volume de eventos com o de conversas que tinham ctwa_clid. Evento que chega sem identificador entra, mas sem a atribuição que você queria.
  3. Bate com o caixa? Pegue um período fechado, some o valor dos eventos e confronte com o faturamento informado pelo cliente. Compare também a contagem de vendas. Diferença grande para cima ou para baixo é pista de duplicidade, de valor errado ou de venda que não voltou.

Faça a terceira conferência em semanas, não em meses. Venda leva dias para fechar, então o fechamento de uma semana só estabiliza na seguinte. Não conclua que a devolução "não funciona" olhando a coluna de resultados do Gerenciador no dia seguinte: o evento pode ter sido enviado e ainda estar processando, ou a venda pode ter fechado depois do corte do relatório.

Quando o cliente pergunta se está funcionando, a resposta honesta é um número de vendas e um de valor, com período e fonte, ao lado do que o caixa dele registra. Como montar essa apresentação de modo que o cliente a entenda está em Como provar resultado ao cliente sem ele atualizar o CRM.

Erro comum desta etapa: conferir só se o evento "foi enviado". Enviado não é recebido, e recebido não é atribuído.

Resumo do mapa

EtapaErro mais comumOnde aprofundar
O que a plataforma sabe e não sabeLer custo por conversa baixo como sinal de qualidadePor que a Meta otimiza para lead que não compra
O que é a API de ConversõesAchar que ela substitui o pixel em sitePixel ou API de Conversões: o que cada um enxerga
O caso do WhatsAppEsperar que o pixel registre a venda fechada no chatPixel ou API de Conversões: o que cada um enxerga
Qual evento e qual valorEscolher o evento sem olhar o volume; enviar valor sem conferir com o caixaLead qualificado no WhatsApp com tráfego pago
Atribuição ao anúncioResolver na hora do envio o que se decide na primeira mensagemCTWA: como saber de qual anúncio veio cada conversa
O que dá erradoOlhar só a falha visível e ignorar a venda que não saiuPor que a Meta otimiza para lead que não compra
Como conferirParar em "foi enviado"Como provar resultado ao cliente sem ele atualizar o CRM
Mesma lógica no GoogleSubir venda sem identificador de cliqueConversão offline no Google Ads com venda do WhatsApp

A Meta vai ficar boa em achar o que você contar a ela que importa. O trabalho do gestor, do primeiro clique à última conferência, é decidir o que contar, contar certo e provar que contou.