Google Chat-Einbindung in Dialogflow

Mit der Integration von Dialogflow in Google Chat können Sie Bots erstellen, die Sie in Einzelchats sowie in Chatrooms aufnehmen können. Weitere Informationen finden Sie in der Google Chat API-Dokumentation.

Einrichtung

So richten Sie die Google Chat-Integration ein:

  1. Klicken Sie im linken Menü auf Integrations (Integrationen).
  2. Klicken Sie auf Hangouts Chat.
  3. Wählen Sie eine Zugriffsoption aus.
  4. [Optional] Wählen Sie eine Agent-Umgebung aus.
  5. Klicken Sie auf Start.

Bot konfigurieren

Sobald Sie den Google Chat-Bot erstellt haben, können Sie die Details ändern. Klicken Sie dafür im Pop-up-Fenster für die Integration auf die Schaltfläche CONFIGURE BOT DETAILS (Bot-Details konfigurieren). Die Seite für die Google Chat API wird in der Google Cloud Console angezeigt.

Mithilfe der Anleitung im Leitfaden zum Veröffentlichen von Bots in der Google Chat API können Sie den Bot konfigurieren und veröffentlichen.

Bot-Avatar konfigurieren

Es gibt zwei Alternativen zum Konfigurieren des Bot-Avatars:

  • Klicken Sie in den Integrationseinstellungen auf die Schaltfläche BOT-DETAILS KONFIGURIEREN und geben Sie in das Feld Avatar-URL eine Avatar-URL ein.
  • Geben Sie in den allgemeinen Einstellungen des Agents im Feld Agent-Avatar-URI eine Avatar-URL ein.

Mit der Cloud Console aktivieren und konfigurieren

Die Integration von Google Chat kann auch über die Cloud Console aktiviert werden. Dabei gehen Sie so vor:

  1. Klicken Sie in der Cloud Console oben links auf das Menüsymbol .
  2. Klicken Sie auf APIs und Dienste und dann auf Dashboard.
  3. Klicken Sie auf APIS UND DIENSTE AKTIVIEREN.
  4. Suchen Sie die Google Chat API.
  5. Klicken Sie auf die Kachel für die Google Chat API.
  6. Klicken Sie auf Aktivieren.
  7. Klicken Sie im Menü der linken Seitenleiste auf Konfiguration.
  8. Mithilfe der Anleitung im Leitfaden zum Veröffentlichen von Bots in der Google Chat API können Sie den Bot konfigurieren und veröffentlichen.

Test

Bevor Sie den Bot testen, müssen Sie ihn gestartet haben. Weitere Informationen finden Sie im Abschnitt Einrichtung.

Mit den folgenden Schritten testen Sie Ihren Bot:

  1. Öffnen Sie Google Chat.
  2. Klicken Sie in das Suchfeld.
  3. Wählen Sie Bot suchen aus.
  4. Wählen Sie den Namen Ihres Bots aus.
  5. Klicken Sie auf Nachricht senden.

Fehlerbehebung

Fehler Lösung
Der Administrator hat die Kommunikation mit Bots in Direktnachrichten deaktiviert. Bitten Sie Ihren Google Workspace-Administrator, Nutzern die Installation von Bots zu erlauben.

Rich-Media-Antworten

Diese Integration übersetzt einige Rich-Media-Nachrichten in Google Chat-Nachrichtenformate.

Textantworten

Textantworten werden als SimpleText 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 SimpleText-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"
},

Images

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

Infokarten

Kartenantworten werden als Google Chat-Karten an Google Chat gesendet.

Benutzerdefinierte Nutzlast

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

Mit der benutzerdefinierten Nutzlast in Google Chat können Sie erweiterte Karten erstellen. Eine Karte kann einen oder mehrere Abschnitte enthalten. Jeder Abschnitt kann eine Kopfzeile haben. Eine Übersicht der möglichen Kombinationen finden Sie im Leitfaden zu Google Chat-Nachrichtenformaten. Wenn Sie jedoch benutzerdefinierte Nutzlasten verwenden, müssen Sie das JSON-Format bereitstellen.

Beispiel:

{
  "hangouts": {
    "header": {
      "title": "Pizza Bot Customer Support",
      "subtitle": "pizzabot@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/..."
              }
            }
          }
        }]
      }]
    }]
  }
}