Overview
Vertra Cloud is ideal for hosting WhatsApp bots usingwhatsapp-web.js, a Node.js library that emulates the WhatsApp web interface.
Requirements
- Node.js 18+ installed locally
- Account on Vertra Cloud
- Valid phone number for WhatsApp account
Project Structure
Configuration
package.json
The platform automatically installs
puppeteer and chromium as dependencies of whatsapp-web.js. Do not include node_modules in the upload.vertracloud.config
Complete Bot Example
Deploy
- Via Dashboard
- Via GitHub
- Via VSCode
- Execute
npm installlocally - Exclude
node_modulesfolder from the project - Exclude
sessionsfolder (will be created on first run) - Compress into a ZIP file
- Access Dashboard → New Project → Application
- Select Node.js language and upload
- Important: Configure memory with 1GB minimum (Puppeteer/Chromium require many resources)
- In the wizard, select Bot type
- Click “Create Application”
First Execution - Authentication
1
Deploy and wait for QR code
After deploying, monitor the logs. You’ll see a QR code displayed in the terminal.
2
Scan with phone
Open WhatsApp on your phone, go to Settings → Linked Devices and scan the QR code.
3
Session persistence
The
sessions/ folder stores authentication data. Do not clean this folder or the bot will need to be authenticated again.4
Confirmation
When you see “Authentication successful!” in logs, the bot is ready to receive messages.
Important Notes
- Critical memory: whatsapp-web.js + Puppeteer/Chromium require at least 512MB, but 1GB recommended for stable operation
- Persistent sessions: The
sessions/folder stores authentication data. Configure persistent volume if needed - QR code: Only displayed on first run. Scan quickly before expiration (usually 30 seconds)
- Auto-restart: Essential to keep the bot online
- Logs: Monitor regularly to detect connection problems
- Rate limiting: WhatsApp has message limits. Implement delays between sends
- Bot Type: Always select Bot when creating the application