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

Nur die Standard-Agent-Sprache wird von dieser Integration 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 Always Show My Bot as Online (Meinen Bot immer als online anzeigen) und bearbeiten Sie App Dislay Name (App Dislay Name) in folgenden Fällen: erforderlich (das sehen die Nutzer für deinen Bot)

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 Client ID (Client-ID), Client Secret (Client-Secret) und Verification Token (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, Event Fordert URLs (von Dialogflow bereitgestellt) und Ereignisabos an.

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 unter Kurzanleitung: Unterschiede zwischen alten und neuen Slack-Apps

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 in das Feld Request URL (Anfrage-URL)
   
   Nach kurzer Zeit sollte in Grün der Hinweis „Bestätigt“ zu sehen sein. oberhalb der Anforderungs-URL ein.

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 ist eine Liste mit Ereignisse, die wir hinzufü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 der Aktualisierung dieser Einstellungen fertig sind, klicken Sie auf die Schaltfläche Änderungen speichern unten auf der Seite.

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 im Abschnitt Share Your App with Your Workplace (App für Arbeitsplatz freigeben) auf die Schaltfläche Add to Schaltfläche „Slack“
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 Seite Integrations für den Kundenservicemitarbeiter auf und klicken Sie auf den Schalter 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 hinzufügen möchten, müssen Sie den Bot öffentlich machen.

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`."
  }
}