Dialogflow-Integration in Google Chat

Durch die Einbindung von Dialogflow in Google Chat können Sie Funktionen in beiden Diensten nutzen:

• Google Chat. Bietet eine Messaging-Plattform mit einer Front-End-Benutzeroberfläche für Einzelunterhaltungen und Chatbereiche. Mit Google Chat können Sie Benutzeroberflächen verbessern, indem Sie Karten mit Symbolen, Bildern, Schaltflächen, Texteingabefeldern oder Apps wie Google Maps erstellen.
• Dialogflow. Bietet eine Plattform für das Verstehen natürlicher Sprache für automatisierte Unterhaltungen und dynamische Antworten. Mit Dialogflow können Sie Nutzerabsichten interpretieren und erfüllen, z. B. Termine planen oder Käufe verarbeiten.

Sie können Google Chat auch verwenden, um Nutzeranfragen zu erfüllen. Mit Dialogflow können Nutzer ihre Anfragen jedoch über eine normale Unterhaltung ausdrücken.

Funktionsweise

Nachdem Sie eine Dialogflow-fähige Google Chat-App erstellt haben, können Sie sie für Folgendes zur Verfügung stellen:

• Öffentlichkeit. Lizenzierte Google Workspace-Nutzer können Ihre App über den Google Workspace Marketplace herunterladen.
• Google Workspace-Domain. Ein Google Workspace-Administrator kann festlegen, welche Apps Nutzer Google Chat hinzufügen können.
• App-Tester. Während des Tests Ihrer App können Sie den Zugriff auf die App einschränken.

In Google Chat kann ein Nutzer eine direkte Unterhaltung mit Ihrer App führen oder die App aus einem Gruppenbereich heraus aufrufen. Folgendes geschieht:

1. Ein Nutzer sendet eine Nachricht an eine Chat-App.
2. Google Chat sendet eine JSON-Anfrage an die Chat-App, die in Cloud Functions gehostet werden kann.
3. Die Chat-App empfängt die JSON-Anfrage und parst sie. Während dieses Parsens ruft die Chat-App Dialogflow auf.
4. Die Chat-App sendet eine Anfrage an Dialogflow, die den Text der Nachricht des Nutzers in natürlicher Sprache enthält.
5. Dialogflow interpretiert den Text des Nutzers und sendet eine Antwort an die Chat-App.
6. Die Chat-App parst die Antwort von Dialogflow und sendet eine JSON-Antwort an Google Chat.
7. Google Chat empfängt die JSON-Antwort der Chat-App und rendert eine Antwort in Form einer Textnachricht, einer Kartennachricht oder einer Dialognachricht auf der Benutzeroberfläche.
8. Google Chat gibt diese Antwort unverändert weiter oder präsentiert eine Rich-Media-Antwort über eine kartenbasierte Benutzeroberfläche.

Auf dieser Seite wird beschrieben, wie Sie Dialogflow in Google Chat einbinden und Rich-Media-Chatantworten konfigurieren.

Hinweis: Google Chat hieß früher Hangouts Chat und Chat-Apps hießen früher Chatbots. Obwohl in Google Chat und der Google Cloud Console der Begriff Apps verwendet wird, wird in der Dialogflow-Konsole weiterhin der Begriff Bots verwendet.

Beschränkungen

Bei Google Chat-Einbindungen kann ein Dialogflow-Agent nur die Standardsprache des Agents verwenden.

Hinweis

Nur lizenzierte Google Workspace-Nutzer können Google Chat-Apps verwenden. Ihr Google Workspace-Administrator muss Folgendes tun:

• Ein Google Workspace-Konto für Sie hinzufügen.
• Nutzern erlauben, Chat-Apps zu installieren.

Dialogflow-Agent erstellen

Wenn Sie noch keinen Dialogflow-Agent erstellt haben, aber sehen möchten, wie ein Agent mit Google Chat interagiert, folgen Sie dieser Kurzanleitung, um einen einfachen Agent zu erstellen. Löschen Sie den Agent jedoch nicht. Als Nächstes richten wir den Agent mit einer Google Chat-Oberfläche ein.

Google Chat einrichten

Sie können Ihren Dialogflow-Agent mit Google Chat einrichten. Dazu haben Sie folgende Möglichkeiten:

• Dialogflow-Konsole
• Google Cloud Console

Google Chat über die Dialogflow-Konsole einrichten

So binden Sie Google Chat über die Dialogflow-Konsole ein:

1. Rufen Sie die Dialogflow ES-Konsole auf.
2. Wählen Sie im linken Menü ein Dialogflow-Projekt aus.
3. Klicken Sie auf Integrations (Integrationen).
4. Klicken Sie auf Google Chat. Wenn Google Chat nicht als Option angezeigt wird, lesen Sie den Abschnitt zur Fehlerbehebung.
5. Wählen Sie aus, wer auf die App zugreifen kann.
6. [Optional] Wählen Sie eine Umgebung aus, in der der Agent ausgeführt werden soll.
7. Klicken Sie auf Start.

Ihre Google Chat-App ist jetzt aktiv und für die ausgewählten Nutzer verfügbar.

Wenn Sie die App konfigurieren möchten, klicken Sie noch einmal auf Google Chat und dann auf BOT-DETAILS KONFIGURIEREN. Daraufhin wird die Google Cloud Console-Seite für die Google Chat API angezeigt, auf der Sie App-Parameter wie den App-Avatar konfigurieren können.

Google Chat über die Google Cloud Console einrichten

So binden Sie Google Chat über die Google Cloud Console ein:

1. Wählen Sie das Dialogflow-Projekt aus.

   Zur Projektauswahl

2. Klicken Sie auf .

3. Klicken Sie auf APIs &Services (APIs und Dienste) und dann auf Library (Bibliothek).

4. Suchen Sie nach Google Chat API und klicken Sie darauf.

5. Klicken Sie auf Aktivieren.

6. Klicken Sie auf den Tab Konfiguration.

7. Konfigurieren Sie die App.

8. Wählen Sie im Bereich Sichtbarkeit aus, wer auf die App zugreifen kann:

   • App-Tester. Wählen Sie Diese Chat-App bestimmten Personen zur Verfügung stellen aus und geben Sie die E-Mail-Adressen der Personen ein.
   • Öffentlichkeit oder Google Workspace-Domain des Unternehmens. Veröffentlichen Sie die App.

9. Klicken Sie auf Speichern. Ihre Google Chat-App ist jetzt aktiv und für die ausgewählten Nutzer verfügbar.

Test

Bevor Sie Ihre Chat-App testen, müssen Sie sie starten, wie unter Google Chat einrichten beschrieben.

Sie haben zwei Möglichkeiten, Ihre App zu testen:

• Direkt mit der App chatten
• App aus einem Gruppenbereich aufrufen

Direkt mit der App chatten

1. Öffnen Sie Google Chat.
2. Klicken Sie im Bereich Chat auf + und wählen Sie Apps suchen aus.
3. Suchen Sie nach Ihrer App und wählen Sie sie aus. Wenn Ihre App nicht in Google Chat aufgeführt ist, lesen Sie den Abschnitt zur Fehlerbehebung.
4. Klicken Sie auf Chat.
5. Geben Sie im Chateingabefeld einen Satz in natürlicher Sprache ein, um die App zu testen.

App aus einem Gruppenbereich aufrufen

1. Öffnen Sie Google Chat.
2. Klicken Sie im Bereich Gruppenbereiche auf + und wählen Sie Gruppenbereich erstellen aus.
3. Geben Sie den Namen Test für den Gruppenbereich ein.
4. Klicken Sie auf Erstellen.
5. Geben Sie im Chateingabefeld @ ein und wählen Sie Ihre App aus, um den Namen automatisch zu vervollständigen.
6. Geben Sie nach dem automatisch vervollständigten App-Namen einen Satz in natürlicher Sprache ein, um die App zu testen.

Fehlerbehebung

Fehler	Lösung
Auf der Seite „Integrations“ (Integrationen) der Dialogflow ES-Konsole wird Google Chat nicht als Option angezeigt.	Aktualisieren Sie die Seite. Klicken Sie im linken Menü auf Intents (Intents) und dann auf Integrations (Integrationen).
Google Chat wird Ihre App nicht als verfügbar auflisten.	Prüfen Sie, ob Ihr Google Workspace-Administrator ein Google Workspace-Konto für Sie hinzugefügt und Nutzern erlaubt hat, Chat-Apps zu installieren. Starten Sie dann die Chat-App, wie unter Google Chat einrichten beschrieben.

Rich-Media-Antworten

Durch diese Einbindung werden einige Rich-Media-Antworten in Nachrichtenformate von Google Chat übersetzt.

Textantworten

Textantworten werden als Textnachrichten an Google Chat gesendet. Mit dieser Formatierung können Sie Text fett oder kursiv formatieren, indem Sie den Text in bestimmte (Markdown-Light) Symbole zusammenfassen.

Die Textnachricht sieht in etwa genauso aus wie die Standard-Textantwort in der Dialogflow-Konsole. Die ursprüngliche API-Antwort sieht jedoch etwas anders aus. Außerdem wird die Plattformkonfiguration auf GOOGLE_HANGOUTS gesetzt, was beim Erstellen von Agents für mehrere Integrationen interessant sein könnte.

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

Infokarten

Kartenantworten werden als Kartennachrichten an Google Chat gesendet.

Google Bilder

Bildantworten werden als Google Chat-Bild-Widgets an Google Chat gesendet.

Benutzerdefinierte Nutzlast

Hinweis: Diese Einbindung unterstützt keine Kartenaktionen.

Wenn Sie andere Google Chat-Nachrichten senden möchten, können Sie eine benutzerdefinierte Nutzlast verwenden.

Mit der benutzerdefinierten Google Chat-Nutzlast können Sie erweiterte Karten erstellen. Eine Karte kann einen oder mehrere Abschnitte enthalten. Jeder Abschnitt kann eine Kopfzeile haben. Im Referenzhandbuch für die Nachrichtenformate von Google Chat finden Sie eine Liste mit möglichen Kombinationen. Wenn Sie jedoch benutzerdefinierte Nutzlasten verwenden, müssen Sie das JSON-Format bereitstellen.

Hinweis: Wenn Sie die Beispiele aus dem Referenzhandbuch in das Feld für die benutzerdefinierte Nutzlast in Dialogflow kopieren und einfügen, vergewissern Sie sich, dass der Editor keine Lint-Fehler enthält. Sie können die Ergebnisse nicht im Dialogflow-Simulator testen, sondern müssen direkt in Google Chat testen.

Hier sehen Sie ein Beispiel für eine benutzerdefinierte Nutzlast im Format „Karten v1“:

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "[e-mail]",
      "imageUrl": "https://goo.gl/aeDtrS"
    },
    "sections": [{
      "widgets": [{
        "keyValue": {
          "icon": "TRAIN",
          "topLabel": "Order No.",
          "content": "12345"
        }
      },
      {
        "keyValue": {
          "topLabel": "Status",
          "content": "In Delivery"
        }
      }]
    },
    {
      "header": "Location",
      "widgets": [{
        "image": {
          "imageUrl": "https://dummyimage.com/600x400/000/fff"
        }
      }]
    },
    {
      "header": "Buttons - I could leave the header out",
      "widgets": [{
        "buttons": [{
          "textButton": {
            "text": "OPEN ORDER",
            "onClick": {
              "openLink": {
                "url": "https://example.com/orders/..."
              }
            }
          }
        }]
      }]
    }]
  }
}

Chat-App beenden

Wenn Sie die Google Chat-App nicht mehr zur Verfügung stellen möchten, haben Sie folgende Möglichkeiten:

• Dialogflow-Konsole

• Google Cloud Console

Chat-App über die Dialogflow-Konsole beenden

1. Rufen Sie die Dialogflow ES-Konsole auf.
2. Wählen Sie im linken Menü ein Dialogflow-Projekt aus.
3. Klicken Sie auf Integrations (Integrationen).
4. Klicken Sie auf Google Chat. Wenn Google Chat nicht als Option angezeigt wird, lesen Sie den Abschnitt zur Fehlerbehebung.
5. Klicken Sie auf Beenden.

Chat-App über die Google Cloud Console beenden

1. Wählen Sie das Dialogflow-Projekt in der Google Cloud Console aus.

   Zur Projektauswahl

2. Klicken Sie auf .

3. Klicken Sie auf APIs &Services (APIs und Dienste) und dann auf Library (Bibliothek).

4. Suchen Sie nach Google Chat API und klicken Sie darauf.

5. Klicken Sie auf Verwalten.

6. Klicken Sie auf den Tab Konfiguration.

7. Wählen Sie im Feld App-Status die Option DEAKTIVIERT aus.

Weitere Informationen

Weitere Informationen zur Verwendung von Google Chat finden Sie hier:

• Google Chat API-Dokumentation für Entwickler
• Google Workspace-Add-on erstellen, das Google Chat erweitert
• Video: Dialogflow in Google Chat einbinden
• Codelab: Dialogflow in Google Chat einbinden