Install WhatsApp Server
Use this guide to configure the connection safely, then verify the account and permissions before you publish or automate.
Use this guide
- Prepare the provider credentials and callback values required for this connection.
- Enter them in the related settings area, save, and connect one safe test account.
- Verify the returned name, status, and permissions before using the connection.
Detailed steps
⚡ WhatsApp Server Setup & Configuration
The WhatsApp Server is required to enable QR login, message sending, chatbot automation, and real-time communication. Important: Without this server, WhatsApp features will NOT work.
1. Extract WhatsApp Server
Locate the file: whatsapp_server.zip Extract the file. After extraction, you will get: whatsapp-server/ Move it to your server: /home/whatsapp-server/ or /var/www/whatsapp-server/ Important: Do NOT place inside your Laravel project directory.
2. Configure Server (config.js)
Open file: whatsapp-server/config.js Update your configuration: app_url must match your main domain: https://yourdomain.com/ Update database credentials (must be same as Laravel):
- Database host
- Database name
- Database username
- Database password
Important: The database must be the SAME as your Laravel installation.
3. Install Dependencies
Open terminal and run: cd whatsapp-server npm install
4. Start Server
Run: node app.js Or (recommended): pm2 start app.js -i max Default server URL: http://localhost:8000
5. Connect in Laravel
Go to: Settings → API Integration → WhatsApp Unofficial
- Set Status = Enable
- Enter WhatsApp Server URL
Example: http://yourdomain.com:8000/ Or (recommended): https://ws.yourdomain.com Click Save
6. Verify Setup
- Go to User Dashboard
- Add WhatsApp account
- Scan QR code
If QR appears → setup successful
Recommended Setup (No Port)
Instead of using: http://yourdomain.com:8000/ Use: https://ws.yourdomain.com This method is more stable and avoids port blocking issues.
Troubleshooting
- QR not showing: Check server is running, check URL, restart server
- Cannot connect: Check firewall, port 8000, reverse proxy
- Disconnected: Use PM2, ensure stable server
Important Notes
- Node.js version must be 20 or higher
- Server must run 24/7
- Use same server as main application (recommended)
- Do NOT use localhost in production
Required Notice
You must complete all steps:
- Extract and run WhatsApp Server
- Configure config.js correctly
- Enable WhatsApp Unofficial API in Laravel
Missing any step will cause the system to NOT work properly.
Quick check
- The save or publish action completes without an error.
- The visible status, preview, or connected account matches the change.
- If the result differs, capture the exact message and review the troubleshooting guidance before retrying.