Documentação do Chat Analytics

Guia completo para instalar, configurar e tirar o máximo do BW4TEC Chat Analytics. Do básico da instalação até a configuração avançada de LGPD, dashboard e exportação de dados.

1 Requisitos do Sistema

Antes de instalar o Chat Analytics, confirme que seu ambiente atende aos requisitos mínimos:

  • WordPress: versão 6.2 ou superior
  • PHP: versão 7.4 ou superior (recomendado 8.0+)
  • MySQL: versão 5.7 ou superior
  • Links do WhatsApp: devem estar no formato https://wa.me/SEUNUMERO
⚠️ Atenção ao formato do link:
O plugin rastreia exclusivamente links no formato https://wa.me/55DDDNUMERO. Links antigos como api.whatsapp.com/send?phone=... NÃO são capturados.

2 Como Instalar o Plugin

Método 1 — Pelo Painel do WordPress

Passo 1

Acesse o painel do WordPress e vá em Plugins → Adicionar Novo.

Passo 2

No campo de busca, digite "BW4TEC Chat Analytics".

Passo 3

Clique em Instalar Agora e depois em Ativar.

✅ Pronto!
Após a ativação, você verá o menu "Chat Analytics BW4TEC" no painel lateral esquerdo do WordPress.

3 Ativação da Licença PRO

Se você adquiriu a versão PRO, siga o fluxo abaixo. Ele começa com uma etapa de segurança antes de instalar o PRO e termina com a ativação via Freemius.

🚨 ATENÇÃO — Faça backup dos dados da versão Free antes de continuar
Ao trocar do Free para o PRO, o plugin é substituído por uma versão diferente. Para garantir que você não perca nenhum dado histórico (cliques, filtros, relatórios), siga os passos abaixo na ordem correta.

3.1 — Exportar dados da versão Free (Segurança)

Antes de qualquer coisa, exporte um CSV com todos os cliques registrados até agora:

Passo 1

No painel do WordPress, acesse Chat Analytics BW4TEC → Log Completo de Cliques.

Passo 2

Clique no botão ⬇ Exportar CSV (canto superior direito do log).

Passo 3

Salve o arquivo CSV em local seguro (seu computador, Google Drive, etc.). Este arquivo contém todo o histórico de cliques da versão Free.

💡 Por que fazer isso: Garante que, mesmo se algo der errado durante a migração, você tem os dados preservados para consulta futura.

3.2 — Desativar e remover a versão Free

Agora você precisa remover a versão Free antes de instalar o PRO. Os dois plugins não podem coexistir.

Passo 1

No painel do WordPress, acesse Plugins → Plugins Instalados.

Passo 2

Localize BW4TEC Chat Analytics (versão Free) e clique em Desativar.

Passo 3

Após desativar, clique em Excluir e confirme a remoção.

⚠️ Importante:
A exclusão remove arquivos e tabelas do banco de dados da versão Free. Por isso a exportação CSV do passo 3.1 é essencial — sem ela, o histórico é perdido permanentemente.

3.3 — Instalar e ativar a versão PRO

Com a versão Free removida, instale o PRO normalmente:

Passo 1

Acesse Plugins → Adicionar Novo → Enviar Plugin.

Passo 2

Selecione o arquivo bw4tec-chat-analytics-pro.zip (disponível na sua conta do Freemius após a compra) e clique em Instalar Agora.

Passo 3

Clique em Ativar Plugin.

3.4 — Ativar a licença via Freemius

Ao ativar o plugin PRO pela primeira vez, o Freemius exibe automaticamente uma tela de conexão. Você tem duas formas de ativar:

Opção A — Via conta Freemius (recomendado)

Na tela que aparece, clique em "Conectar" e faça login com o mesmo e-mail usado na compra. O Freemius reconhece a licença automaticamente e ativa o plugin.

Opção B — Via chave de licença

Se preferir, clique em "Usar uma chave de licença" e cole a chave recebida por e-mail no momento da compra. O plugin valida online e ativa.

Print da tela de ativação Freemius

Tela de ativação do Freemius no painel do WordPress

Tela de ativação via Freemius — conecte sua conta ou use a chave de licença.

💡 Dica: Se você comprou usando o e-mail do seu site WordPress, a ativação via conta Freemius é instantânea — sem precisar copiar chave nenhuma.
⚠️ Uma licença por domínio:
Cada licença PRO é válida para um único domínio. Para usar em múltiplos sites, adquira licenças adicionais.

3.5 — Após ativar

Depois da ativação, você verá:

  • ✅ Todos os recursos PRO liberados no dashboard (gráficos, rankings Top 10, balão CTA, horário comercial)
  • ✅ Status da licença em Chat Analytics BW4TEC → Conta como "Ativa"
  • ✅ Aviso de renovação automática gerenciado pelo Freemius (não precisa fazer nada)

4 Configuração Inicial

Após ativar o plugin, acesse Chat Analytics BW4TEC → Configurações para ajustar os parâmetros básicos.

4.1 — Número do WhatsApp

Configure o número de WhatsApp que será usado no botão flutuante:

  • Formato aceito: 5511999999999 (código do país + DDD + número)
  • Não use espaços, parênteses ou traços

4.2 — Mensagem Padrão

Define a mensagem pré-preenchida quando o cliente clica no botão:

Olá! Vim pelo site e gostaria de mais informações.

4.3 — Configurações Globais (GeoIP e LGPD)

⚠️ Recomendações LGPD:
• GeoIP: mantenha DESATIVADO por padrão (envia IP para serviço externo)
• Anonimização de IP: mantenha ATIVADA (mascara o último octeto antes de salvar)
  • Recursos GeoIP: consulta cidade, estado e país via ipwho.is
  • Anonimizar IPs: transforma 192.168.1.100 em 192.168.1.0
  • Limpeza automática: apaga registros antigos após 30, 90, 180 ou 365 dias

Print das Configurações Globais

Configurações Globais de GeoIP e anonimização de IP no Chat Analytics

Tela de Configurações Globais com as opções de GeoIP e anonimização de IP.

5 Configuração do Botão Flutuante

📌 Nota importante: O botão flutuante é um recurso disponível tanto na versão Free quanto na PRO, mas ele NÃO vem ativado por padrão. Após instalar e ativar o plugin, acesse as Configurações e marque a opção "Ativar botão flutuante". Na versão PRO, você também pode personalizar o balão CTA e outras opções avançadas.

O plugin inclui um botão flutuante nativo do WhatsApp, que pode ser exibido em qualquer página do site.

Como configurar:

  • Ativar botão flutuante: marque para exibir
  • Posição: inferior direito (padrão) ou inferior esquerdo
  • Mensagem padrão: texto que acompanha a conversa
  • Balão CTA (PRO): mensagem ao lado do botão, ex: "Precisa de ajuda?"

Print do Botão Flutuante e Modal de QR Code

Botão flutuante do WhatsApp exibido no canto inferior direito do site Modal de QR Code do WhatsApp aberto no desktop

Botão flutuante (esquerda) e modal de QR Code no desktop (direita).

📱 Modal de QR Code:
No desktop, ao clicar no botão, abre-se um modal com QR Code para que o visitante escaneie com o celular. No mobile, abre o WhatsApp diretamente.

6 Usando o Dashboard

Acesse Chat Analytics BW4TEC → Dashboard & Relatórios para visualizar as métricas.

6.1 — KPIs Principais

  • Total de Cliques: todos os cliques registrados no período
  • Válidos: cliques de visitantes reais (não bots)
  • Bots/Suspeitos: cliques classificados pelo motor de detecção
  • IPs Únicos: visitantes diferentes

6.2 — Filtros

Você pode filtrar os dados por:

  • Período (últimos 7, 30, 90 dias ou personalizado)
  • Número do WhatsApp
  • Cidade e Estado (requer GeoIP ativo)

6.3 — Gráficos e Relatórios (PRO)

  • Gráfico de volume: evolução dos últimos 7 dias
  • Top 10 Páginas: quais URLs geram mais cliques
  • Top 10 Cidades: origem geográfica dos cliques
  • Top Posições: flutuante vs conteúdo vs cabeçalho
  • Médias de UX: Time to Click e Scroll Depth

Prints do Dashboard e Relatórios

Gráfico de volume de cliques no dashboard do Chat Analytics Relatórios do dashboard com KPIs e métricas

Gráfico de volume (esquerda) e painel de relatórios (direita).

Rankings Top 10 (PRO)

Ranking Top 10 de artigos e páginas que mais geram cliques Ranking Top 10 de cidades que mais geram cliques

Top 10 artigos/páginas (esquerda) e Top 10 cidades (direita).

Métricas de UX e Posições de Clique

Médias de Scroll Depth e Time to Click no dashboard Ranking de posições de clique: flutuante, conteúdo, cabeçalho e rodapé

Métricas de UX (esquerda) e posições de clique (direita).

7 Log de Cliques

A aba Log Completo de Cliques mostra cada clique registrado com todos os detalhes:

  • Data e hora
  • Número de WhatsApp clicado
  • Página de origem
  • Posição do botão (flutuante, conteúdo, cabeçalho, rodapé)
  • IP (anonimizado se a opção estiver ativa)
  • Navegador e sistema operacional
  • Origem UTM (source, medium, campaign)
  • Score de risco (Seguro / Suspeito / Alto Risco)

Prints do Log e Filtros

Tabela de log completo de cliques do Chat Analytics Filtros avançados do log por período, telefone, cidade e estado

Log de cliques (esquerda) e filtros disponíveis (direita).

💡 Paginação:
Use o seletor no topo do log para exibir 50, 250 ou 500 registros por página.

8 Exportação CSV

Exporte todos os dados do log para uma planilha em Excel ou Google Sheets.

Como exportar:

  1. Acesse Chat Analytics BW4TEC → Log Completo
  2. Aplique os filtros desejados (opcional)
  3. Clique no botão verde ⬇ Exportar CSV
  4. O download do arquivo começará automaticamente
✅ Sem limites:
A exportação é ilimitada tanto na versão Free quanto na PRO. Todos os registros filtrados são exportados.

9 LGPD e Privacidade

O Chat Analytics foi projetado com a LGPD em mente. Aqui estão as configurações recomendadas:

9.1 — Anonimização de IP (recomendado)

Mascara automaticamente o último octeto do IP antes de salvar no banco:

IP original: 192.168.1.100
IP salvo:    192.168.1.0

O IP original ainda é usado para consulta GeoIP, mas não fica armazenado.

9.2 — Consentimento de Cookies

Suporte a plugins de consentimento populares:

  • CookieYes: cookieyes-consent
  • Complianz: complianz_consent_status
  • Real Cookie Banner: real_cookie_banner-consent

Marque a opção "Ativar rastreamento apenas após consentimento" e insira o nome exato do cookie.

9.3 — Limpeza Automática

Configure a exclusão automática de registros antigos:

  • 30, 90, 180 ou 365 dias
  • Ou "manter sempre" (não recomendado para LGPD)
⚠️ Você é o Controlador dos Dados:
Como dono do site, você é o responsável legal pela conformidade com a LGPD. Recomendamos consultar um advogado especializado.

10 Resolução de Problemas

❌ O plugin não está registrando cliques

Causas prováveis:

  • Os links do WhatsApp não estão no formato https://wa.me/
  • O consentimento de cookies está ativo, mas o visitante não aceitou
  • O cache do site está servindo versão antiga das páginas
  • Há um plugin de segurança bloqueando a API REST

Solução:

  1. Verifique se os links do site usam wa.me
  2. Se o consentimento estiver ativo, aceite os cookies e faça um teste
  3. Limpe o cache do site (LiteSpeed, WP Rocket, etc.)
  4. Verifique se o endpoint /wp-json/bw4tec-wa/v1/click está acessível

❌ Os gráficos não aparecem no Dashboard PRO

Causas prováveis:

  • Conflito com outros plugins que carregam o Chart.js
  • Erro de JavaScript no console (F12)

Solução:

  1. Abra o Console (F12) e verifique se há erros
  2. Desative plugins de otimização/JS temporariamente
  3. Entre em contato com o suporte com o print do console

❌ A licença PRO aparece como "Inválida"

Causas prováveis:

  • O domínio do site foi alterado
  • A licença já está ativa em outro domínio
  • Sem conexão com o servidor do Freemius

Solução:

  1. Verifique se o domínio corresponde à licença
  2. Desconecte e reconecte a conta Freemius
  3. Acesse Chat Analytics BW4TEC → Conta e clique em Sync

11 Suporte

Não encontrou a resposta que precisava? Fale com a nossa equipe.

⏰ Horário de atendimento:
Segunda a Sexta, das 9h às 18h (Horário de Brasília).
Suporte prioritário PRO: resposta em até 24h úteis.