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.
Crear el proyecto
Para crear un bot de Discord es fundamental tener una cuenta en la plataforma para crear y gestionar bots. Si no tienes una, visita el sitio oficial de Discord para crear tu cuenta.Aplicación de bot en Discord
Creación de la aplicación
Accede al Developer Portal y haz clic en “New Application”. Define un nombre para tu bot y haz clic en “Create” para crear la aplicación.

Generación del token de autenticación
Después de crear la aplicación, navega a la pestaña “Bot” y haz clic en “Reset Token” para generar el token de autenticación. Copia el token generado para usarlo más adelante en la implementación del código.

Activación de los intents privilegiados
Con el token configurado, activa los intents necesarios. Permanece en la pestaña “Bot”, desplázate hacia abajo y localiza “Privileged Gateway Intents”. Activa los intents como se muestra en la imagen:

Desarrollar el proyecto
Ahora que tenemos el token del bot, podemos empezar a programar. Puedes usar tu lenguaje favorito para hacerlo.- Discord.js (Node.js)
- Discord.py (Python)
Configuración del entorno Node.js
- Verifica que Node.js esté instalado en tu sistema. Si no lo está, descárgalo desde el sitio oficial de Node.js.
- Inicializa un nuevo proyecto Node.js:
Terminal
- Instala la librería Discord.js:
Terminal
- Crea un archivo JavaScript (por ejemplo,
index.js) y añade el siguiente código para crear un bot de Discord básico:
index.js
Deploy
Después de 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.
Probar el bot
Si seguiste todos los pasos correctamente, el siguiente paso es invitar a tu bot para probarlo. Para ello, sigue estos pasos:- Accede al Developer Portal.
- Selecciona tu bot.
- Navega a la pestaña “OAuth2”.
- Ve a “OAuth2 URL Generator”.
- Marca la opción “bot”.
- Elige los permisos que tendrá tu bot cuando se invite usando esta invitación.
- Debajo de los permisos, se generará un enlace de invitación para tu bot. Debería verse así:
client_id en la URL debe reemplazarse con el ID real de tu bot. El valor de permissions también puede necesitar ajustes según los permisos que quieras que tenga tu bot.
Ahora, para probar si todo funciona, ejecuta el siguiente comando en tu servidor: !hello.


