Dialogflow-Integration in Google Chat

Durch die Integration von Dialogflow in Google Chat können Sie Funktionen beider Dienste 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 NLU-Plattform (Natural Language Understanding) für automatisierte Unterhaltungen und dynamische Antworten. Mit Dialogflow können Sie Nutzerabsichten interpretieren und erfüllen, z. B. um Termine zu planen oder Käufe zu verarbeiten.

Sie können Nutzeranfragen zwar auch über Google Chat erfüllen, mit Dialogflow können Nutzer ihre Anfragen jedoch in Form einer normalen Unterhaltung äußern.

Funktionsweise

Nachdem Sie eine Dialogflow-fähige Google Chat-App erstellt haben, können Sie sie für Folgendes verfügbar machen:

• Ö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 Sie Ihre App testen, 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 über einen Gruppenbereich 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 Parsings ruft die Chat-App Dialogflow auf.
4. Die Chat-App sendet eine Anfrage an Dialogflow, die den Nachrichtentext 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 umfangreiche Antwort über eine kartenbasierte Benutzeroberfläche.

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

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

Beschränkungen

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

Hinweise

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

• Fügen Sie ein Google Workspace-Konto für sich hinzu.
• 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 Agenten jedoch nicht. Als Nächstes richten wir den Agenten mit einer Google Chat-Schnittstelle ein.

Google Chat einrichten

Sie haben zwei Möglichkeiten, Ihren Dialogflow-Agent für Google Chat einzurichten:

• Dialogflow-Konsole
• Google Cloud Console

Google Chat mit der Dialogflow-Konsole einrichten

So integrieren Sie Google Chat über die Dialogflow-Konsole:

1. Rufen Sie die Dialogflow ES-Konsole auf.
2. Wählen Sie im Menü auf der linken Seite ein Dialogflow-Projekt aus.
3. Klicken Sie auf Integrations (Integrationen).
4. Klicken Sie auf Google Chat. Wenn Google Chat nicht zu den Optionen gehört, finden Sie hier Informationen 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 live und für die von Ihnen ausgewählten Personen verfügbar.

Wenn Sie die App konfigurieren möchten, klicken Sie noch einmal auf Google Chat und dann auf BOT-DETAILS KONFIGURIEREN. Die Google Cloud -Konsolenseite für die Google Chat API wird geöffnet. Dort können Sie App-Parameter wie den App-Avatar konfigurieren.

Google Chat mit der Google Cloud Console einrichten

So integrieren Sie Google Chat über die Google Cloud Console:

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

   Zur Projektauswahl

2. Klicken Sie auf .

3. Klicken Sie auf APIs und Dienste und dann auf 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 Diesen Chat bestimmten Personen zur Verfügung stellen aus und geben Sie die E-Mail-Adressen der Personen ein.
   • Eine öffentliche oder Enterprise-Google Workspace-Domain. App veröffentlichen

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

Test

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

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

• Direkt mit der App chatten
• App über einen 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, finden Sie hier weitere Informationen.
4. Klicken Sie auf Chat.
5. Geben Sie im Chateingabefeld einen Satz in natürlicher Sprache ein, um die App zu testen.

App über einen 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 des Gruppenbereichs Test 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 natürlichsprachlichen Satz ein, um die App zu testen.

Fehlerbehebung

Fehler	Lösung
Auf der Seite Dialogflow ES-Konsole > Integrationen wird Google Chat nicht als Option angezeigt.	Aktualisieren Sie die Seite: Klicken Sie im linken Menü auf Intents und dann auf Integrationen.
Ihre App wird in Google Chat nicht als verfügbar aufgeführt.	Ihr Google Workspace-Administrator muss ein Google Workspace-Konto für Sie hinzugefügt und Nutzern die Installation von Chat-Apps erlaubt haben. Achten Sie dann darauf, dass Sie die Chat App wie unter Google Chat einrichten beschrieben gestartet haben.

Rich-Media-Antworten

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

Textantworten

Textantworten werden als Nachrichten 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 SMS-Antwort 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.

Bilder

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

Benutzerdefinierte Nutzlast

Hinweis :Diese Integration 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 Referenzleitfaden in das Feld für die benutzerdefinierte Nutzlast in Dialogflow kopieren und einfügen, achten Sie darauf, 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 „Cards 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 verhindern möchten, dass die Google Chat App verfügbar ist, 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 Menü auf der linken Seite ein Dialogflow-Projekt aus.
3. Klicken Sie auf Integrations (Integrationen).
4. Klicken Sie auf Google Chat. Wenn Google Chat nicht zu den Optionen gehört, finden Sie hier Informationen zur Fehlerbehebung.
5. Klicken Sie auf Beenden.

Chat-App über die Google Cloud beenden

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

   Zur Projektauswahl

2. Klicken Sie auf .

3. Klicken Sie auf APIs und Dienste und dann auf 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:

• Entwicklerdokumentation zur Google Chat API
• Google Workspace-Add-on entwickeln, das Google Chat erweitert
• Video: Dialogflow in Google Chat einbinden
• Codelab: Dialogflow in Google Chat einbinden