Saltar al contenido principal

Descripción general

Vertra Cloud es ideal para alojar bots de WhatsApp con whatsapp-web.js, una biblioteca de Node.js que emula la interfaz web de WhatsApp.
Importante: la biblioteca whatsapp-web.js usa Puppeteer y Chromium, que requieren 512 MB de memoria o más. La aplicación ya viene configurada con 1 GB recomendado para un funcionamiento estable.

Requisitos

  • Node.js 18+ instalado en local
  • Cuenta en Vertra Cloud
  • Número de teléfono válido para la cuenta de WhatsApp

Estructura del proyecto

Configuración

package.json

La plataforma instala las dependencias de whatsapp-web.js, y Puppeteer usa el Chromium que ya está disponible en la imagen del runtime, así que no se descarga ningún navegador durante la instalación. No incluyas node_modules en la subida.

vertracloud.config

Ejemplo completo de bot

Deploy

  1. Comprime el proyecto en un .zip (las carpetas como node_modules, venv y target se eliminan automáticamente) o súbelo a GitHub.
  2. En el panel, haz clic en Nuevo Proyecto y sube el .zip o pega la URL del repositorio.
  3. En Build, revisa el runtime (JavaScript), el archivo principal (index.js) y la memoria. Los comandos de inicio y de build están en Ajustes avanzados.
  4. Añade tus variables de entorno en Variables de Entorno.
  5. En Red, deja la publicación web desactivada: un bot no recibe tráfico entrante y se ejecuta en segundo plano en cualquier plan.
  6. Revisa y despliega. Sigue la salida en la pestaña Logs.
La guía completa está en Primer despliegue.

Primera ejecución: autenticación

1

Despliega y espera al código QR

Tras el despliegue, supervisa los logs. Verás un código QR en la terminal.
2

Escanea con el teléfono

Abre WhatsApp en tu teléfono, ve a Ajustes → Dispositivos vinculados y escanea el código QR.
3

Persistencia de la sesión

La carpeta sessions/ guarda los datos de autenticación. No la vacíes, o el bot tendrá que volver a autenticarse.
4

Confirmación

Cuando veas “Authentication successful!” en los logs, el bot estará listo para recibir mensajes.

Notas importantes

  • Memoria crítica: whatsapp-web.js + Puppeteer/Chromium requieren al menos 512 MB, pero se recomienda 1 GB para un funcionamiento estable
  • Sesiones persistentes: la carpeta sessions/ guarda los datos de autenticación. Configura un volumen persistente si es necesario
  • Código QR: solo se muestra en la primera ejecución. Escanéalo rápido antes de que caduque (normalmente 30 segundos)
  • Reinicio automático: activado por defecto, mantiene el bot en línea
  • Logs: revísalos con regularidad para detectar problemas de conexión
  • Límite de envíos: WhatsApp tiene límites de mensajes. Introduce pausas entre envíos
  • Tipo bot: selecciona siempre Bot al crear la aplicación
Última modificación el 26 de octubre de 2026