Um Ihren digitalen Assistenten (oder Standalone-Bot) in Slack verfügbar zu machen, benötigen Sie einen Slack-Workspace, in dem Sie über die erforderlichen Berechtigungen zum Erstellen einer Slack-App verfügen.

Wenn Ihnen kein derartiger Workspace zur Verfügung steht, können Sie Ihren eigenen Workspace erstellen. Siehe Seite Create a new workspace von Slack.

1. Gehen Sie zur Seite Your Apps von Slack.

2. Klicken Sie auf Slack-App erstellen, und wählen Sie Von Grund auf aus.

3. Füllen Sie im Dialogfeld "Create a Slack App" die Felder App Name und Development Slack Workspace aus, und klicken Sie auf Create App.

   Nachdem die App erstellt wurde, wird die zugehörige Seite mit allgemeinen Informationen angezeigt.

4. Scrollen Sie zum Abschnitt "App Credentials" der Seite, und notieren Sie sich die Werte für Client ID, Client Secret und Signing Secret.

   Sie benötigen diese Zugangsdaten, wenn Sie den Kanal in Digital Assistant einrichten.

Sie fügen OAuth-Geltungsbereiche für Berechtigungen hinzu, die Sie dem Bot und dem Benutzer erteilen möchten.

1. Wählen Sie in der linken Navigationsleiste der Webkonsole für Ihre Slack-App im Abschnitt "Features" die Option OAuth and Permissions aus.

2. Scrollen Sie zu dem Abschnitt Scopes der Seite.

3. Die Geltungsbereiche fallen in folgende Kategorien:

   • Bot Token Scopes
   • User Token Scopes

4. Fügen Sie im Abschnitt "Bot Token Scopes" die Geltungsbereiche hinzu, die den Berechtigungen auf Botebene entsprechen, die Sie zulassen möchten. Mindestens die folgenden Bottokengeltungsbereiche sind erforderlich:

   • chat:write
   • im:history
   • users:read

   Je nach den Features des Skills sind möglicherweise andere Geltungsbereiche erforderlich. Beispiel: Die folgenden Geltungsbereiche sind für die Arbeit mit Anhängen erforderlich:

   • files:read
   • files:write

5. Fügen Sie im Abschnitt "User Token Scopes" die Geltungsbereiche hinzu, die den Berechtigungen auf Benutzerebene entsprechen, die Sie zulassen möchten. Die folgenden Geltungsbereiche für Benutzertoken sind erforderlich:

   • files:read
   • files:write

Abhängig von den Anforderungen Ihres Bots müssen Sie möglicherweise andere Geltungsbereiche hinzufügen.

1. Scrollen Sie zurück zum Anfang der Seite OAuth & Permissions.

2. Klicken Sie im Abschnitt OAuth Tokens & Umleitungs-URLs auf In Workspace installieren.

   Daraufhin wird eine Seite angezeigt, auf der die App demonstriert wird.

3. Klicken Sie unten auf der Seite auf Allow.

Nachdem Sie diesen Schritt abgeschlossen haben, sollten Sie die App in Ihrem Slack-Arbeitsbereich anzeigen können, indem Sie in der linken Navigationsleiste Apps auswählen.

1. Klicken Sie in Digital Assistant im linken Menü auf Kanäle, und wählen Sie Benutzer aus.

2. Klicken Sie auf + Kanal, um das Dialogfeld "Kanal erstellen" zu öffnen.

3. Geben Sie einen Namen für Ihren Kanal ein.

4. Wählen Sie Slack als Kanaltyp aus.

5. Geben Sie unter Client-ID, Client Secret und Signatur-Secret die Werte ein, die Sie beim Erstellen der Slack-App erhalten haben.

   Sie können diese Werte auf der Seite "Settings" der Slack-App abrufen.

6. Wenn Sie den Kanal für Gruppenchats einrichten und Nachrichten an die Gruppe senden möchten, ohne den Namen der Slack-App zu nennen, wählen Sie Nachrichten ohne App-Achtung im Gruppenchat zulassen aus.

7. Klicken Sie auf Erstellen.

8. Kopieren Sie die WebHook-URL auf der Seite "Kanäle", und fügen Sie sie an einer geeigneten Stelle in Ihrem System ein. Sie benötigen diese Angabe, um die Einrichtung der Slack-App abzuschließen.

9. Klicken Sie auf , und wählen Sie den digitalen Assistenten oder Skill aus, den Sie mit dem Kanal verknüpfen möchten.

10. Wählen Sie in der Dropdown-Liste Weiterleiten an den digitalen Assistenten oder den Skill aus, den Sie dem Kanal zuordnen möchten.

11. Aktivieren Sie das Steuerelement Kanal aktiviert.

1. Wählen Sie in der linken Navigationsleiste der Webkonsole für die Slack-App die Option Interactivity & Shortcuts aus.

2. Setzen Sie den Schalter Interactivity auf EIN.

3. Fügen Sie in die Felder Request URL und Options Load URL die Webhook-URL ein, die generiert wurde, als Sie den Kanal in Digital Assistant erstellt haben.

4. Klicken Sie auf Änderungen speichern.

5. Wählen Sie in der linken Navigationsleiste die Option OAuth & Permissions aus.

6. Klicken Sie im Feld Redirect URLs auf Add New Redirect URL.

7. Fügen Sie die Webhook-URL ein, hängen Sie /authorizeV2 an, und klicken Sie auf Add.

8. Klicken Sie auf Save URLs.

9. Wählen Sie in der linken Navigationsleiste die Option App Home aus.

10. Aktivieren Sie im Abschnitt Your App’s Presence in Slack den Schalter Always Show My Bot as Online.

11. Scrollen Sie auf der Seite nach unten zum Abschnitt Registerkarten anzeigen, und aktivieren Sie den Schalter Registerkarte "Nachrichten".

12. Aktivieren Sie das Kontrollkästchen Senden von Schrägstrichbefehlen und Nachrichten über die Registerkarte "Nachrichten" durch Benutzer zulassen.

13. Wählen Sie in der linken Navigationsleiste Event Subscriptions aus.

14. Setzen Sie den Schalter Enable Events auf EIN.

15. Fügen Sie im Feld Request URL die Webhook-URL ein.

    Nachdem Sie die URL eingegeben haben, wird ein grünes Label Verified neben dem Label "Request URL" angezeigt.

16. Blenden Sie den Abschnitt Abonnement für Botereignisse der Seite ein, klicken Sie auf Add Bot User Event, und fügen Sie das folgende Ereignis hinzu:

    • message.im
17. Wenn Sie den Bot in Gruppenchats verfügbar machen möchten, fügen Sie auch die folgenden Ereignisse hinzu:
    • app_mention
    • message.mpim
    • message.channels

18. Klicken Sie auf Änderungen speichern.

19. Wählen Sie in der linken Navigationsleiste die Option Manage Distribution aus.

20. Klicken Sie auf die Schaltfläche Add to Slack und dann auf Allow.

    An dieser Stelle sollten Sie folgende Meldung erhalten: You've successfully installed your App in Slack.

Wenn der Slack-Kanal und die Messagingkonfiguration abgeschlossen sind, können Sie Ihren Bot (digitalen Assistenten oder Skill) in Slack testen.

1. Öffnen Sie den Slack-Workspace, in dem Sie die App installiert haben.

2. Wählen Sie in der linken Navigationsleiste die App aus, die mit Ihrem digitalen Assistenten verknüpft ist.

3. Geben Sie im Nachrichtenfeld Text ein, um mit der Kommunikation mit dem digitalen Assistenten zu beginnen.

Ab Version 20.6 von Oracle Digital Assistant basiert das Erstellen von Slack-Kanälen auf einem aktualisierten OAuth-Fluss in Slack-Apps. Dieser aktualisierte Fluss ermöglicht feiner abgestimmte Geltungsbereiche. Die Anweisungen für das Kanalsetup in dieser Dokumentation basieren auf dem neuen OAuth-Fluss.

Weitere Einzelheiten zum aktualisierten OAuth-Fluss finden Sie unter https://api.slack.com/authentication/oauth-v2.

Slack-Kanäle in Digital Assistant unterstützen die folgenden Funktionen:

• Text (Senden und Empfangen)
• Bilder (Senden und Empfangen)
• Dateien (Senden wird teilweise, Empfangen vollständig unterstützt)
• Emojis (Senden wird teilweise, Empfangen vollständig unterstützt)
• Links
• Postbacks
• Benutzerdefinierte Eigenschaften
• Karussellkomponenten (werden jedoch vertikal anstatt horizontal gerendert)
• Listenkomponenten

Mit Slack können Sie Nachrichten mit Markdown formatieren. Siehe https://api.slack.com/reference/surfaces/formatting in der Slack-API-Dokumentation.

Wenn Sie Ihren Skill auf mehrere Kanäle mit unterschiedlichen Formatierungsfunktionen und Syntax ausrichten, können Sie grundlegende HTML-Markups in Ihren Nachrichten verwenden. Wenn Sie dies tun, wird dieses Markup automatisch in das Preisabschriftformat von Slack konvertiert, wenn die Nachricht an den Kanal übertragen wird. Dies ist besonders nützlich, wenn Sie Ihre Fähigkeiten zusätzlich zu Slack auf andere Kanäle ausrichten. Siehe Rich-Text-Formatierung in Kanälen.

Für Slack-Kanäle in Digital Assistant gelten die folgenden Nachrichten-Constraints:

• Textnachrichten
  • Maximale Länge der Textnachricht: 3.000 Zeichen. Wenn die Länge 3000 überschreitet, wird der Text auf mehrere Nachrichten aufgeteilt.
  • Maximale Länge des Textaktionslabels: 30 Zeichen
  • Zulässige Textaktionen: Postback, URL
• Horizontale Karten
  • Unterstützt? Nein. Das Layout der Karte wird in vertikal konvertiert.
• Vertikale Karten
  • Maximale Länge des Titels: 3.000 Zeichen
  • Maximale Länge der Beschreibung: 3.000 Zeichen
  • Maximale Länge des Kartenaktionslabels: 30 Zeichen
  • Maximale Anzahl der Karten: 100
  • Zulässige Arten von Kartenaktionen: Postback, URL
  • Zulässige Arten von Kartenlistenaktionen: Postback, URL
• Anhangsnachrichten
  • Unterstützt? Ja
  • Zulässige Aktionen: Postback, URL
• Aktionsschaltflächen
  • Maximale Länge des globalen Aktionslabels: 30 Zeichen
  • Zulässige globale Aktionen: Postback, URL

Bei Slack-Channels können Sie die Funktionalität von Common Response-Komponenten um spezifische Slack-Funktionen erweitern.

Sie können auf die Erweiterungen zugreifen, indem Sie das Element channelCustomProperties in den Metadaten der Common Response-Komponente und die entsprechenden Eigenschaften festlegen. Der Code hat das folgende Format:

...
            channelCustomProperties:
            - channel: "slack"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Nachfolgend finden Sie die verfügbaren benutzerdefinierten Eigenschaften für Slack-Kanäle:

Im Folgenden finden Sie ein Beispiel für die Verwendung der benutzerdefinierten Eigenschaft renderActionsAsDropDown.

responseItems:
- type:
 "text"
  text: "Here is a list of the UI features of the Common Response Component:"
  actions:
  - ...
  channelCustomProperties:
  - channel: "slack"
    properties:
      renderActionsAsDropDown: false

Im Folgenden finden Sie ein Beispiel für die Verwendung der benutzerdefinierten Eigenschaft renderActionsAsDropDown mit verschachtelten Eigenschaften für postbackActions, cardPostbackActions und globalPostbackActions.

responseItems:
- type: "text"
  text: "Here is a list of the UI features of the Common Response Component:"
  actions:
  - ...
  channelCustomProperties:
  - channel: "slack"
    properties:
      renderActionsAsDropDown:
        postbackActions: false
        cardPostbackActions: true
        globalPostbackActions: true

Allgemeine Informationen zu channelCustomProperties finden Sie unter Kanalspezifische Erweiterungen.

Sie können eine Schaltfläche erstellen, um ein Slack-Modal in einer Komponente "Allgemeine Antwort" aufzurufen. Dazu setzen Sie die Aktionseigenschaft der Schaltfläche auf system.openModal und nehmen eine Variable namens system.dialogPayload vom Typ map auf. Die Aktionsmetadaten sehen in etwa wie das folgende Snippet aus:

          actions:
          - label: "Open Dialog"
            type: "postback"
            payload:
              action: "system.openModal" 
              variables:
                system.dialogPayload: ${dialogPayload}

Der Wert von system.dialogPayload wird in der Regel in einer benutzerdefinierten Komponente festgelegt, kann aber auch inline definiert oder mit einer Komponente "Variable festlegen" verwendet werden.

Wenn der Benutzer die Eingabe im Slack-Dialogfeld sendet, legt die Komponente "Allgemeine Antwort" den system.dialogSubmitted-Übergang so fest, dass in einen Status übergegangen wird, in dem die übergebenen Werte verarbeitet werden. Die übermittelten Werte werden in Variablen mit demselben Namen gespeichert.

Sie können festlegen, wie die weitergeleiteten Feldwerte verarbeitet werden sollen. Die Komponente "Allgemeine Antwort" führt keine automatischen Aktualisierungen von Entitywerten durch. Sie speichert die Werte lediglich in Variablen. Sie verarbeiten diese Werte in der Regel in einer benutzerdefinierten Komponente, sodass Sie bei Bedarf zusätzliche Validierungen durchführen können. Am einfachsten ist es, wenn Sie die weitergeleiteten Feldwerte in einer Zeichenfolgenvariable speichern und die Entitywerte dann mit der Komponente "Entity abgleichen" aktualisieren.

Die vollständige Dokumentation zu den Elementtypen, die in der Payload des Slack-Dialogfelds unterstützt werden, finden Sie unter https://api.slack.com/reference/block-kit/block-elements. Die in der Dialog-Payload angegebene Struktur muss mit der in der Slack-Dokumentation beschriebenen Struktur identisch sein.

Sie können eine Schaltfläche erstellen, um ein Slack-Dialogfenster in einer Komponente "Allgemeine Antwort" aufzurufen. Dazu setzen Sie die Aktionseigenschaft der Schaltfläche auf system.openDialog und nehmen eine Variable namens system.dialogPayload auf. Die Aktionsmetadaten sehen in etwa wie das folgende Snippet aus:

            actions:
              - label: "Edit"
                type: "postback"
                payload:
                  action: "system.openDialog"
                  variables:
                    system.dialogPayload: ${dialogPayload}

Der Wert von system.dialogPayload wird in der Regel in einer benutzerdefinierten Komponente festgelegt, kann aber auch inline definiert oder mit einer Komponente "Variable festlegen" verwendet werden.

Wenn der Benutzer die Eingabe im Slack-Dialogfeld sendet, legt die Komponente "Allgemeine Antwort" den system.dialogSubmitted-Übergang so fest, dass in einen Status übergegangen wird, in dem die übergebenen Werte verarbeitet werden. Die übermittelten Werte werden in Dialogablaufvariablen mit demselben Namen gespeichert.

Sie können festlegen, wie die weitergeleiteten Feldwerte verarbeitet werden sollen. Die Komponente "Allgemeine Antwort" führt keine automatischen Aktualisierungen von Entitywerten durch. Sie speichert die Werte nur in Dialogablaufvariablen. Sie verarbeiten diese Werte in der Regel in einer benutzerdefinierten Komponente, sodass Sie bei Bedarf zusätzliche Validierungen durchführen können. Am einfachsten ist es, wenn Sie die weitergeleiteten Feldwerte in einer Zeichenfolgenvariable speichern und die Entitywerte dann mit der Komponente "Entity abgleichen" aktualisieren.

Weitere Informationen zu anderen Eigenschaften und Elementtypen, die in der Payload des Slack-Dialogfensters unterstützt werden, finden Sie unter https://api.slack.com/dialogs#top-level_dialog_attributes. Die Struktur der Dialog-Payload muss mit der in der Slack-Dokumentation beschriebenen Struktur identisch sein.