Toda vez que um visitante preenche o botão de WhatsApp e o lead é capturado com sucesso, o botão dispara automaticamente um evento no dataLayer da página:
window.dataLayer.push({ event: 'WhatsAppButton' });Esse evento é o "gancho" que você usa no Google Tag Manager (GTM) para contar cada lead como uma conversão — e assim otimizar suas campanhas de Google Ads, GA4 ou Meta com base em quem realmente iniciou uma conversa. Este artigo mostra como criar essa conversão do zero.
Importante: o evento só é disparado quando o lead é salvo com sucesso — ou seja, depois de o botão validar que a página está em um domínio autorizado. Se o botão não estiver capturando leads, resolva isso primeiro (veja o artigo de instalação sobre domínios e URLs de preview) antes de configurar a conversão.
Antes de começar
O botão de WhatsApp deve estar instalado e capturando leads normalmente no seu site.
Você precisa ter o Google Tag Manager instalado no site (o container GTM-XXXXXXX no
<head>e no<body>).Tenha em mãos os dados da conversão de destino: o ID/rótulo de conversão do Google Ads, o evento do GA4 ou o pixel do Meta, conforme onde você quer registrar.
Passo 1 — Criar o acionador (evento personalizado)
O acionador é o que "escuta" o evento do botão. No GTM:
No menu lateral, abra Acionadores (Triggers) e clique em Novo.
Dê um nome ao acionador, por exemplo: Lead - WhatsAppButton.
Clique em Configuração do acionador e escolha o tipo Evento personalizado (Custom Event).
No campo Nome do evento, digite exatamente:
WhatsAppButtonAtenção: o nome diferencia maiúsculas de minúsculas. Precisa ser
WhatsAppButton— com W, A e B maiúsculos, sem espaços. Qualquer variação (comowhatsappbutton) não vai funcionar.Mantenha a opção Este acionador é disparado em Todos os eventos personalizados.
Clique em Salvar.
Passo 2 — Criar a tag de conversão
Agora crie a tag que efetivamente registra a conversão e associe-a ao acionador do Passo 1. Escolha o cenário que corresponde à sua ferramenta.
Opção A — Conversão do Google Ads
Vá em Tags → Novo e nomeie, ex: Google Ads - Conversão WhatsApp.
Em Configuração da tag, escolha Acompanhamento de conversões do Google Ads.
Preencha o ID de conversão e o Rótulo de conversão (você obtém esses valores no painel do Google Ads, ao criar uma ação de conversão do tipo "Importar"/"Manual do site").
Em Acionamento, selecione o acionador Lead - WhatsAppButton.
Salve.
Dica: se ainda não tiver o tag do Google Ads no site, adicione também a tag Configuração do Google (Google Tag) disparando em "All Pages", para que o acompanhamento funcione.
Opção B — Evento de conversão no GA4
Vá em Tags → Novo e nomeie, ex: GA4 - Evento gerar_lead.
Em Configuração da tag, escolha Google Analytics: evento do GA4.
Selecione sua tag de configuração do GA4 (ou informe o ID de medição).
No Nome do evento, use algo padronizado como
generate_lead(ougerar_lead).Em Acionamento, selecione Lead - WhatsAppButton e salve.
No GA4, marque esse evento como conversão / evento principal (em Admin → Eventos).
Opção C — Conversão do Meta (Facebook / Instagram)
Vá em Tags → Novo. Se você usa um template do Meta Pixel da galeria de modelos, selecione-o; caso contrário, use uma tag de HTML personalizado com o
fbq('track', 'Lead').Configure o evento como Lead (evento padrão do Meta).
Em Acionamento, selecione Lead - WhatsAppButton e salve.
Passo 3 — Testar no modo Visualizar (Preview)
No GTM, clique em Visualizar (Preview), no canto superior direito.
Informe a URL do seu site publicado (não a tela de edição do construtor) e conecte.
Na página, clique no botão de WhatsApp e preencha um lead de teste como um visitante faria.
Na janela do Tag Assistant, confirme que:
o evento WhatsAppButton aparece na linha do tempo de eventos (à esquerda);
a sua tag de conversão aparece em Tags Fired (disparadas) naquele evento.
Se o evento não aparecer, revise: o botão está realmente capturando o lead (chegou na sua lista de leads?) e o nome do evento no acionador está escrito exatamente como WhatsAppButton.
Passo 4 — Publicar
Com o teste OK, volte ao GTM e clique em Enviar (Submit) → Publicar. Dê um nome à versão (ex: "Conversão botão WhatsApp") e confirme. A partir daí, cada lead capturado pelo botão passa a contar como conversão na ferramenta configurada.
Perguntas frequentes
O evento envia valor ou dados do lead? Não. O evento carrega apenas event: 'WhatsAppButton', sem parâmetros adicionais. Ele serve para marcar a conversão. Se precisar atribuir um valor fixo à conversão, configure isso na própria tag (no Google Ads/GA4).
Em que momento exato ele dispara? Logo após o lead ser salvo com sucesso e imediatamente antes do redirecionamento para o WhatsApp. Como o redirecionamento é rápido, sempre valide pelo modo Visualizar do GTM, e não "no olho".
Preciso do GTM para o botão funcionar? Não. O botão captura leads de forma independente. O GTM é necessário apenas se você quiser transformar esses leads em conversões nas suas plataformas de anúncio.
Resumindo: o botão empurra o evento WhatsAppButton para o dataLayer a cada lead capturado. No GTM, crie um acionador de Evento personalizado com esse nome exato, associe-o a uma tag de conversão (Google Ads, GA4 ou Meta), teste no modo Visualizar e publique.