تفصیل
BW4TEC Chat Analytics is a comprehensive analytics solution to track, monitor, and optimize all WhatsApp click interactions on your WordPress website.
Key Features:
- Universal Number Tracking: Automatically detects and logs clicks on WhatsApp links in the https://wa.me/SEUNUMERO format. Other formats (such as api.whatsapp.com) are NOT captured.
- Smart Position Detection: Identifies click origins across site sections (Header, Footer, Content, Sidebar, Floating Button, and Elementor Widgets).
- Bot Detection Algorithm: Assigns a risk score from 0 to 100 based on page load speed, mouse/pointer interaction, User-Agent, and Webdriver flags.
- Optional GeoIP Lookup: Identifies City, Region, and Country with local caching via Transients. Easily disable GeoIP in settings for strict GDPR/LGPD compliance.
- Native Multi-Tab Dashboard: View KPIs, real-time click logs, number-grouped reports, and suspicious IP lists.
- Customizable Floating Button: Display a high-converting WhatsApp floating button with configurable position and custom pre-filled message.
- CSV Export: Export complete click logs filtered by date range, phone number, city, or state for external analysis in Excel or Google Sheets.
External services
This plugin connects to external services to provide certain functionality.
GeoIP Lookup (ipwho.is)
This plugin uses the ipwho.is API to determine the geographic location (city, state, country) of visitors who click WhatsApp links.
- Service Name: ipwho.is
- Purpose: Resolves the visitor’s IP address into country, state, city, and proxy status for bot detection.
- Data Transmitted: Visitor IP Address.
- When: Only when the GeoIP option is enabled in the plugin settings (disabled by default).
- Terms of Service & Privacy: https://ipwho.is/
QR Code Generation (QR Server — api.qrserver.com)
This plugin uses the QR Server API to generate QR codes for the WhatsApp floating button (displayed on desktop devices).
- Service Name: QR Server (api.qrserver.com)
- Purpose: Generates QR code images for WhatsApp links so desktop users can scan and continue the conversation on their phone.
- Data Transmitted: Only the encoded WhatsApp chat URL (containing the phone number and pre-filled message) is transmitted to generate the QR image. No user tracking data is sent.
- When: Only when the floating button’s QR code modal is opened on desktop devices.
- Terms of Service & Privacy: https://goqr.me/api/doc/ and https://bw4tec.com.br/privacidade.html
Features
Click Tracking (Free and PRO)
* Clicks on links in wa.me format, Elementor buttons, and classes/IDs with "whatsapp”
* UTM capture (source, medium, campaign) and fbclid with first-touch attribution
* GTM/dataLayer event for integration with Google Tag Manager
* Time to Click in seconds
* Scroll Depth (0–100%)
* Recurring visitor vs. first visit
* Anti-duplicate protection (same IP within 2 seconds)
* Automatic injection of page title into message
Bot Detection (Free and PRO)
* Risk score from 0 to 100
* Detection of known bots (phantomjs, wget, curl, etc.)
* Proxy, VPN, and hosting detection via GeoIP
* Webdriver detection
* Classification: Safe / Suspicious / High Risk
Floating Button (Free and PRO)
* Native floating button with configurable number and message
* Configurable position (bottom right or left)
* Modal with QR Code on desktop + fallback to WhatsApp Web
Native WordPress Dashboard
* KPIs: total clicks, valid clicks, bots/suspicious, unique IPs
* Filters: period, phone, city, and state
* Tabs: Dashboard & Reports, Complete Click Log, Settings
* CSV Export (UTF-8) — unlimited records
* Log pagination — 50, 250 or 500 records
GeoIP (Free and PRO)
* City, state, and country via ipwho.is (HTTPS)
* Proxy/hosting detection
* Cache via WordPress Transients
* Optional lookup (can be disabled)
LGPD and Privacy (Free and PRO)
* IP anonymization option (masks last octet of IPv4 or last 4 blocks of IPv6)
* Support for consent plugins (cookie bw4tec_consent + filter bw4tec_allow_tracking)
* Automatic data cleanup (30, 90, 180, 365 days or keep)
PRO Exclusive
* Real charts with Chart.js (Performance Dashboard)
* Top 10 Rankings (pages, cities, click positions)
* CTA balloon next to floating button
* Business hours configuration (marks clicks inside/outside business hours)
Requirements
This plugin exclusively tracks clicks on links in the https://wa.me/SEUNUMERO format. Links using other formats (such as api.whatsapp.com or custom schemes) are NOT captured by the plugin. Ensure that your site’s WhatsApp buttons use the wa.me format for clicks to be counted correctly.
About the Dashboard
In the free version, the Performance Dashboard displays an illustrative preview (mockup) of the charts with an upgrade banner. Real charts with your site’s data, Top 10 rankings, and advanced metrics are available exclusively in the PRO version.
Free vs PRO
| Feature | Free | PRO |
| :— | :— | :— |
| History Retention | Unlimited | Unlimited |
| CSV Export | Unlimited | Unlimited |
| Log Pagination | 50, 250 or 500 | 50, 250 or 500 |
| Universal Tracking (UTMs, fbclid) | ✅ | ✅ |
| Advanced Filters (Date, Area Code, City) | ✅ | ✅ |
| Bot Protection and Risk Score | ✅ | ✅ |
| GeoIP (city, state, country) | ✅ | ✅ |
| IP Anonymization (LGPD) | ✅ | ✅ |
| Anti-duplicate (same IP in <2s) | ✅ | ✅ |
| QR Code Modal on Desktop | ✅ | ✅ |
| Charts and KPIs (Chart.js) | ❌ | ✅ |
| Top 10 Rankings (Pages, Cities, Positions) | ❌ | ✅ |
| CTA Balloon on floating button | ❌ | ✅ |
| Business Hours (inside/outside business hours) | ❌ | ✅ |
Privacy
This plugin collects WhatsApp link click data for statistical and bot detection purposes.
Data collected:
– IP Address (with anonymization option in settings, which masks the last octet of IPv4 or the last 4 blocks of IPv6)
– User-Agent (browser and operating system)
– Approximate geographic data (city, state, country) via external API query to ipwho.is (HTTPS)
– UTM parameters and fbclid for source attribution
– Time to click and scroll depth
Storage:
Data is stored in a private table in the WordPress site’s own database, never shared with third parties beyond the one-time geolocation query.
Consent:
The plugin supports integration with consent plugins (CookieYes, Complianz, LGPD Framework, etc.) through the bw4tec_consent cookie and the bw4tec_allow_tracking filter. The site administrator is the Data Controller and must include this information in their site’s privacy policy.
Retention:
Data can be automatically cleaned between 30 and 365 days, as configured by the administrator.
Legal Basis:
Art. 7, IX (legitimate interest for statistics) and Art. 7, X (bot detection) of the LGPD.
Disclaimer: The site administrator is the sole Data Controller and is responsible for ensuring compliance with LGPD/GDPR. BW4TEC provides the tool but does not assume any liability for how the site collects or processes data.
Legal Notice
BW4TEC and the Chat Analytics plugin are not affiliated with, associated, sponsored, endorsed, or officially connected in any way with Meta Platforms, Inc., owner of the WhatsApp®, Facebook®, and Instagram® brands. All cited trademarks belong to their respective owners and are used for descriptive purposes only. The plugin does not access, store, or process WhatsApp conversation content — it only tracks clicks on wa.me links displayed on your own website.
انسٹالیشن
- Upload the
bw4tec-chat-analyticsfolder to the/wp-content/plugins/directory or install via the WordPress Plugins dashboard. - Activate the plugin through the "Plugins” menu in WordPress.
- Navigate to "BW4TEC Chat” in the admin sidebar to view analytics and manage settings.
عمومی سوالات
-
Does the plugin track multiple WhatsApp numbers on the same site?
-
Yes! The plugin automatically detects and tracks clicks for any WhatsApp number present in site links, whether static or dynamically generated.
-
Is it compatible with Elementor?
-
Yes. The plugin’s JavaScript tracker detects Elementor buttons and icons, automatically categorizing their location as "Widget Elementor”.
-
Does the GeoIP feature store sensitive user data?
-
No. Geographical data is retrieved solely to determine region and cached locally via Transients to prevent redundant external API requests. Additionally, GeoIP lookup can be completely disabled in the settings tab.
-
How does the Automatic Data Cleanup feature work?
-
The plugin has a configurable Automatic Cleanup (Auto-purge) option in the Settings tab, designed to prevent database bloat on high-traffic sites. When enabled, old click records will be permanently deleted automatically every day. BW4TEC is not responsible for any data loss resulting from the use of Automatic Cleanup. We recommend periodically exporting reports in CSV format if you need to retain a lifetime history of clicks.
-
Integration with Consent Plugins (LGPD)
-
The plugin offers native support for LGPD compliance via consent cookie verification. To enable:
- Go to Settings and check "Enable tracking only after consent (LGPD)”
- Enter the name of the cookie used by your consent plugin:
- CookieYes: "cookieyes-consent” (value: "yes”)
- Complianz: "complianz_consent_status” (value: "allow”)
- Cookiebot: "CookieConsent” (value: "{necessary:true,preferences:true,statistics:true,marketing:true}”)
- Borlabs Cookie: "borlabs-cookie” (value depends on configuration)
Example code for development:
add_filter(‘bw4tec_allow_tracking’, function($allow) {
return $allow && isset($_COOKIE[‘your_consent_cookie’]) && $_COOKIE[‘your_consent_cookie’] === ‘yes’;
});
جائزے
There are no reviews for this plugin.
شراکت دار اور ڈیویلپرز
“BW4TEC Chat Analytics” اوپن سورس سافٹ ویئر ہے۔ مندرجہ ذیل لوگوں نے اس پلگ ان میں حصہ لیا:
شراکت دار
“BW4TEC Chat Analytics” کا اپنی زبان میں ترجمہ کریں۔
ڈویلپمینٹ میں دلچسپی ہے؟
کوڈ براؤز کریں، ایس این وی ریپوزیٹری کو چیک کریں یا ڈویلپمینٹ لاگ کو سبسکرائب کریں بذریعہ آر ایس ایس۔
چینج لاگ
4.8.5
- Lite version stabilization and full compliance confirmation with WordPress.org guidelines.
- Documentation update, removal of anti-fraud references in favor of bot detection, and inclusion of trademark legal notice.
4.8.4
- Final removal adjustments for restricted dependencies and API route validation.
4.8.3
- Tracking script optimization and refinement of LGPD filters and optional GeoIP handling.
4.8.2
- Removed duplicated if/else block in pagination options (compliance with WordPress.org Plugin Directory Guidelines).
- Cleaned up semantic residue in date limit code (removed unnecessary is_pro check).
4.8.1
- Added missing assets/js/admin.js file (fixes Chart.js rendering and auto-purge confirmation on the admin page).
- Cleaned up pagination validation code (removed unnecessary is_pro_active check).
4.8.0
- Removed all feature limitations from the free version (unlimited history, unlimited CSV export, full pagination) to comply with WordPress.org Plugin Directory Guidelines.
- Moved inline CSS to enqueued stylesheet (assets/css/admin.css).
- Moved inline JavaScript to enqueued script (assets/js/admin.js).
- GeoIP lookup is now disabled by default (opt-in required for external API calls).
- IP anonymization is now enabled by default for LGPD compliance.
- Documented QR Server (api.qrserver.com) as external service in readme.
- Updated Free vs PRO comparison table.
4.7.13
- Fixed encoding issues in plugin header and admin interface (UTF-8 without BOM).
- Corrected corrupted characters in Portuguese text (ç, ã, é, á, í).
- Updated emoji icons in admin settings (🔒 and 🎯).
4.7.12
- Removed Cookiebot from simple cookie examples list (now listed as partially compatible in detailed guide).
- Updated help text to reflect current compatibility status accurately.
4.7.11
- Updated consent plugin compatibility guide: Cookiebot now listed as partially compatible (works with JSON statistics:true/analytics:true).
- Added "Partially Compatible” section to clarify plugins that work conditionally.
4.7.10
- Enhanced consent verification to support multiple common values: yes, allow, accepted, true, 1, granted.
- Added JSON parsing support for consent cookies with statistics:true or analytics:true.
- Updated admin help text to reflect flexible consent verification while maintaining security.
4.7.9
- Added comprehensive consent plugin compatibility guide with automatic and custom integration options.
- Listed supported plugins (CookieYes, Complianz, etc.) and unsupported plugins (Cookiebot, Borlabs, etc.) with clear guidance.
4.7.8
- Improved consent cookie field: removed default value, added helpful placeholder and examples list.
- Enhanced LGPD guidance with clearer instructions for consent plugin integration.
4.7.7
- Added prominent LGPD warning notice in admin settings page.
- Added disclaimer in readme.txt Privacy section clarifying data controller responsibility.
4.7.6
- Fixed encoding issues in readme.txt (UTF-8 without BOM).
- Corrected description about supported WhatsApp link formats (wa.me only).
- Translated all readme.txt sections to English.
4.7.5
- LGPD compliance fix: new IP anonymization option in settings.
- Migration of GeoIP service to HTTPS (ipwho.is) ensuring secure data transmission.
- Support for consent verification (cookie bw4tec_consent and filter bw4tec_allow_tracking).
- Documentation update with Requirements, Free vs PRO, and Privacy sections.
- Notice about the illustrative nature of charts in the free version.
4.7.4
- Integration with licensing and plan management for Free and Pro versions.
- Removal of the old custom licensing system.
- Security improvements and code optimization.
4.6.0
- Unified plugin naming to BW4TEC Chat Analytics.
- Complete optimization for the official WordPress.org directory (100% Plugin Checker compliance).
- Comprehensive SQL sanitization using $wpdb->prepare().
- Modular architecture refactoring (separated PHP classes, external JS tracker, and CSS styles).
- Added date range filters, phone number filters, city/state dropdown filters, and license key configuration.
- Added explicit toggle setting for GeoIP third-party API compliance.