← Todos os artigos

API de Conversões para WhatsApp e mensagens comerciais: como informar as vendas que saem do chat

Anúncios de clique para o WhatsApp são ótimos numa coisa: começar conversas. O problema é que "conversa iniciada" é a última coisa que a Meta vê. Se a pessoa reservou, pagou ou sumiu depois do "quanto custa?", fica tudo dentro do chat. Aí a Meta otimiza para quem gosta de conversar — e não para quem compra.

A resposta da Meta é uma variação da CAPI: a API de Conversões para mensagens comerciais (Conversions API for Business Messaging). Veja como ela funciona, quem pode usar e a alternativa mais simples de que muitas empresas realmente precisam.

O que é a API de Conversões para mensagens comerciais

É uma versão da CAPI para conversões que acontecem dentro de uma conversa iniciada por um anúncio de clique para mensagem no WhatsApp, Messenger ou Instagram. Você informa eventos como LeadSubmitted, QualifiedLead, Purchase ou OrderCreated, e a Meta liga esses eventos ao anúncio que iniciou a conversa.

A documentação da Meta deixa claro que esses eventos só devem representar interações dentro do chat. Conversões no site ou no app passam pela API de Conversões comum — veja O que é a API de Conversões da Meta.

O que cada evento precisa

Todo evento define action_source como business_messaging e informa o canal em messaging_channel. Além disso, cada canal tem os próprios identificadores obrigatórios:

Canal Obrigatório em user_data
WhatsAppwhatsapp_business_account_id + ctwa_clid
Messengerpage_id + page_scoped_user_id
Instagraminstagram_business_account_id + ig_sid

O ctwa_clid é o equivalente, no WhatsApp, a um identificador de clique. Ele chega no objeto referral do webhook da primeira mensagem recebida, quando alguém inicia um chat a partir de um anúncio. Se a sua configuração do WhatsApp não captura e guarda esse valor com a conversa, você não vai conseguir usar esse caminho depois.

Quem realmente pode usar

Esta é a parte que a maioria dos artigos pula. A API foi feita para parceiros de mensagens comerciais (Business Messaging Partners) — as empresas que dão acesso à Plataforma do WhatsApp Business, caixas de entrada de chat e chatbots. Eles precisam de um app de desenvolvedor da Meta com acesso avançado às permissões de eventos de mensagens. Uma empresa comum normalmente usa a API por meio do seu provedor de mensagens, e não chamando-a diretamente.

Então a pergunta prática é: o seu provedor de WhatsApp suporta a API de Conversões para mensagens comerciais? Muitos dos grandes suportam. Se o seu suporta, a configuração costuma ser ligar uma opção e associar etiquetas do chat ou etapas do funil a eventos.

Mais um detalhe da documentação da Meta: otimizar campanhas para compras com esses eventos está disponível para anúncios de WhatsApp e Messenger; anúncios de clique para mensagem no Instagram podem ser otimizados para conversas.

O caminho mais simples: leads do WhatsApp que vão para um CRM

Muitas empresas nem rodam anúncios de clique para o WhatsApp. Os anúncios levam a um formulário no site ou a um formulário instantâneo, e depois os vendedores falam com o lead no WhatsApp. Ou os chats estão conectados a um CRM como o Kommo (AmoCRM) ou o Bitrix24, em que cada conversa vira um negócio.

Nesse caso, você não precisa da API de mensagens. A conversão acontece no CRM, e o número de telefone da pessoa — que é o número de WhatsApp dela — é um identificador forte para a correspondência da Meta. Envie as etapas do CRM pela API de Conversões comum, como explicamos em Como enviar as vendas do CRM para a Meta, e a Meta aprende quais leads pagaram.

É esse o caminho que o LeadMe cobre: ele lê as etapas dos negócios no seu CRM e envia para a Meta com telefone e e-mail com hash e os identificadores de clique capturados no seu site. Ele não substitui um parceiro de mensagens para otimizar anúncios de clique para o WhatsApp — o caminho do ctwa_clid é do seu provedor de WhatsApp.

Qual caminho você precisa?

Respostas rápidas

Existe uma "API de Conversões do WhatsApp"?

Muita gente chama assim, mas oficialmente é a API de Conversões para mensagens comerciais, que cobre WhatsApp, Messenger e Instagram.

Dá para enviar vendas do WhatsApp para a Meta sem ctwa_clid?

Pela API de Conversões comum, sim — com correspondência pelo número de telefone e outros identificadores. Pela API de mensagens, não: lá o ctwa_clid é obrigatório para eventos do WhatsApp.

Funciona com o app WhatsApp Business (não a API)?

A API de mensagens depende de webhooks da Plataforma do WhatsApp Business, que o app comum não oferece. Se você usa o app, o caminho realista é o CRM.

Relacionados: API de Conversões vs Pixel da Meta · API de Conversões no LinkedIn, Snapchat e Reddit