Diese Seite wurde von der Cloud Translation API übersetzt.

Dialogflow-Integration in Google Chat

Durch die Einbindung von Dialogflow in Google Chat nutzen Sie Features in beiden Diensten:

Google Chat Stellt eine Messaging-Plattform mit einer Frontend-Benutzeroberfläche bereit. für Einzelunterhaltungen und Chatbereiche. Mit Google Chat haben Sie folgende Möglichkeiten: verbessern Benutzeroberflächen, indem sie Karten mit Symbolen, Bildern, Schaltflächen Texteingabefelder oder Apps wie Google Maps verwenden.
Dialogflow. Bietet eine NLU-Plattform (Natural Language Understanding) für automatisierte Unterhaltungen und dynamische Antworten. Über Dialogflow können Sie Nutzer-Intents interpretieren und erfüllen, z. B. um oder Käufe abwickeln.

Sie können zwar auch Google Chat für die Bearbeitung von Nutzeranfragen verwenden, aber mit Dialogflow lässt sich Nutzende ihre Wünsche in einem normalen Gespräch ausdrücken.

Funktionsweise

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

Öffentliche Nutzung: Lizenzierte Google Workspace-Nutzer können Ihre App herunterladen über den Google Workspace Marketplace.
Google Workspace-Domain. Ein Google Workspace-Administrator kann festlegen, welche Apps Nutzer zu Google Chat hinzufügen können.
App-Tester: Beim Testen Ihrer App können Sie den Zugriff darauf einschränken.

In Google Chat können Nutzer eine direkte Unterhaltung mit Ihrer App oder App aus einem Gruppenbereich heraus aufrufen Folgendes geschieht:

Ein Nutzer sendet eine Nachricht an eine Chat-App.
Google Chat sendet eine JSON-Anfrage an die Chat-App, die in Cloud Functions.
Die Chat-App empfängt die JSON-Anfrage und parst sie. Während des Parsings Die Chat-App ruft Dialogflow auf.
Die Chat-App sendet eine Anfrage mit der ID des Nutzers an Dialogflow. Nachrichtentext in natürlicher Sprache.
Dialogflow interpretiert den Text des Nutzers und sendet eine Antwort an die Chat-App.
Die Chat-App parst die Antwort von Dialogflow und sendet eine JSON-Antwort an Google Chat
Google Chat empfängt die JSON-Antwort der Chat-App und rendert eine Antwort in in Form einer Textnachricht, einer Kartennachricht oder einer Dialognachricht auf der Benutzeroberfläche.
Google Chat gibt diese Antwort unverändert weiter oder bietet eine umfassende Antwort mit einem kartenbasierten UI-Element.

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

Beschränkungen

Bei Google Chat-Integrationen kann ein Dialogflow-Agent nur die Standard-Agent-Sprache.

Hinweise

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

Dialogflow-Agent erstellen

Wenn Sie noch keinen Dialogflow-Agent erstellt haben, aber gern 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 für den Agent eine Google Chat-Oberfläche ein.

Google Chat einrichten

Sie haben folgende Möglichkeiten, den 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:

Rufen Sie die Dialogflow ES-Konsole auf.
Wählen Sie im linken Menü ein Dialogflow-Projekt aus.
Klicken Sie auf Integrations (Integrationen).
Klicken Sie auf Google Chat. Wenn Google Chat nicht verfügbar ist, lesen Sie den Abschnitt Fehlerbehebung.
Wählen Sie aus, wer auf die App zugreifen darf.
[Optional] Wählen Sie eine Umgebung aus, in der der Agent ausgeführt werden soll.
Klicken Sie auf Start.

Ihre Google Chat App ist jetzt live 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 Seite der Google Cloud Console angezeigt. für die Google Chat API, wo Sie App-Parameter konfigurieren können wie der App-Avatar.

Google Chat mit der Google Cloud Console einrichten

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

Wählen Sie das Dialogflow-Projekt aus.

Zur Projektauswahl
Klicken Sie auf .
Klicken Sie auf APIs und Dienste und dann auf Bibliothek.
Suchen Sie nach der Google Chat API und klicken Sie darauf.
Klicken Sie auf Aktivieren.
Klicken Sie auf den Tab Konfiguration.
Konfigurieren Sie die App.
Wählen Sie im Bereich Sichtbarkeit aus, wer auf die Anwendung zugreifen kann:
- App-Tester. Wählen Sie Diesen Chat für bestimmte Personen verfügbar machen und E-Mail-Adressen eingeben.
- Eine allgemeine öffentliche oder Enterprise-Domain von Google Workspace. Veröffentlichen Sie die App.
Klicken Sie auf Speichern. Ihre Google Chat App ist jetzt live und für alle verfügbar, ausgewählt.

Test

Prüfen Sie vor dem Testen der Chat-App, ob Sie sie gestartet haben. Eine Beschreibung dazu finden Sie unter Richten Sie Google Chat ein.

Sie können Ihre App mit einer der folgenden Methoden testen:

Direkt mit der App chatten
App aus einem Gruppenbereich aufrufen

Direkt mit der App chatten

Öffnen Sie Google Chat.
Klicken Sie im Bereich Chat auf + und wählen Sie Apps suchen aus.
Suchen Sie nach Ihrer App und wählen Sie sie aus. Wenn Ihre App in Google Chat nicht aufgeführt ist, lesen Sie die Informationen unter Fehlerbehebung.
Klicken Sie auf Chat.
Geben Sie in das Chat-Eingabefeld einen Ausdruck in natürlicher Sprache ein, um die App zu testen.

App aus einem Gruppenbereich aufrufen

Öffnen Sie Google Chat.
Klicken Sie im Bereich Gruppenbereiche auf + und wählen Sie Gruppenbereich erstellen aus.
Geben Sie den Namen des Gruppenbereichs Test ein.
Klicken Sie auf Erstellen.
Geben Sie im Chateingabefeld @ ein und wählen Sie Ihre App aus, um den Namen automatisch zu vervollständigen.
Geben Sie nach dem automatisch vervollständigten App-Namen eine Wortgruppe in natürlicher Sprache ein, um die App zu testen.

Fehlerbehebung

Fehler	Lösung
Die Dialogflow ES-Konsole > Auf der Seite „Integrationen“ wird Google Chat nicht als Option angezeigt.	Aktualisieren Sie die Seite: Klicken Sie im linken Menü auf Intents und dann auf Integrations.
In Google Chat wird Ihre App nicht als verfügbar aufgeführt.	Prüfen Sie, ob Ihr Google Workspace-Administrator ein Google Workspace-Konto für Sie hinzugefügt hat und Nutzern erlaubt hat, Chat-Apps zu installieren. Starten Sie dann die Google 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 an Google Chat gesendet als SMS: Mit dieser Formatierung können Sie Text fett oder kursiv formatieren, indem Sie den Text in bestimmte Symbole (Markierungslicht-Symbole).

Die Textnachrichtenantwort sieht optisch 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 interessant für Sie sein könnte. wenn Sie Agents für mehrere Integrationen erstellen.

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

Infokarten

Kartenantworten an Google Chat gesendet als Kartennachrichten

Images

Bildantworten an Google Chat gesendet als Bild-Widgets für Google Chat.

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 Format „Cards v1“:

{
  "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

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

Rufen Sie die Dialogflow ES-Konsole auf.
Wählen Sie im linken Menü ein Dialogflow-Projekt aus.
Klicken Sie auf Integrations (Integrationen).
Klicken Sie auf Google Chat. Wenn Google Chat nicht verfügbar ist, lesen Sie den Abschnitt Fehlerbehebung.
Klicken Sie auf Beenden.

Chat-App über die Google Cloud Console beenden

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

Zur Projektauswahl
Klicken Sie auf .
Klicken Sie auf APIs und Dienste und dann auf Bibliothek.
Suchen Sie nach der Google Chat API und klicken Sie darauf.
Klicken Sie auf Verwalten.
Klicken Sie auf den Tab Konfiguration.
Wählen Sie im Feld App-Status die Option DEAKTIVIERT aus.

Weitere Informationen

Weitere Informationen zur Verwendung von Google Chat finden Sie hier: