Zum Inhalt

Slack-Zugangsdaten#

Sie können diese Zugangsdaten verwenden, um die folgenden Knoten zu authentifizieren:

Unterstützte Authentifizierungsmethoden#

  • API-Zugriffstoken:
    • Erforderlich für den Slack Trigger Knoten.
    • Funktioniert mit dem Slack Knoten, wird aber nicht empfohlen.
  • OAuth2:
    • Empfohlene Methode für den Slack Knoten.
    • Funktioniert nicht mit dem Slack Trigger Knoten.

Zugehörige Ressourcen#

Weitere Informationen zum Dienst finden Sie in der Slack-API-Dokumentation.

Verwenden eines API-Zugriffstokens#

Um diese Zugangsdaten zu konfigurieren, benötigen Sie ein Slack Konto und:

  • Ein Zugriffstoken

Um ein Zugriffstoken zu generieren, erstellen Sie eine Slack-App:

  1. Öffnen Sie Ihre Slack-API-Apps Seite.
  2. Wählen Sie Create New App > From scratch.
  3. Geben Sie einen App Name ein.
  4. Wählen Sie den Workspace aus, in dem Sie Ihre App entwickeln werden.
  5. Wählen Sie Create App. Die App-Details werden geöffnet.
  6. Wählen Sie im linken Menü unter Features die Option OAuth & Permissions.
  7. Wählen Sie im Abschnitt Scopes die entsprechenden Scopes für Ihre App aus. Eine Liste der empfohlenen Scopes finden Sie unter Scopes.
  8. Nachdem Sie Scopes hinzugefügt haben, gehen Sie zum Abschnitt OAuth Tokens und wählen Sie Install to Workspace. Sie müssen ein Slack-Workspace-Administrator sein, um diese Aktion auszuführen.
  9. Wählen Sie Allow.
  10. Kopieren Sie das Bot User OAuth Token und geben Sie es als Access Token in Ihren Localmind Automate-Zugangsdaten ein.
  11. Wenn Sie diese Zugangsdaten für den Slack Trigger verwenden, befolgen Sie die Schritte in Slack Trigger-Konfiguration, um die Einrichtung Ihrer App abzuschließen.

Weitere Informationen finden Sie im Slack-API Quickstart.

Slack Trigger-Konfiguration#

So verwenden Sie Ihre Slack-App mit dem Slack Trigger Knoten:

  1. Gehen Sie zu Features > Event Subscriptions.
  2. Aktivieren Sie das Steuerelement Enable Events.

  3. Kopieren Sie in Localmind Automate die Webhook URL und geben Sie sie als Request URL in Ihrer Slack-App ein.

    Request URL

    Slack erlaubt nur eine Request-URL pro App. Wenn Sie Ihren Workflow testen möchten, müssen Sie eine der folgenden Aktionen ausführen:

    • Testen Sie zuerst mit Ihrer Test URL und ändern Sie dann Ihre Slack-App, um die Production URL zu verwenden, sobald Sie überprüft haben, ob alles funktioniert
    • Verwenden Sie die Production URL mit Ausführungsprotokollierung.

  4. Wählen Sie nach der Überprüfung die Bot-Ereignisse aus, die Sie abonnieren möchten. Verwenden Sie das Feld Trigger on in Localmind Automate, um diese Anfragen zu filtern.

    • Um ein Ereignis zu verwenden, das nicht in der Liste enthalten ist, fügen Sie es als Bot-Ereignis hinzu und wählen Sie im Localmind Automate-Knoten Any Event aus.

Weitere Informationen finden Sie unter Quickstart | Configuring the app for event listening.

Scopes#

Scopes bestimmen, welche Berechtigungen eine App hat.

  • Wenn Ihre App im Namen von Benutzern agieren soll, die die App autorisieren, fügen Sie die erforderlichen Scopes im Abschnitt User Token Scopes hinzu.
  • Wenn Sie einen Bot erstellen, fügen Sie die erforderlichen Scopes im Abschnitt Bot Token Scopes hinzu.

Hier ist die Liste der Scopes, die die OAuth-Zugangsdaten erfordern, die ein guter Ausgangspunkt sind:

Scope name Notes
channels:read
channels:write Nicht als Bot-Token-Scope verfügbar
chat:write
files:read
files:write
groups:read
im:read
mpim:read
reactions:read
reactions:write
stars:read Nicht als Bot-Token-Scope verfügbar
stars:write Nicht als Bot-Token-Scope verfügbar
usergroups:read
usergroups:write
users.profile:read
users.profile:write Nicht als Bot-Token-Scope verfügbar
users:read

Häufige Probleme#

Token abgelaufen#

Slack offers token rotation that you can turn on for bot and user tokens. This makes every tokens expire after 12 hours. While this may be useful for testing, Localmind Automate credentials using tokens with this enabled will fail after expiry. If you want to use your Slack credentials in production, this feature must be off.

To check if your Slack app has token rotation turned on, refer to the Slack API Documentation | Token Rotation.

If your app uses token rotation

Please note, if your Slack app uses token rotation, you can't turn it off again. You need to create a new Slack app with token rotation disabled instead.