Configuração do Whatsapp - Botão e Rastreador UTM

O Whatsapp - Botão e Rastreador UTM cria uma referência de instalação para páginas que enviam visitantes ao WhatsApp. Ele pode gerar um botão pronto, enriquecer links de WhatsApp já existentes ou fazer as duas coisas.

Use este guia quando uma campanha leva o visitante para uma landing page antes da conversa no WhatsApp. Para entender quando esse rastreador é necessário, leia primeiro Rastreamento de UTM em leads e conversas WhatsApp.

Ampliar

O que o rastreador faz

Quando carregado no site, o rastreador:

• lê UTMs e click IDs da URL da página;
• mantém no site o histórico de primeiro e último contato;
• cria ou ajusta o link de WhatsApp;
• faz a origem da campanha acompanhar a mensagem inicial do WhatsApp;
• permite que a Agilize capture essa origem na primeira mensagem da conversa.

Para a atribuição funcionar, o visitante precisa enviar a mensagem pré-preenchida sem apagar o texto. Use mensagens iniciais objetivas e mantenha uma convenção de UTMs estável entre mídia, site e Agilize.

Onde acessar

Acesse https://my.agilize.app/messenger/chat/whatsappTracker.

Acesso pela tela: sidebar lateral > módulo Mensageria > Configurações > tree interna Whatsapp - Botão e Rastreador UTM.

Criar uma referência

1. Abra Whatsapp - Botão e Rastreador UTM.
2. Clique para criar uma nova referência.
3. Preencha Nome com uma identificação clara, como LP Julho - Produto A.
4. Preencha Telefone WhatsApp com DDI, DDD e número, sem sinais.
5. Preencha Mensagem inicial com o texto que aparecerá no WhatsApp.
6. Em Customizar Tracker, escolha o modo, aparência e estratégia de atribuição.
7. Salve.
8. Na visualização, copie o código de instalação e teste o botão de WhatsApp.

Campos principais

Escolher o modo de uso

No modo Interceptador e no modo Botão + Interceptador, configure Seletor de links. Esse seletor define quais links podem ser alterados pelo rastreador. Para cobrir todos os links, use a[href]. Para restringir, use algo como:

a[href*="wa.me"], a[href*="api.whatsapp.com"], a[href*="web.whatsapp.com"]

Opções do interceptador:

• Reescrever links ao carregar: ajusta links encontrados assim que o rastreador inicia.
• Reforçar no clique: tenta enriquecer o link no momento do clique, útil para páginas com JavaScript próprio.
• Observar links criados depois: acompanha links renderizados depois do carregamento inicial.

Ajustar a aparência do botão

Use os presets como ponto de partida:

Campos de aparência:

Configurar atribuição e captura

Instalar no site

Depois de salvar, abra a visualização da referência e copie o código de instalação. O snippet terá este formato:

<script>
  window.__agilizeWhatsAppTrackerConfig = {
    "autoInit": true,
    "mode": "button",
    "phone": "5511999999999",
    "text": "Olá, gostaria de saber mais.",
    "attribution": {
      "strategy": "last",
      "cookieName": "agilize_wtrk",
      "cookieDays": 90
    }
  }
</script>
<script src="https://cdn.agilize.app/module/messenger/js/whatsapp-tracker.js" async></script>

Use sempre o código copiado da tela, porque ele já vem com telefone, texto, modo e aparência configurados.

Instalar em WordPress

Opção recomendada: use um plugin de inserção de scripts no rodapé do site.

1. Abra o painel administrativo do WordPress.
2. Instale ou abra o recurso usado pelo site para inserir scripts de header/footer.
3. Cole o snippet do rastreador no rodapé, antes do fechamento da tag body.
4. Restrinja para a landing page específica quando a ferramenta permitir.
5. Publique e limpe o cache do site.
6. Abra a LP com UTMs de teste e clique no botão de WhatsApp.

Exemplo de URL para teste:

https://www.suaempresa.com.br/lp?utm_source=facebook&utm_medium=paid_social&utm_campaign=teste-whatsapp

Instalar via Google Tag Manager

Use GTM quando o time de marketing já gerencia tags por lá.

1. Crie uma tag HTML personalizado.
2. Cole o snippet completo do rastreador.
3. Configure o acionador para todas as páginas ou apenas para as LPs desejadas.
4. Publique o container.
5. Teste em modo Preview antes de divulgar a campanha.

Se o site tem outro componente criando botões de WhatsApp após o carregamento, use modo Interceptador com Observar links criados depois ativo.

Instalar em Shopify

1. No admin da Shopify, abra o tema publicado.
2. Entre na edição de código do tema.
3. Localize o arquivo base do layout, normalmente theme.liquid.
4. Cole o snippet antes de </body>.
5. Salve e teste a página com UTMs.

Se o botão precisa aparecer em uma área específica da página, crie um elemento com ID, por exemplo:

<div id="whatsapp-button"></div>

Depois configure Renderizar em seletor como:

#whatsapp-button

Instalar em Wix, Webflow e construtores similares

Em construtores visuais, procure o recurso de Custom Code, Código personalizado, Footer Code ou Before body end.

Recomendações:

• cole o snippet no final do body, não dentro de um bloco de texto comum;
• se a plataforma permite escopo por página, aplique somente nas LPs de campanha;
• se a página já tem botão WhatsApp, use Interceptador ou Botão + Interceptador;
• depois de publicar, teste em janela anônima para evitar cookie antigo.

Configurar a URL da campanha

Na plataforma de mídia, o destino do anúncio deve ser a landing page com UTMs. O link do anúncio não deve apontar direto para wa.me quando você quer capturar a jornada da LP.

Exemplo:

https://www.suaempresa.com.br/lp-whatsapp?utm_source=facebook&utm_medium=paid_social&utm_campaign=campanha-julho&utm_content=criativo-video

Quando a plataforma de mídia permitir parâmetros dinâmicos, use a convenção do seu time para preencher IDs e nomes de campanha, conjunto e anúncio. O importante é que a LP receba os parâmetros na URL antes do clique no WhatsApp.

Validar depois de instalar

1. Abra a LP em janela anônima usando UTMs de teste.
2. Confirme se o botão aparece ou se o link existente continua funcionando.
3. Clique no WhatsApp.
4. Confira se a mensagem inicial aparece preenchida.
5. Envie a mensagem sem apagar o texto.
6. Na Agilize, confirme se a sala foi criada com a mensagem limpa.
7. Gere um lead pela conversa e confira se a origem foi preservada no lead.
8. Repita o teste usando outra UTM para validar a estratégia de primeiro ou último contato.

Problemas comuns

Próximo passo

Depois de validar a captura, acompanhe os leads por origem nos relatórios e mantenha uma convenção única de UTMs entre mídia, site, webhooks e integrações.