Hangouts Chat

Hinweis: Diese Integration steht nur Nutzern der G Suite zur Verfügung. Außerdem muss Ihr G Suite-Administrator zulassen, dass Nutzer Bots installieren.

Mit der Integration von Dialogflow in Hangouts können Sie Bots erstellen, die Sie in Einzelchats sowie in Chatrooms einbinden können. Weitere Informationen finden Sie in den Hangouts Chat API-Dokumenten.

Einrichtung

Gehen Sie so vor, um die Hangouts Chat-Integration einzurichten und zu aktivieren:

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.

Hinweis: Wenn Sie Ihren Bot beenden möchten, kehren Sie zur Seite für die Integration von Hangouts Chat zurück und klicken Sie in der rechten unteren Ecke auf Stop.

Bot konfigurieren

Sobald Sie Ihren Hangouts 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 Hangouts Chat API der Google Cloud Platform Console wird geöffnet.

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

Hangouts mit der Google Cloud Platform Console aktivieren und konfigurieren

Die Integration von Hangouts kann auch über die Google Cloud Platform Console durchgeführt werden. Dabei gehen Sie so vor:

1. Klicken Sie in der Google Cloud Platform 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 nach "Hangouts-Chat".
5. Klicken Sie auf die Hangouts Chat API-Kachel.
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 Hangouts 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. Klicken Sie auf Hangouts 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 G Suite-Administrator, Nutzern die Installation von Bots zu erlauben.

Rich-Media-Antworten

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

Textantworten

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

Bilder

Bildantworten werden als Hangouts-Bilder-Widgets an Hangouts gesendet.

Infokarten

Kartenantworten werden als Hangouts-Karten an Hangouts gesendet.

Benutzerdefinierte Nutzlast

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

Mit der benutzerdefinierten Hangouts-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 Hangouts finden Sie eine Liste mit möglichen Kombinationen. Wenn Sie jedoch benutzerdefinierte Nutzlasten verwenden, müssen Sie das JSON-Format bereitstellen.

Hinweis: Beachten Sie Folgendes, wenn Sie die Beispiele des Referenzleitfadens in das benutzerdefinierte Nutzlastfeld in Dialogflow kopieren und einfügen: Der erste Schlüssel kann nicht als "cards" bezeichnet werden, sondern muss den hangouts haben. Der Hangouts-Schlüssel verweist auf ein Objekt, nicht auf ein Array (von Karten). Vergewissern Sie sich, dass der Editor keine Lint-Fehler enthält. Außerdem können Sie die Ergebnisse nicht im Dialogflow-Simulator testen. Sie müssen direkt in Hangouts Chats testen.

Beispiel:

{
  "hangouts": {
    "header": {
      "title": "Pizza Bot 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/..."
              }
            }
          }
        }]
      }]
    }]
  }
}