Slack-Integration

Die Slack-Integration erlaubt es Anfragen aus Slack heraus zu erstellen.

Einrichtung

Zur Einrichtung muss erst eine App in Slack erstellt werden. Anschließend muss die Verbindung zu dieser App in der biz.Suite hergestellt werden.

Slack App

Zunächst muss man die Slack App-Verwaltung öffnen. Dort muss eine neue App erstellt werden. Am einfachsten ist es, die App aus einem Manifest zu erstellen.

Dafür muss die Option "From a manifest" gewählt werden. Eine Manifest-Datei sieht folgendermaßen aus:

{
    "display_information": {
        "name": "biz.Suite"
    },
    "features": {
        "bot_user": {
            "display_name": "biz.Suite",
            "always_online": false
        },
        "shortcuts": [
            {
                "name": "Anfrage erstellen",
                "type": "message",
                "callback_id": "create_ticket",
                "description": "Erstelle eine Anfrage mit dem Inhalt dieser Nachricht"
            }
        ]
    },
    "oauth_config": {
        "scopes": {
            "bot": [
                "commands",
                "users:read",
                "users:read.email",
                "files:read"
            ]
        }
    },
    "settings": {
        "interactivity": {
            "is_enabled": true,
            "request_url": "https://BIZSUITE_DOMAIN.biz-suite.io/api/slack-interactions?sysclient=MANDANTEN_ID"
        },
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false
    }
}

warnung

Es müssen vorher noch Anpassungen am Beispiel-Manifest vorgenommen werden. Im Feld "request_url" muss BIZSUITE_DOMAIN durch die Ziel-Domain ersetzt werden und MANDANTEN_ID durch die ID des Ziel-Mandanten.

Ist die App erstellt, muss diese noch installiert werden. Dazu geht man in der Slack App in der Seitenleiste auf "Install App". Dort findet sich ein Button "Install to SPACE_NAME". Dieser muss betätigt werden. Ist die Installation abgeschlossen erscheint ein "Bot User OAuth Token".

biz.Suite

Ist die Slack-App eingerichtet und installiert, kann die Einrichtung in der biz.Suite beginnen. Gehen Sie unter den Systemeinstellungen auf den Punkt "OAuth Einstellungen".

Dort muss ein neues Element angelegt werden.

info

Legen Sie die OAuth-Einstellung in dem Mandanten an, in welchem Sie die Anfragen angelegt haben möchten.

Folgende Werte sind auszufüllen:

Feld	Wert
Service Name	z.B. Slack-Integration
Access Token	Das Bot Token aus der App-Installation
Redirect Uri	Die Domain der Slack-Organisation (beispiel.slack.com)
Weitere Informationen	Der Wert von "Signing Secret". Dieser findet sich in der Slack-App unter "Basic Information"

Funktionsweise

Die App fügt zu Slack einen "Message Shortcut" hinzu. Dieser ermöglicht es über die 3 Punkte an einer Nachricht automatisch eine Anfrage in der biz.Suite anzulegen. Der Mandant ergibt sich aus der Einrichtung (s.o.). Wurde die Anfrage erfolgreich erstellt, folgt eine Antwort auf die Nachricht mit dem Titel und der Nummer der Anfrage.