Cómo alojar un bot de Slack

​

Introducción

​

Requisitos previos

• Cuenta de Square Cloud: Regístrate a través de la página de registro usando tu correo electrónico.
• Plan 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

​

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. En la sección “Socket Mode”, activa Socket Mode y genera un app-level token con el scope connections:write. Cópialo (empieza con xapp-): este es tu SLACK_APP_TOKEN.
4. En la sección “OAuth & Permissions”, añade los scopes que necesita tu bot (por ejemplo, chat:write, app_mentions:read, commands), instala la app en tu workspace y copia el Bot User OAuth Token (empieza con xoxb-): este es tu SLACK_BOT_TOKEN.
5. En “Event Subscriptions”, activa los eventos y suscríbete al evento de bot app_mention. En “Slash Commands”, crea el comando /hello. Con Socket Mode activado, ninguno de los dos pide una Request URL.

​

Desarrollar el proyecto

npm init -y
npm install @slack/bolt

const { App } = require('@slack/bolt');

const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  appToken: process.env.SLACK_APP_TOKEN,
  // Socket Mode: the bot connects to Slack, so no public URL is needed
  socketMode: true,
});

// 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();
  console.log('⚡️ Slack Bolt app is running!');
})();

pip install slack_bolt

from slack_bolt import App
from slack_bolt.adapter.socket_mode import SocketModeHandler
import os

app = App(token=os.environ.get('SLACK_BOT_TOKEN'))

@app.event('app_mention')
def handle_mention(event, say):
    user = event.get('user')
    say(f'<@{user}> Thanks for mentioning me!')

@app.command('/hello')
def hello_command(ack, respond):
    ack()
    respond('Hello from Square Cloud!')

if __name__ == '__main__':
    # Socket Mode: the bot connects to Slack, so no public URL is needed
    SocketModeHandler(app, os.environ.get('SLACK_APP_TOKEN')).start()

slack_bolt

​

Configurar Square Cloud

DISPLAY_NAME=My Slack Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Slack Bot
MAIN=app.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN es el archivo que ejecuta Square Cloud, y MEMORY es la RAM del bot en MB. Los bots necesitan al menos 256 MB; 512 MB deja margen para crecer.
• AUTORESTART=true vuelve a iniciar el bot si falla. Consulta cómo funciona el auto restart.
• No hay SUBDOMAIN: en Socket Mode, el bot no necesita una URL pública.

​

Definir los tokens

• Dashboard: en la página de subida, abre Configuración avanzada y añade las dos variables. Para un bot que ya está en línea, añádelas en la página Variables de entorno de la aplicación y reinicia el bot.
• CLI: justo después de subir el bot (consulta Deploy), defínelas con squarecloud app env set y reinicia el bot:

squarecloud app env set SLACK_BOT_TOKEN=xoxb-your-token SLACK_APP_TOKEN=xapp-your-token
squarecloud app restart

​

Deploy

​

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.

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 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.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​

A través de la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Probar el bot

1. En el panel de la Slack App, en “OAuth & Permissions”, instala la app en el workspace (si aún no lo hiciste).
2. Revisa los logs de la aplicación en el dashboard de Square Cloud para detectar errores de inicio. Con Socket Mode no hay ninguna Request URL que configurar: el bot se conecta a Slack en cuanto se inicia.
3. Invita al bot a un canal y luego menciónalo o ejecuta el comando /hello para validar las respuestas.

https://slack.com/oauth/v2/authorize?client_id=000000000000.000000000000&scope=commands,chat:write,app_mentions:read

​

Usar el modo HTTP en lugar de Socket Mode

1. En la configuración de la app de Slack, desactiva Socket Mode y copia el Signing Secret (en “Basic Information”) en una variable de entorno SLACK_SIGNING_SECRET, definida igual que los tokens.
2. Crea la app con el signing secret en lugar del app-level token y escucha en el puerto de la variable de entorno PORT:

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

(async () => {
  // Square Cloud sets PORT=80
  await app.start(Number(process.env.PORT) || 80);
  console.log('⚡️ Slack Bolt app is running!');
})();

app = App(
    token=os.environ.get('SLACK_BOT_TOKEN'),
    signing_secret=os.environ.get('SLACK_SIGNING_SECRET')
)

if __name__ == '__main__':
    # Square Cloud sets PORT=80
    app.start(port=int(os.environ.get('PORT', 80)))

3. Agrega un SUBDOMAIN a tu archivo de configuración (o selecciona “Publicación Web” y define un subdominio al subir desde el dashboard) para que el bot tenga una URL pública. Las aplicaciones web necesitan al menos MEMORY=512:

DISPLAY_NAME=My Slack Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true
SUBDOMAIN=my-slack-bot

4. En “Event Subscriptions” y en el slash command /hello, define la Request URL como https://<subdomain>.squareweb.app/slack/events.

​

Recursos adicionales

• Bolt para JavaScript
• Bolt para Python

​

Próximos pasos

​

Contáctanos