Saltar al contenido principal

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 Slack, necesitarás una cuenta y permisos para crear apps en Slack. Crea o accede a tu cuenta en https://slack.com/ antes de seguir los siguientes pasos.

Aplicación de bot en Slack

  1. Ve a Slack API - Your Apps y haz clic en “Create New App”.
  2. Elige “From scratch”, dale un nombre a la app y selecciona el workspace donde la instalarás.
  3. Anota el Signing Secret (en “Basic Information”) y crea un Bot Token en la sección “OAuth & Permissions”, añadiendo los scopes apropiados para tu bot (por ejemplo, chat:write, channels:read, commands, app_mentions:read).
Seguridad: Nunca expongas el Signing Secret ni el Bot Token públicamente. Trátalos como credenciales sensibles.

Desarrollar el proyecto

Usa las secciones a continuación según el lenguaje que elijas. Ambos ejemplos demuestran un bot que responde a menciones o comandos simples.
Configuración del entorno Node.js
  1. Asegúrate de que Node.js esté instalado.
  2. Inicializa un proyecto e instala las dependencias:
Terminal
npm init -y
npm install @slack/bolt
  1. Crea un archivo index.js con el siguiente contenido:
index.js
const { App } = require('@slack/bolt');

const app = new App({
  signingSecret: process.env.SLACK_SIGNING_SECRET,
  token: process.env.SLACK_BOT_TOKEN,
});

// Responds when mentioned
app.event('app_mention', async ({ event, say }) => {
  await say(`<@${event.user}> Thanks for mentioning me!`);
});

// Example slash command
app.command('/hello', async ({ ack, respond }) => {
  await ack();
  await respond('Hello from Square Cloud!');
});

(async () => {
  await app.start(process.env.PORT || 3000);
  console.log('⚡️ Slack Bolt app is running!');
})();
Nota: en Square Cloud, define las variables de entorno SLACK_SIGNING_SECRET y SLACK_BOT_TOKEN en el panel de la aplicación.

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.
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.
Subiendo aplicación a Square Cloud

A través de la CLI

Para usar este método, necesitas crear un archivo de configuración llamado squarecloud.app en el directorio raíz de tu proyecto. Este archivo contendrá la configuración necesaria para tu proyecto.

Aprende más sobre: cómo crear el archivo de configuración para Square Cloud.

El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; se utilizará para definir tu entorno.
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:
npm install -g @squarecloud/cli
Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:
squarecloud update
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:
squarecloud auth login
3

Sube tu proyecto

Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando:
squarecloud upload 
O si creaste el zip manualmente, puedes usar:
squarecloud upload --file <path/to/zip> 

Probar el bot

  1. En el panel de la Slack App, en “OAuth & Permissions”, instala la app en el workspace.
  2. Si el bot expone endpoints (para eventos o comandos), configura la Request URL en “Event Subscriptions” y “Slash Commands” para que apunte a la URL pública de tu aplicación (Square Cloud proporciona el dominio después del deploy).
  3. Prueba las menciones en un canal o el comando /hello para validar las respuestas.
Ejemplo de enlace de instalación (reemplaza el client_id):
https://slack.com/oauth/v2/authorize?client_id=000000000000.000000000000&scope=commands,chat:write,app_mentions:read

Recursos adicionales

Para más información, consulta la documentación oficial de Slack:

Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema.