Introducción
Para desarrollar y alojar en Square Cloud, es esencial seguir una secuencia estructurada de configuraciones y requisitos previos. Esta guía técnica cubrirá todo el proceso, desde la configuración inicial hasta el despliegue en producción.Requisitos previos
- Cuenta de Square Cloud: Regístrate a través de la página de registro usando tu correo electrónico.
- Plan de pago activo: Garantiza recursos dedicados y un rendimiento optimizado para tu aplicación. Consulta nuestros planes disponibles y elige el más adecuado para tus necesidades.
Creando el proyecto
Se requiere tener WhatsApp instalado y configurado para la autenticación y vinculación del bot. Si no tienes la aplicación, visita el sitio web oficial de WhatsApp para descargarla y configurarla.Configuración de la ruta remota para WhatsApp Web
Configuración de la ruta remota para WhatsApp Web
Si tu implementación necesita acceder a la ruta remota para la versión de WhatsApp Web, sigue este procedimiento técnico:
- Accede al repositorio wa-version
- Selecciona la versión deseada (siempre se recomienda usar la más reciente)
- Haz clic en “Raw” para ver el archivo
- Copia la URL generada para su uso posterior
Desarrollando el proyecto
- Verificación de Node.js: Confirma que Node.js esté instalado en tu sistema. De lo contrario, descárgalo desde el sitio web oficial de Node.js.
- Inicialización del proyecto: Configura un nuevo proyecto de Node.js ejecutando el comando de inicialización:
Terminal
- Instalación de dependencias: Instala las bibliotecas esenciales para el funcionamiento del bot:
Terminal
- Creación del archivo principal: Desarrolla el archivo
index.jscon la estructura base del bot:
index.js
Desplegando
Tras preparar los archivos de tu proyecto, ya puedes subirlos a Square Cloud y alojar tu proyecto. Para ello, crea un archivo ZIP que contenga todos los archivos de tu proyecto.A través del panel
1
Accede a la página de subida
Accede a la página de subida y sube el archivo zip de tu proyecto.
2
Configura tu entorno
Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.
3
Despliega tu proyecto
Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

4
Confirma que tu aplicación esté en vivo
Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre
Si desplegaste un sitio web o una API, abre
https://<tu-subdominio>.squareweb.app en tu navegador — deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.
A través de la CLI
Para usar este método, necesitas crear un archivo de configuración llamadosquarecloud.app en el directorio raíz de tu proyecto. Este archivo contendrá la configuración necesaria para tu proyecto.
Guía del archivo de configuración
Aprende a crear el archivo de configuración
squarecloud.app que define el entorno de tu aplicación.1
Instala la CLI
Primero, necesitas tener la CLI instalada en tu entorno. Si aún no la tienes, ejecuta el siguiente comando en tu terminal:Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:
- Windows
- Linux, macOS y WSL
2
Autentícate
Ahora, para autenticarte y usar otros comandos de la CLI, encontrarás tu clave de autorización aquí haciendo clic en “Request API Key”. Después de obtener tu clave de autorización, ejecuta el siguiente comando:
3
Sube tu proyecto
Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando:O si creaste el zip manualmente, puedes usar:
4
Confirma que tu aplicación esté en vivo
Tu primer despliegue suele tardar menos de un minuto. Revisa el estado y los logs de tu aplicación directamente desde la terminal:Si desplegaste un sitio web o una API, abre
https://<tu-subdominio>.squareweb.app en tu navegador — deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.
Probando el bot
Revisa los logs de la aplicación en el dashboard de Square Cloud: en el primer arranque verás el log de generación del código QR, y una vez que lo escanees con WhatsApp en tu teléfono, el mensajeWhatsApp client successfully initialized! confirma que la sesión está activa. Luego envía !ping desde otro número a la cuenta de WhatsApp vinculada y confirma que responde con pong - Bot working correctly!.
Usando Baileys en lugar de whatsapp-web.js
Baileys es una biblioteca alternativa que se conecta directamente a la API multi-dispositivo de WhatsApp mediante un WebSocket, sin lanzar un navegador headless. Como no hay instancia de Chromium/Puppeteer que ejecutar, usa significativamente menos RAM que whatsapp-web.js. Como Baileys no tiene una sesión de navegador de respaldo, debe persistir su propio estado de autenticación (el archivocreds.json y las claves dentro de la carpeta de auth) entre reinicios, o la sesión del dispositivo vinculado se pierde en cada redeploy y tendrás que volver a escanear el código QR. Recomendamos subir esa carpeta de auth a un almacenamiento persistente, como Square Cloud Blob Storage, para que la sesión sobreviva a los redeploys.
- Instala la biblioteca:
Terminal
- Crea un archivo
index.jsusandomakeWASocketyuseMultiFileAuthStatepara cargar y persistir la sesión:
index.js
MEMORY menor que el ejemplo de whatsapp-web.js de arriba:
squarecloud.config

