Skip to main content

Overview

Vertra Cloud is ideal for hosting WhatsApp bots using whatsapp-web.js, a Node.js library that emulates the WhatsApp web interface.
Important: The whatsapp-web.js library uses Puppeteer and Chromium, which require 512MB or more memory. 1GB recommended for stable operation is configured with the application.

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

  1. Execute npm install locally
  2. Exclude node_modules folder from the project
  3. Exclude sessions folder (will be created on first run)
  4. Compress into a ZIP file
  5. Access Dashboard → New Project → Application
  6. Select Node.js language and upload
  7. Important: Configure memory with 1GB minimum (Puppeteer/Chromium require many resources)
  8. In the wizard, select Bot type
  9. 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