Slack

Mit der Slack-Integration von Dialogflow können Sie mühelos Ihre eigenen Slack-Apps und -Bots erstellen und für Natural Language Understanding trainieren.

Hinweis: Wenn Sie eine Drittanbieterintegration verwenden, werden Anfragen und Endnutzerdaten sowohl an Google als auch an den Drittanbieter gesendet. Für das Bearbeiten dieser Anfragen durch Google gelten die Nutzungsbedingungen, das SLA, die Preise und die Kontingente für Ihre Agent-Edition. Für das Bearbeiten dieser Anfragen durch den Drittanbieter gelten die Nutzungsbedingungen, das SLA, die Preise und die Kontingente des Drittanbieters.

Beschränkungen

Von dieser Integration wird nur die Standardsprache des Kundenservicemitarbeiters unterstützt.

Slack einrichten

Sie benötigen Folgendes, um die Slack-Integration für Ihren Agent einzurichten:

• ein Slack-Konto
• ein Slack-Team

Slack-App erstellen

1. Öffnen Sie die Slack Developer Console.
2. Geben Sie einen Namen für die App ein.
3. Wählen Sie ein Team aus, mit dem die App verknüpft werden soll.
4. Klicken Sie auf die Schaltfläche Create App.

Bot-Nutzer hinzufügen

1. Klicken Sie im linken Menü auf OAuth und Berechtigungen.
2. Gehen Sie zu Bereiche und prüfen Sie, ob die folgenden OAuth-Bereiche im Abschnitt "Bot-Token-Bereiche" vorhanden sind:
3. Klicken Sie im linken Menü auf die Anwendungsstartseite.
4. Aktivieren Sie Immer meinen Bot als Online anzeigen und bearbeiten Sie gegebenenfalls den Namen der Anwendung, da die Nutzer Ihren Bot sehen werden.

Integration in Dialogflow aktivieren

Klicken Sie in der Slack Developer Console links auf Basic Information (Grundlegende Informationen). und scrollen Sie nach unten zum Abschnitt App-Anmeldedaten. Notieren Sie sich die Angaben unter Client-ID, Client-Secret und Bestätigungstoken.

Slack mit Dialogflow verknüpfen

1. Klicken Sie in Dialogflow im linken Menü auf Integrations (Integrationen).
2. Klicken Sie auf die Kachel Slack.
3. Geben Sie die zugehörigen Werte in die folgenden Felder ein:
   1. Client-ID
   2. Client-Secret
   3. Verification Token
4. Klicken Sie auf Start.

Slack einrichten – Fortsetzung

Nachdem Sie Slack und Dialogflow eingerichtet haben, aktivieren Sie OAuth sowie die (von Dialogflow bereitgestellten) Ereignisanfrage-URLs und die Ereignisabos.

OAuth-URL hinzufügen

1. Kopieren Sie den Wert im Feld OAuth URL auf der Dialogflow-Seite für die Slack-Einstellungen.

Hinweis: Wenn Ihre Slack App eine klassische Slack-Anwendung ist und noch nicht aktualisiert wurde, klicken Sie auf der Dialogflow-Seite für die Slack-Einstellungen auf URLs für den alten Slack-Workflow anzeigen und kopieren Sie dann die OAuth-URL. Weitere Informationen finden Sie in der Kurzanleitung zu Unterschieden zwischen alten und neuen Slack-Anwendungen.

1. Rufen Sie die Slack Developer Console auf und klicken Sie im linken Menü auf OAuth & Permissions (OAuth & Berechtigungen).
2. Klicken Sie auf die Schaltfläche Add a new Redirect URL (Neue Weiterleitungs-URL hinzufügen) und fügen Sie die OAuth-URL ein.
3. Klicken Sie auf Add.
4. Klicken Sie auf URLs speichern.

Ereignisanfrage-URL hinzufügen und Ereignisabos aktivieren

1. Kopieren Sie auf der Dialogflow-Seite für die Slack-Einstellungen den Wert im Feld Event Request URL.
2. Öffnen Sie die Slack Developer Console und klicken Sie im linken Menü auf Event Subscriptions (Ereignisabos).
3. Klicken Sie auf den Schieberegler, um Ereignisse zu aktivieren, und fügen Sie die Ereignisabo-URL in das Feld Request URL (Anfrage-URL) ein.
   
   Kurz darauf wird über dem Feld „Request URL“ (Anfrage-URL) in grün „Verified“ (Bestätigt) angezeigt.

4. Klicken Sie unter Subscribe to Bot Events (Bot-Ereignisse abonnieren) auf Add Bot User Event (Bot-Nutzerereignis hinzufügen). Schaltfläche
   
   Dadurch werden das Textfeld und die Liste der Ereignisse angezeigt. Sie können in dieses Feld Begriffe eingeben, um nach Ereignissen zu suchen, auf die der Bot reagieren soll. Hier eine Liste der Ereignisse, die Sie einfügen sollten:
   

   Ereignisname	Ereignisbeschreibung
   message.im	Eine Nachricht wurde in einem Kanal für Direktnachrichten gepostet
   message.groups	Eine Nachricht wurde in einem privaten Kanal gepostet
   message.channels	Eine Nachricht wurde in einem Kanal gepostet
   im_created	Eine Direktnachricht wurde erstellt. Klicken Sie im Abschnitt Ereignisse im Namen von Nutzern abonnieren auf das Symbol Workspace-Ereignis hinzufügen, um das im_create-Ereignis hinzuzufügen, und klicken Sie dann auf Änderungen speichern.

   

5. Wenn Sie mit diesen Einstellungen fertig sind, klicken Sie unten auf der Seite auf Änderungen speichern.

Slack-Bot einem Team hinzufügen

1. Klicken Sie in der Slack Developer Console im linken Menü auf Manage Distribution (Verteilung verwalten).
2. Klicken Sie unter Anwendung für meinen Arbeitsplatz freigeben auf Zu Slack hinzufügen .
3. Klicken Sie auf der nächsten Seite auf die Schaltfläche Authorize, um den Agent hinzuzufügen.

Testen

Sie können Ihren Agent testen, ohne einen öffentlichen Slack-Bot zu erstellen. Rufen Sie dazu die Integrations (Integrationen) für den Agent und klicken Sie auf den Schieberegler in der Kachel Slack. Klicken Sie dann im Pop-up-Fenster auf die Schaltfläche Test In Slack.

Sie werden aufgefordert, sich in Slack anzumelden. Öffnen Sie nach der Anmeldung die Instanz und suchen Sie nach dem Bot-Nutzer namens @dialogflow-bot. Sie können den Agent zum Testen als Direktnachricht senden oder zu Kanälen in der Instanz hinzufügen.

Hinweis: Wenn Sie den Namen des Agents ändern oder ein Logo einfügen möchten, müssen Sie den Bot veröffentlichen.

Veranstaltungen

Die folgenden Ereignisse werden durch diese Integration aufgerufen:

Ereignis	Beschreibung
SLACK_WELCOME	Wird ausgelöst, wenn ein Nutzer eine Unterhaltung mit Ihrem Slack-Bot startet.

Rich-Media-Antworten

Die folgenden Rich-Media-Antworten werden unterstützt:

Bildantworten

Unterstützte Formate und Größen:

• GIF
• JPEG
• PNG
• BMP

Kartenantworten

In Slack sind für Infokarten keine Pflichtfelder vorhanden. Jede Kombination von Elementen kann verwendet werden.

Schaltflächen mit einer URL und einem Text-Postback werden unterstützt. Schaltflächen mit einer URL werden als Hyperlinks angezeigt.

Kurzantwort-Antworten

Schnelle Antworten werden in Slack-Integrationen unterstützt, die mit einem Klick durchgeführt werden können, und entsprechen einer Textversion der interaktiven Slack-Schaltflächen.

Benutzerdefinierte Nutzlastantworten

Formatierter Text bei der Slack-Integration mit einem Klick

Ihre Slack-Bots können formatierten Text senden, wie das folgende Beispiel zeigt:

{
  "slack": {
    "text": "This is an example of *bold*, _italic_, and `code`."
  }
}