manifest / social / whatsapp-chat-plugin

WhatsApp Chat Widget

WhatsApp chat widget to your wordpress website with auto-popup functionality and agent information.

by Muhammad Ahsan · github.com/ahsantahseen/whatsapp-chat-plugin

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/ahsantahseen/whatsapp-chat-plugin/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/ahsantahseen/whatsapp-chat-plugin ↗

A professional WordPress plugin that adds a customizable WhatsApp chat widget to your website with auto-popup functionality and agent information.

Features

Easy Integration - Simple shortcode: [whatsapp_chat]
Customizable - Configure agent name, phone, avatar, and welcome message
Auto-Popup - Automatically opens chat after a set delay
Responsive - Mobile-friendly design
Settings Page - Admin settings page for default configuration
Instance Overrides - Override defaults per shortcode usage
Global Toggle - Option to show a single widget on every page

Installation

Upload the plugin folder to /wp-content/plugins/
Activate the plugin from WordPress admin panel
Go to Settings → WhatsApp Chat to configure defaults

Usage

Basic Usage

[whatsapp_chat]

With Custom Parameters

[whatsapp_chat
    name="John Doe"
    phone="1234567890"
    avatar="https://example.com/avatar.jpg"
    subtitle="Available 9-5"
    message="Hi! How can we help?"
    delay="5"
]

Available Shortcode Attributes

Attribute	Description	Example
`phone`	WhatsApp number with country code (no +)	`phone="85212345678"`
`name`	Agent name displayed	`name="John Doe"`
`avatar`	Avatar image URL	`avatar="https://example.com/avatar.jpg"`
`subtitle`	Subtitle below agent name	`subtitle="Typically replies in minutes"`
`message`	Welcome message (HTML allowed)	`message="Hello! How can we help?"`
`delay`	Auto-open delay in seconds (0 to disable)	`delay="8"`
`default_msg`	Default user message if left empty	`default_msg="Hi, I need help"`

File Structure

whatsapp-chat-widget/
├── whatsapp-chat-widget.php      # Main plugin file
├── includes/
│   ├── class-whatsapp-chat-widget.php
│   ├── class-settings.php
│   └── class-widget-renderer.php
├── templates/
│   ├── settings-page.php
│   └── widget-markup.php
└── assets/
    ├── css/
    │   └── widget.css
    └── js/
        └── widget.js

Settings

Configure these in the WordPress admin:

WhatsApp Number - Your WhatsApp business number
Agent Name - Name displayed in the chat header
Avatar URL - Profile picture URL
Subtitle - Status text (e.g., "Usually replies in 10 minutes")
Welcome Message - Initial message shown in the chat
Auto-Open Delay - Seconds before chat auto-opens (0 = disabled)
Show on All Pages - Inject a single widget globally via the footer
Default User Message - Message sent if user doesn't type anything

Requirements

WordPress 5.0+
PHP 7.2+

License

GPL v2 or later