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 una cuenta activa de X (Twitter) para la autenticación y el funcionamiento del bot. Si no tienes una cuenta, regístrate en el sitio web oficial de X.También se requiere una cuenta de X Developer para acceder a las APIs. Solicita acceso a través del Portal de Desarrolladores de X.
Aplicación del bot en X
1
Accediendo al Portal de Desarrolladores
- Ve al Portal de Desarrolladores de X.
- Inicia sesión con tu cuenta de X (Twitter).
- Si es tu primera vez, completa el proceso de solicitud de acceso de desarrollador.
2
Creación del proyecto
- En el panel, haz clic en “Create Project”.
- Elige un nombre para tu proyecto (por ejemplo, “Square Cloud Bot”).
- Selecciona el caso de uso más apropiado (por ejemplo, “Making a bot”).
- Proporciona una descripción detallada de tu bot.
- Confirma la creación del proyecto.
3
Configuración de la aplicación
- Dentro del proyecto creado, haz clic en “Create App”.
- Define un nombre único para tu aplicación.
- Confirma la creación de la aplicación.
- Anota el App ID generado para futuras referencias.
4
Generación de las claves de API
- Navega a la sección “Keys and tokens” de tu aplicación.
- En la sección “Consumer Keys”, haz clic en “Regenerate” para generar:
- API Key (Consumer Key)
- API Secret Key (Consumer Secret)
- Importante: Copia y guarda estas claves de inmediato, ya que no podrás volver a verlas.
5
Configuración de permisos
- Ve a la sección “App permissions”.
- Haz clic en “Edit” para modificar los permisos.
- Selecciona “Read and write” para permitir que tu bot publique tweets.
- Si es necesario, selecciona “Read and write and Direct message” para la funcionalidad de DM.
- Guarda los cambios.
6
Generación de los tokens de acceso
- Regresa a la sección “Keys and tokens”.
- En la sección “Access Token and Secret”, haz clic en “Generate”.
- Confirma la generación del token.
- Copia y guarda:
- Access Token
- Access Token Secret
- Advertencia: Estos tokens no podrán volver a verse después de cerrar la página.
7
Verificación de credenciales
- Confirma que tienes las 4 credenciales requeridas:
- API Key (Consumer Key)
- API Secret Key (Consumer Secret)
- Access Token
- Access Token Secret
- Almacena estas credenciales en un lugar seguro
- Importante: Nunca compartas ni expongas estas credenciales públicamente
Desarrollando el proyecto
- Verificación de Node.js: Verifica que Node.js esté instalado en tu sistema. Si no, descárgalo desde el sitio web oficial de Node.js.
- Inicialización del proyecto: Crea un nuevo proyecto de Node.js ejecutando:
Terminal
- Instalar dependencias: Instala las bibliotecas necesarias para el bot:
Terminal
- Configuración de variables de entorno: Crea un archivo
.envpara almacenar tus credenciales de forma segura:
.env
- Crear el 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.Variables de entorno
Variables de entorno
Seguridad: Nunca incluyas tus credenciales de la API directamente en el código. Usa siempre variables de entorno en Square Cloud.
API_KEY: Tu clave de API de XAPI_SECRET_KEY: Tu clave secreta de API de XACCESS_TOKEN: Tu token de accesoACCESS_TOKEN_SECRET: Tu secreto del token de acceso
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
Después del despliegue, revisa los logs de la aplicación en el dashboard de Square Cloud en busca del mensajeBot successfully initialized! para confirmar que el bot se autenticó correctamente. Luego responde a uno de los tweets del bot con !ping y confirma que responde con Pong! 🤖 X Bot working correctly! en X en unos minutos.
Recursos adicionales
Para profundizar tus conocimientos sobre el desarrollo de bots de X usando twitter-api-v2, consulta la documentación oficial de la biblioteca twitter-api-v2. La documentación proporciona guías detalladas, tutoriales avanzados y referencias completas de la API para maximizar tu implementación. Consulta también:- Documentación oficial de la API de X
- Políticas de uso de la API de X
- Guía de buenas prácticas para bots

