Dialogflow-Integration in Google Chat

Wenn Sie Dialogflow in Google Chat einbinden, können Sie Funktionen in beiden Diensten nutzen:

  • Google Chat Bietet eine Messaging-Plattform mit einer Frontend-Benutzeroberfläche für Einzelunterhaltungen und Chatbereiche. Mit Google Chat können Sie die Benutzeroberfläche durch Karten mit Symbolen, Bildern, Schaltflächen, Textfeldern oder Apps wie Google Maps optimieren.
  • 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. Termine planen oder Käufe abwickeln.

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

Funktionsweise

Nachdem Sie eine Dialogflow-kompatible Google Chat-App erstellt haben, können Sie sie für folgende Nutzer verfügbar machen:

  • Allgemeine Ö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 direkt mit Ihrer App chatten oder die App in einem 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 analysiert 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 analysiert 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 SMS, einer Kartennachricht oder einer Dialognachricht in der Benutzeroberfläche.
  8. In Google Chat wird diese Antwort unverändert geteilt oder es wird eine umfassende Antwort mit einer kartensabasierten Benutzeroberfläche angezeigt.

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

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:

Dialogflow-Agent erstellen

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

Google Chat einrichten

Sie haben zwei Möglichkeiten, Ihren Dialogflow-Agenten mit Google Chat einzurichten:

Google Chat mit der Dialogflow-Konsole einrichten

So integrieren Sie Google Chat über die Dialogflow Console:

  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 angezeigt wird, lesen Sie den Hilfeartikel 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 online und für die von Ihnen ausgewählten Personen verfügbar.

Klicken Sie zum Konfigurieren der App noch einmal auf Google Chat und dann auf BOT-DETAILS KONFIGURIMEREN. Daraufhin wird die Seite der Google Cloud Console für die Google Chat API 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 für bestimmte Personen verfügbar machen aus und geben Sie die E-Mail-Adressen der Personen ein.
    • Eine öffentliche oder Enterprise-Google Workspace-Domain. Veröffentlichen Sie die App.

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

Test

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

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

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 in Google Chat nicht aufgeführt ist, lesen Sie den Hilfeartikel Fehlerbehebung.
  4. Klicken Sie auf Chat.
  5. Geben Sie im Chat-Eingabefeld einen natürlichen Sprachausdruck 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 Chatfeld @ ein und wählen Sie Ihre App aus, damit der Name automatisch vervollständigt wird.
  6. Geben Sie nach dem automatisch ausgefüllten App-Namen einen natürlichen Sprachausdruck 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 Menü auf der linken Seite auf Intents und dann auf Integrationen.
Ihre App wird in Google Chat nicht als verfügbar angezeigt. Ihr Google Workspace-Administrator muss ein Google Workspace-Konto für Sie erstellt und Nutzern die Installation von Chat-Apps erlaubt haben. 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 einschließen.

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.

Images

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

Benutzerdefinierte Nutzlast

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.

Hier ist ein Beispiel für eine benutzerdefinierte Nutzlast im Cards v1-Format:

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "pizzadelivery@example.com",
      "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

Sie haben folgende Möglichkeiten, die Verfügbarkeit der Google Chat App zu deaktivieren:

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 angezeigt wird, lesen Sie den Hilfeartikel Fehlerbehebung.
  5. Klicken Sie auf Beenden.

Chat-App über die Google Cloud Console beenden

  1. Wählen Sie in der Google Cloud Console 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 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: