Descripción general
Vertra Cloud es ideal para alojar bots de WhatsApp conwhatsapp-web.js, una biblioteca de Node.js que emula la interfaz web de WhatsApp.
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
- Dashboard
- CLI
- VS Code
- Comprime el proyecto en un
.zip(las carpetas comonode_modules,venvytargetse eliminan automáticamente) o súbelo a GitHub. - En el panel, haz clic en Nuevo Proyecto y sube el
.zipo pega la URL del repositorio. - 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. - Añade tus variables de entorno en Variables de Entorno.
- En Red, deja la publicación web desactivada: un bot no recibe tráfico entrante y se ejecuta en segundo plano en cualquier plan.
- Revisa y despliega. Sigue la salida en la pestaña Logs.
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