Documentação Técnica e Guia de Uso 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.

1Requisitos do Sistema

Resposta direta: O BW4TEC Chat Analytics exige WordPress 6.2+, PHP 7.4+ e links no formato wa.me para funcionar corretamente.

  • 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.

2Download, Instalação e Ativação

Resposta direta: Baixe a versão gratuita pelo diretório oficial do WordPress (Plugins → Adicionar Novo) e ative; a licença PRO é ativada via Freemius pelo link "Licença" abaixo do plugin em Plugins Instalados.

Instalação pelo painel do WordPress (Versão Gratuita)

Passo 1

No painel administrativo do seu WordPress, acesse Plugins → Adicionar Novo.

Passo 2

No campo de busca no canto superior direito, digite BW4TEC Chat Analytics e pressione Enter.

Passo 3

Localize o plugin oficial (desenvolvido por BW4TEC) na lista de resultados e clique em Instalar Agora.

Passo 4

Após a instalação, clique em Ativar. O plugin já está pronto para uso, sem necessidade de configuração adicional.

✅ Pronto! Após a ativação, o menu do plugin aparecerá no painel lateral esquerdo.

2. Como Adquirir e Instalar a Versão PRO

A versão PRO desbloqueia todos os gráficos de performance, rankings Top 10, balão CTA e histórico avançado. O processo de instalação é idêntico ao da versão Free:

Passo 1

No painel do WordPress (após remover a versão Free, caso já a tenha utilizado), vá em Plugins → Adicionar Novo → Enviar Plugin.

Passo 2

Selecione o arquivo .zip do PRO e clique em Ativar.

3Ativação PRO, Licença e Fluxo Freemius

Resposta direta: A versão PRO é instalada via arquivo .zip; você pode pular a tela inicial do Freemius e ativar depois pelo link "Licença" no menu Plugins.

Como ativar ou gerenciar a licença

Passo 1

Vá até o menu Plugins → Plugins Instalados no painel do WordPress.

Passo 2

Localize o BW4TEC Chat Analytics.

Passo 3

Nos links abaixo do nome do plugin, clique em Licença. É nesse campo que você insere sua chave para ativar o modo PRO.

⚠️ 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.

4Configuração Inicial

Resposta direta: Defina o número (formato internacional), a mensagem padrão e mantenha a anonimização de IP ativa; GeoIP vem desativado por padrão.

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

1. Anonimização de IP (Configuração de Privacidade)

Comportamento Padrão: A anonimização de IP vem ativada por padrão no plugin, mascarando automaticamente o último octeto do IP do visitante antes de salvá-lo no banco de dados (por exemplo, transformando 192.168.1.100 em 192.168.1.0).

⚠️ Desativação (Responsabilidade): Caso o administrador escolha desativar este recurso, o endereço IP verdadeiro do visitante passará a ser registrado integralmente. A decisão é de total responsabilidade do administrador do site.

2. Recursos GeoIP

Funcionamento: O recurso de geolocalização vem desativado por padrão.

O que faz: Caso o administrador decida ativar, o plugin realiza uma consulta externa (via serviço integrado, como ip-api.com) utilizando o endereço IP do visitante para registrar a cidade, estado e país de origem do clique.

⚠️ Responsabilidade: A decisão de ativar ou não o GeoIP é de total responsabilidade do administrador do site.

3. Limpeza Automática de Dados

O que faz: Permite configurar a exclusão automática de registros antigos de cliques do banco de dados (com opções de períodos como 30, 90, 180, 365 dias ou "Manter para sempre").

⚠️ Aviso Crítico de Responsabilidade: Ao ativar a limpeza automática, os registros mais antigos que o período selecionado serão excluídos de forma permanente, irreversível e diária. O desenvolvedor não se responsabiliza por perdas de dados resultantes deste recurso.

5Configuraçã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.

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?"

📱 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.

6Usando o Dashboard

Resposta direta: O dashboard exibe KPIs de cliques (válidos, bots, IPs únicos), filtros por período e número, além de gráficos de volume e rankings Top 10 (exclusivos PRO).

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

7Log 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)

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

8Exportaçã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.

9LGPD e Privacidade

Resposta direta: O plugin oferece anonimização de IP, suporte a consentimento de cookies (CookieYes, Complianz, Real Cookie Banner) e limpeza automática configurável para apoiar a conformidade com a LGPD.

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.

10Resoluçã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

11Suporte

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.

Utilizamos cookies e tecnologias semelhantes para melhorar sua experiência, analisar o tráfego e personalizar o conteúdo. Ao clicar em "Aceitar", você concorda com a nossaPolítica de Privacidade.