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.