Come ospitare un bot Slack

​

Introduzione

​

Prerequisiti

• Account Square Cloud: Registrati tramite la pagina di registrazione usando la tua email.
• Piano attivo: Garantisce risorse dedicate e prestazioni ottimizzate per la tua applicazione. Consulta i nostri piani disponibili e scegli quello più adatto alle tue esigenze.

​

Creazione del progetto

​

Applicazione bot su Slack

1. Vai su Slack API - Your Apps e clicca su “Create New App”.
2. Scegli “From scratch”, assegna un nome all’app e seleziona il workspace in cui la installerai.
3. Nella sezione “Socket Mode”, abilita il Socket Mode e genera un app-level token con lo scope connections:write. Copialo (inizia con xapp-): questo è il tuo SLACK_APP_TOKEN.
4. Nella sezione “OAuth & Permissions”, aggiungi gli scope di cui il tuo bot ha bisogno (ad esempio chat:write, app_mentions:read, commands), installa l’app nel tuo workspace e copia il Bot User OAuth Token (inizia con xoxb-): questo è il tuo SLACK_BOT_TOKEN.
5. In “Event Subscriptions”, abilita gli eventi e iscriviti al bot event app_mention. In “Slash Commands”, crea il comando /hello. Con il Socket Mode abilitato, nessuno dei due richiede una Request URL.

​

Sviluppo del progetto

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

​

Configurare 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 è il file che Square Cloud esegue, e MEMORY è la RAM del bot in MB. I bot richiedono almeno 256 MB; 512 MB lasciano spazio per crescere.
• AUTORESTART=true riavvia il bot se va in crash. Consulta come funziona il riavvio automatico.
• Non c’è SUBDOMAIN: in Socket Mode, il bot non ha bisogno di un URL pubblico.

​

Impostare i token

• Dashboard: nella pagina di upload, apri Advanced configuration e aggiungi entrambe le variabili. Per un bot già pubblicato, aggiungile nella pagina Environment Variables dell’applicazione e riavvia il bot.
• CLI: subito dopo aver caricato il bot (vedi Distribuzione), impostale con squarecloud app env set e riavvia il bot:

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

​

Distribuzione

​

Tramite dashboard

1

Accedi alla pagina di upload

Accedi alla pagina di upload e carica il file zip del tuo progetto.

2

Configura il tuo ambiente

Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.

3

Esegui il deploy del tuo progetto

Infine, clicca sul pulsante “Deploy” per ospitare il tuo progetto su Square Cloud.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

4

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Nella dashboard, attendi che lo stato della tua applicazione mostri “in esecuzione” e controlla i log per eventuali errori di avvio.
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.

La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

​

Tramite 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

​

Test del bot

1. Nel pannello dell’app Slack, sotto “OAuth & Permissions”, installa l’app nel workspace (se non l’hai ancora fatto).
2. Controlla i log dell’applicazione nella dashboard di Square Cloud per eventuali errori di avvio. Con il Socket Mode non c’è nessuna Request URL da configurare: il bot si connette a Slack non appena si avvia.
3. Invita il bot in un canale, poi menzionalo o esegui il comando /hello per convalidare le risposte.

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

​

Usare la modalità HTTP al posto del Socket Mode

1. Nelle impostazioni dell’app Slack, disabilita il Socket Mode e copia il Signing Secret (sotto “Basic Information”) in una variabile d’ambiente SLACK_SIGNING_SECRET, impostata come i token.
2. Crea l’app con il signing secret al posto dell’app-level token e mettiti in ascolto sulla porta indicata dalla variabile d’ambiente 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. Aggiungi un SUBDOMAIN al tuo file di configurazione (oppure seleziona “Web Publication” e imposta un sottodominio quando carichi dalla dashboard), così il bot ottiene un URL pubblico. Le applicazioni web richiedono almeno MEMORY=512:

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

4. In “Event Subscriptions” e nello slash command /hello, imposta la Request URL su https://<subdomain>.squareweb.app/slack/events.

​

Risorse aggiuntive

• Bolt for JavaScript
• Bolt for Python

​

Prossimi passi

​

Contattaci