So hostest du einen Slack-Bot

​

Einführung

​

Voraussetzungen

• Square Cloud Konto: Registriere dich über die Registrierungsseite mit deiner E-Mail-Adresse.
• Aktiver Plan: Stellt dedizierte Ressourcen und optimierte Leistung für deine Anwendung sicher. Sieh dir unsere verfügbaren Pläne an und wähle den passendsten für deine Bedürfnisse.

​

Projekt erstellen

​

Bot-Anwendung auf Slack

1. Gehe zu Slack API - Your Apps und klicke auf “Create New App”.
2. Wähle “From scratch”, gib der App einen Namen und wähle den Workspace aus, in dem du sie installieren wirst.
3. Aktiviere im Abschnitt “Socket Mode” den Socket Mode und erzeuge ein App-Level Token mit dem Scope connections:write. Kopiere es (es beginnt mit xapp-): Das ist dein SLACK_APP_TOKEN.
4. Füge im Abschnitt “OAuth & Permissions” die Scopes hinzu, die dein Bot benötigt (z. B. chat:write, app_mentions:read, commands), installiere die App in deinem Workspace und kopiere das Bot User OAuth Token (es beginnt mit xoxb-): Das ist dein SLACK_BOT_TOKEN.
5. Aktiviere unter “Event Subscriptions” die Events und abonniere das Bot-Event app_mention. Erstelle unter “Slash Commands” den Befehl /hello. Mit aktiviertem Socket Mode verlangt keines von beiden eine Request URL.

​

Projekt entwickeln

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

​

Square Cloud konfigurieren

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 ist die Datei, die Square Cloud ausführt, und MEMORY ist der RAM des Bots in MB. Bots brauchen mindestens 256 MB; mit 512 MB hast du Luft zum Wachsen.
• AUTORESTART=true startet den Bot nach einem Absturz neu. Lies dazu, wie der automatische Neustart funktioniert.
• Es gibt keine SUBDOMAIN: Im Socket Mode braucht der Bot keine öffentliche URL.

​

Tokens festlegen

• Dashboard: Öffne auf der Upload-Seite Erweiterte Konfiguration und füge beide Variablen hinzu. Bei einem bereits deployten Bot fügst du sie auf der Seite Umgebungsvariablen der Anwendung hinzu und startest den Bot neu.
• CLI: Lege sie direkt nach dem Upload des Bots (siehe Deployen) mit squarecloud app env set fest und starte den Bot neu:

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

​

Deployen

​

Über das Dashboard

1

Upload-Seite aufrufen

Rufe die Upload-Seite auf und lade die ZIP-Datei deines Projekts hoch.

2

Umgebung konfigurieren

Nachdem du deine ZIP-Datei hochgeladen hast, musst du den Namen, die Hauptdatei oder Runtime-Umgebung und weitere Einstellungen für dein Projekt konfigurieren.
Wenn du ein Web-Projekt hochlädst, achte darauf, “Web Publication” auszuwählen und deinem Projekt eine Subdomain zuzuweisen.

3

Projekt bereitstellen

Klicke abschließend auf die Schaltfläche “Deploy”, um dein Projekt auf Square Cloud zu hosten.
Nach dem Deploy kannst du den Status und die Logs deines Projekts über das Dashboard überwachen.

4

Bestätige, dass deine App live ist

Dein erstes Deploy dauert in der Regel weniger als eine Minute. Warte im Dashboard, bis der Status deiner Anwendung als “running” angezeigt wird, und prüfe die Logs auf Startfehler.
Wenn du eine Website oder API bereitgestellt hast, öffne https://<deine-subdomain>.squareweb.app in deinem Browser: du solltest sehen, dass deine Anwendung reagiert. Wenn du einen Bot bereitgestellt hast, sende ihm einen Befehl, um zu bestätigen, dass er online ist.

App startet nicht? Im Leitfaden zur Fehlerbehebung findest du die häufigsten Ursachen und Lösungen.

​

Über die 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

​

Den Bot testen

1. Installiere die App im Slack-App-Panel unter “OAuth & Permissions” im Workspace (falls noch nicht geschehen).
2. Prüfe die Anwendungslogs im Square Cloud Dashboard auf Startfehler. Im Socket Mode muss keine Request URL konfiguriert werden: Der Bot verbindet sich mit Slack, sobald er startet.
3. Lade den Bot in einen Kanal ein und erwähne ihn dann oder führe den Befehl /hello aus, um die Antworten zu validieren.

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

​

HTTP-Modus statt Socket Mode verwenden

1. Deaktiviere in den Einstellungen der Slack-App den Socket Mode und kopiere das Signing Secret (unter “Basic Information”) in eine Umgebungsvariable SLACK_SIGNING_SECRET, die du genauso wie die Tokens festlegst.
2. Erstelle die App mit dem Signing Secret statt mit dem App-Level Token und lausche auf dem Port aus der Umgebungsvariable 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. Füge deiner Konfigurationsdatei eine SUBDOMAIN hinzu (oder wähle beim Upload über das Dashboard “Web Publication” und lege eine Subdomain fest), damit der Bot eine öffentliche URL erhält. Webanwendungen benötigen mindestens MEMORY=512:

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

4. Setze unter “Event Subscriptions” und im Slash Command /hello die Request URL auf https://<subdomain>.squareweb.app/slack/events.

​

Weitere Ressourcen

• Bolt for JavaScript
• Bolt for Python

​

Nächste Schritte

​

Kontaktiere uns