📊 Manual do Plugin WA Cliques TS9

Versão 1.1.1 – por TS9 Marketing Digital

O que é

O WA Cliques TS9 é um plugin WordPress desenvolvido pela TS9 Marketing Digital que contabiliza cliques em botões e links do WhatsApp no seu site. Ele identifica tanto cliques em links diretos (api.whatsapp.com / wa.me) quanto o botão do Join.chat que realmente abre o WhatsApp (joinchat__open).

Com ele, você sabe exatamente quantas pessoas clicaram para conversar via WhatsApp — uma métrica essencial para medir conversões de campanhas e páginas de vendas.

Principais Recursos

• ✅ Contagem automática de cliques em links e botões do WhatsApp.
• ✅ Compatível com Join.chat (apenas o clique que abre o app).
• ✅ Relatório completo no painel administrativo.
• ✅ Filtros de período: Hoje, Ontem, 7, 30 e 90 dias.
• ✅ Shortcodes para exibir resultados no site.
• ✅ Exportação CSV e botão de limpar registros.

Como instalar

1. Vá em Plugins → Adicionar novo → Enviar plugin.
2. Envie o arquivo WA-Cliques-TS9-v1.1.1.zip.
3. Clique em Ativar plugin.
4. Acesse o menu lateral WA Cliques TS9 no painel do WordPress.

Como funciona

Após ativado, o plugin adiciona automaticamente um pequeno script ao seu site que detecta cliques em links e botões de WhatsApp. Cada clique válido é salvo no banco de dados e pode ser visualizado no relatório do painel.

Para o Join.chat, apenas o botão que realmente abre o WhatsApp é contabilizado (.joinchat__open), evitando contagem duplicada.

Relatórios no painel

Acesse WA Cliques TS9 → Relatório para visualizar os resultados.

• Filtros: Hoje, Ontem, 7 dias, 30 dias, 90 dias.
• Tabela: Exibe a página de origem, link, total de cliques, primeiro e último registro.
• Total: Mostra o número total de cliques no período.

Diagnóstico

Em WA Cliques TS9 → Diagnóstico, você encontra:

• Status do plugin e do REST API.
• Botão Exportar CSV (baixa todos os registros).
• Botão 🧹 Zerar registros (apaga todos os dados com confirmação).

Shortcodes

Use os shortcodes abaixo para exibir contadores no site (em qualquer página, post ou widget do Elementor).

Contador simples (sem filtros)

WhatsApp cliques: 5 (últimos 30 dias)

Contador por página

WhatsApp cliques: 5 (últimos 30 dias)

Contador com filtros (botões Hoje/7/30/90 dias)

Período:Todo períodoHojeOntem7 dias30 dias90 dias 
  
    
      Alterar período
    
  
  
    
      Atualizar
    
  
WhatsApp cliques: 5 (últimos 30 dias, do site)

Como usar no Elementor

1. Abra a página desejada no Elementor.
2. Adicione um widget do tipo Shortcode.
3. Cole o código desejado (exemplo:
   Período:Todo períodoHojeOntem7 dias30 dias90 dias Alterar período Atualizar
   WhatsApp cliques: 5 (últimos 30 dias, do site)
   ).
4. Salve e atualize a página.

Dica: se o shortcode aparecer como texto, reative o plugin e limpe o cache do site/CDN.

Como zerar os resultados

Vá até WA Cliques TS9 → Diagnóstico e clique em 🧹 Zerar registros.

Isso apaga todos os cliques registrados (útil após testes).

Exportação de dados

Em Diagnóstico, clique em Exportar CSV para baixar um arquivo com as colunas:

• ID
• Post/Page ID
• Link (href)
• Referrer
• User Agent
• IP Hash (anonimizado)
• Data/Hora do clique

Privacidade

O plugin não coleta informações pessoais. O IP é anonimizado (hash SHA256), garantindo conformidade com a LGPD. Nenhum dado sensível é armazenado.

Problemas comuns

• Shortcode não funciona: use o widget “Shortcode” e não texto comum.
• Join.chat conta dois cliques: atualize para a versão 1.1.1 (corrige isso).
• Não conta Join.chat: verifique se o botão tem a classe joinchat__open.

Créditos

Desenvolvido por TS9 Marketing Digital
http://ts9.com.br