Free WordPress Plugin
Complete Support Guide & Documentation
digitalwasim.com
What is WhatsApp Chat Widget?
WhatsApp Chat Widget is a free, feature-rich WordPress plugin developed by digitalwasim.com that allows you to add a floating WhatsApp chat button to your website. With over 13+ premium features, this plugin helps your website visitors connect with you instantly via WhatsApp — boosting customer engagement, support response time, and lead generation.
Whether you run a small business, e-commerce store, blog, or service website, this plugin provides a seamless way for your visitors to reach you on WhatsApp without leaving your website. The widget is fully customizable, lightweight, and works perfectly on all devices.
Key Features at a Glance
The WhatsApp Chat Widget plugin comes packed with features that you would normally only find in premium plugins. Here is everything included for absolutely free:
| Feature | Description |
| Floating WhatsApp Button | Beautiful floating button with smooth pulse animation |
| Chat Popup Window | Interactive popup with welcome message before redirecting |
| Multiple Agents | Add unlimited agents with different departments |
| Full Customization | Button color, size, position, tooltip, and more |
| Working Hours | Show widget only during business hours |
| Click Analytics | Built-in dashboard to track WhatsApp clicks |
| GDPR Compliance | Cookie consent check before showing widget |
| Page Exclusion | Hide on specific pages or posts |
| Shortcode Support | Embed WhatsApp buttons anywhere |
| Responsive Design | Perfect on desktop, tablet, and mobile |
| RTL Support | Works with Arabic, Hebrew, and RTL languages |
| Custom CSS | Add your own styles from admin panel |
| Lightweight | Optimized for speed — minimal CSS and JS |
Why You Need a WhatsApp Chat Widget on Your Website?
WhatsApp is the most popular messaging app in the world with over 2.7 billion active users. Adding a WhatsApp chat widget to your website offers several significant advantages that directly impact your business growth and customer satisfaction.
Instant Communication
Unlike contact forms that take hours for a response, WhatsApp provides real-time communication. Your visitors can reach you instantly and get their questions answered in minutes, not hours. This immediacy dramatically improves the customer experience and increases the likelihood of converting visitors into paying customers.
Higher Engagement Rate
Studies show that WhatsApp messages have a 98% open rate compared to just 20% for emails. When you give your website visitors an easy way to reach you on WhatsApp, you are meeting them on the platform they already use and trust. This leads to significantly higher engagement and more meaningful conversations with potential customers.
Build Trust and Credibility
A professional WhatsApp chat widget on your website signals that you are accessible, responsive, and customer-focused. Visitors are more likely to trust a business that provides multiple communication channels. The chat popup with a welcome message creates a personal touch that makes your website feel more approachable and trustworthy.
Lead Generation Boost
Every WhatsApp click is a potential lead. The built-in analytics dashboard helps you track which pages generate the most clicks, allowing you to optimize your content strategy. With the pre-filled message feature, you can guide the conversation from the very first message, ensuring that every interaction starts with relevant context.
Mobile-Friendly Experience
Since most of your website visitors are likely using mobile devices, WhatsApp integration provides a native mobile experience. Instead of filling out clunky contact forms on small screens, users can simply tap the WhatsApp button and start chatting immediately — a seamless experience that reduces friction and abandonment.
Installation Guide
Installing the WhatsApp Chat Widget plugin is straightforward. Follow these simple steps to get your WhatsApp chat widget up and running on your WordPress website.
Method 1: Upload via WordPress Dashboard
- Download the plugin ZIP file from the download link below
- Go to your WordPress Dashboard
- Navigate to Plugins > Add New
- Click the Upload Plugin button at the top
- Choose the w h a t s a p p – c h a t – w i d g e t . z i p file and click Install Now
- After installation, click Activate Plugin
Method 2: FTP/File Manager
- Download and extract the plugin ZIP file
- Upload the w h a t s a p p – c h a t – w i d g e t folder to / w p – c o n t e n t / p l u g i n s / directory
- Go to Plugins in your WordPress Dashboard
- Find “WhatsApp Chat Widget” and click Activate
Initial Setup After Activation
- After activation, you will see a notice with a link to the settings page
- Go to Settings > WhatsApp Chat in your WordPress admin
- Enter your WhatsApp number with country code (e.g., +919876543210 for India, +1XXXXXXXXXX for USA)
- Customize the pre-filled message that visitors will see
- Adjust the widget position, color, and size to match your website design
- Click Save Settings and you are done!
Configuration & Settings Guide
The plugin comes with a comprehensive admin settings panel organized into 8 tabs. Here is a detailed breakdown of each section and how to configure it for the best results.
General Settings
This is the first tab where you set up the basic configuration for your widget. Start by enabling the widget with the toggle switch, then enter your WhatsApp phone number with the country code. The pre-filled message is what your visitors will see when they click the chat button — make it friendly and relevant to your business. For example, if you run a restaurant, you could use “Hi! I would like to make a reservation” or
if you offer services, use “Hello! I am interested in your services.”
Appearance Settings
The Appearance tab gives you complete control over how the widget looks. You can choose from four positions: bottom-right, bottom-left, top-right, or top-left. The button size can be adjusted between 40px and 100px to perfectly match your website’s design. Use the color pickers to set the button’s default color and hover color. You can also add a custom button text label that appears next to the floating icon, and configure a tooltip that shows after 2 seconds to grab attention.
Popup Settings
The Popup tab controls the chat window that appears when visitors click the WhatsApp button. Enable the popup to show a professional chat window before redirecting to WhatsApp. You can set a custom header text, upload an avatar image, write a welcome message, and choose colors for the header and background. The auto-open delay feature lets you set a timer (in seconds) after which the popup will automatically appear — a great way to proactively engage visitors without being intrusive.
Multiple Agents
If you have a team with different departments, the Multi-Agent feature is perfect for you. Enable this option and add unlimited agents, each with their own WhatsApp number, name, department title, avatar, and online status. When visitors click the widget, they will see a list of all available agents and can choose the most relevant one. This is ideal for businesses with separate sales, support, billing, and technical departments.
Working Hours
Configure your business hours so the widget only appears when your team is available to respond. Set different hours for each day of the week — Monday through Sunday. When you are offline, the widget shows a customizable offline message informing visitors that you are currently unavailable. This feature helps manage expectations and ensures that visitors only reach out when someone is actually available to help.
Display Settings
Control exactly where the widget appears on your website. You can independently toggle visibility on desktop and mobile devices. The page exclusion feature lets you hide the widget on specific pages or posts by selecting them from a dropdown. You can also set a custom z-index value to ensure the widget appears above other elements on your website.
Advanced Settings
The Advanced tab includes GDPR compliance mode, which checks for a consent cookie before displaying the widget. You can set the cookie name to match your existing GDPR consent plugin. There is also a custom CSS
field where you can add your own styles to override the default appearance without modifying plugin files.
Analytics Dashboard
The Analytics tab provides valuable insights into how visitors interact with your WhatsApp widget. You can see total clicks, today’s clicks, this week’s clicks, and this month’s clicks at a glance. The data helps you understand which pages drive the most engagement and optimize your strategy accordingly. You can also clear all analytics data with a single click if needed.
Shortcode Guide
The plugin provides a flexible shortcode system that lets you embed WhatsApp chat buttons anywhere on your website — not just the floating widget. Here are all the available options:
Basic Shortcode
This displays a WhatsApp button using your default settings configured in the plugin settings page.
Custom Number and Message
Override the default phone number and pre-filled message for this specific button.
Display as Text Link
Instead of a button, display a clickable text link that opens WhatsApp.
Custom Button Text
Display a button with your custom text label.
Use Cases for Shortcodes
- Contact Page: Add [ w h a t s a p p _ c h a t ] to your contact page for an additional communication channel
- Product Pages: Use [ w h a t s a p p _ c h a t m e s s a g e = ” I a m i n t e r e s t e d i n P r o d u c t X ” ]
on WooCommerce product pages
- Blog Posts: Add a chat button at the end of articles for reader engagement
- Landing Pages: Use custom messages for specific campaign pages
Frequently Asked Questions (FAQ)
How do I find my WhatsApp number with country code?
Your WhatsApp number includes your country code at the beginning. Here are some common examples:
| Country | Country Code | Example Number |
| India | +91 | +919876543210 |
| United States | +1 | +12025551234 |
| United Kingdom | +44 | +447911123456 |
| United Arab Emirates | +971 | +971501234567 |
| Saudi Arabia | +966 | +966501234567 |
| Pakistan | +92 | +923001234567 |
| Bangladesh | +880 | +880171234567 |
You can also find your number by opening WhatsApp > Settings > Profile. Make sure to include the country code without any spaces or dashes.
Does this plugin require WhatsApp Business App?
No, this plugin works perfectly with both the regular WhatsApp app and WhatsApp Business app. However, using WhatsApp Business is recommended for professional use as it provides additional features like business profiles, automated greetings, quick replies, and product catalogs.
Will this plugin slow down my website?
No. The WhatsApp Chat Widget is designed with performance in mind. It loads only minimal CSS (less than 15KB) and JavaScript (less than 5KB). The analytics tracking uses the modern s e n d B e a c o n API which runs asynchronously without blocking page load. The plugin files are also optimized and minified for production use.
Is this plugin GDPR compliant?
Yes. The plugin includes a dedicated GDPR compliance mode. When enabled, the widget checks for a consent cookie before displaying. You can set the cookie name to match your existing GDPR/cookie consent plugin. The analytics feature also anonymizes IP addresses before storing them, ensuring visitor privacy is respected at all times.
Can I use this plugin with WooCommerce?
Absolutely! The plugin works seamlessly with WooCommerce and any other WordPress theme or plugin. You can add the WhatsApp chat shortcode to your product pages, checkout page, or any other WooCommerce page. The page exclusion feature lets you hide the widget on specific pages if needed.
How do I add multiple agents?
Go to Settings > WhatsApp Chat > Agents tab and enable the “Multiple Agents” option. Then click “Add New Agent” to add each team member with their name, WhatsApp number, department, avatar, and online status. Visitors will see a list of all agents and can choose who to chat with.
Does the plugin work with page builders?
Yes, the plugin works with all major page builders including Elementor, Divi, Beaver Builder, Brizy, and others. You can use the [ w h a t s a p p _ c h a t ] shortcode in any shortcode widget or block provided by your page builder.
Can I customize the widget colors?
Yes, you have full control over colors. In the Appearance settings, you can set the button color, hover color, popup header color, and popup background color using WordPress color pickers. For advanced customization, you can add custom CSS in the Advanced settings tab.
Screenshots
(Add screenshots of the plugin here in your WordPress post)
- Admin Settings Page — Shows the tabbed settings interface
- Floating Widget on Website — Shows the green WhatsApp button on a sample website
- Chat Popup Window — Shows the popup with welcome message and start chat button
- Multiple Agents View — Shows the agent selection list
- Analytics Dashboard — Shows the click statistics in the admin panel
- Mobile View — Shows how the widget looks on a mobile device
Plugin Requirements
| Requirement | Minimum Version |
| WordPress | 5.0 or higher |
| PHP | 7.4 or higher |
| Browser | Any modern browser (Chrome, Firefox, Safari, Edge) |
What’s New in Version 1.0.0
- Initial release with all core features
- Floating WhatsApp button with smooth animations
- Chat popup window with customizable welcome message
- Multiple agents support with department categorization
- Working hours scheduling with offline messaging
- Click analytics tracking dashboard
- GDPR compliance mode with cookie consent
- Shortcode support for embedded buttons
- Page exclusion settings
- Full RTL language support
- Responsive design for all screen sizes
- Custom CSS option for advanced styling
Download WhatsApp Chat Widget
Download the latest version of WhatsApp Chat Widget plugin for free:
Plugin Version: 1.0.0 | Last Updated: April 2025 | Requires WordPress: 5.0+
Support & Documentation
If you need help with the plugin, have feature requests, or found a bug, here are the ways to get support:
- Documentation: You are reading it! This page contains everything you need.
- WordPress.org Forum: Post your question on the WordPress.org support forum
- Contact: Reach out via the contact page
Changelog
Version 1.0.0 (April 2025)
- Initial release
- All core features included (13+ features)
- Full documentation and support
Other Recommended Plugins by digitalwasim.com
If you found this plugin useful, check out other plugins and resources by digitalwasim.com. We are committed to building high-quality, free WordPress tools that help you grow your online presence.
Tags: WhatsApp plugin, WhatsApp chat widget, free WhatsApp button, WordPress WhatsApp integration, live chat plugin, customer support widget, floating WhatsApp button, WhatsApp Business, WhatsApp popup, WordPress chat plugin
