Requirements
Before you begin, make sure you have:
- A VPS or hosting server with Node.js v18+ installed
- WHMCS installed on your server
- Basic SSH access to your VPS (for installation commands)
- Your smartphone with WhatsApp installed
Step 1: Install Node.js
Install Node.js LTS version depending on your system:
Login to SSH of your WHMCS Server
Run the command below
sudo apt install -y gconf-service libgbm-dev libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget
Install Node JS (v18+ Required)
Quick Steps to upgrade node
npm
sudo npm install -g n
sudo n stable
Choco
choco install nodejs-lts
Winget
winget install OpenJS.NodeJS.LTS
Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - &&\sudo apt-get install -y nodejs
Step 2: Install the Module in WHMCS
- Upload the module files to
/whmcsrootdirectory/modules/addons/whatsappbot - Connect via SSH and navigate to the module folder:
cd /whmcsrootdirectory/modules/addons/whatsappbot
npm i
Step 3: Keep It Running with PM2
Install and run PM2 so the bot keeps working after restarts:
npm install -g pm2
pm2 start index.js --name whatsappbot
pm2 logs whatsappbot
Step 4: Activate the Module in WHMCS
- Log in to your WHMCS Admin
- Go to Setup → Addon Modules
- Find WHMCS WhatsApp Notifications and click Activate
- Add the License Key you got from the WHMCS client area after ordering
- Navigate to Addons > WHMCS WhatsApp Notifications
- Click on Login button on Module Dashboard - It will show a QR Code, Scan it with your Whatsapp mobile app


- It will login your whatsapp to send notifications from that whatsapp.
Done
Your WHMCS is now connected with WhatsApp and will automatically send notifications to clients and admins.
[!IMPORTANT] It is not guaranteed you will not be blocked by using this method. WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.