Install WhatsApp Server

⚡ 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.