Google Chat

Mit der Google Chat-Integration für Dialogflow CX können Sie Google Chat-Apps mit Natural Language Understanding auf Basis der Dialogflow CX-Technologie erstellen.

Beschränkungen

Google Chat einrichten

Für die Einrichtung der Google Chat-Integration für Ihren Agenten benötigen Sie Folgendes:

Google Chat API aktivieren

Bevor Sie Google APIs verwenden können, müssen Sie sie in einem Google Cloud-Projekt aktivieren. Sie können eine oder mehrere APIs in einem einzelnen Google Cloud-Projekt aktivieren.

  1. Aktivieren Sie in der https://console.cloud.google.com/die Google Chat API und die Dialogflow API.
  2. Prüfen Sie, ob Sie die APIs im richtigen Cloud-Projekt aktivieren, und klicken Sie dann auf Weiter.
  3. Prüfen Sie, ob Sie die richtigen APIs aktivieren, und klicken Sie dann auf Aktivieren.

In Dialogflow CX einrichten

  1. Rufen Sie die Dialogflow CX-Konsole auf.
  2. Wählen Sie Ihr Google Cloud Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Rufen Sie im Navigationsmenü den Tab Verwalten auf.
  5. Wählen Sie Integrationen aus.
  6. Klicken Sie bei Google Chat auf Verbinden.
  7. Geben Sie die folgenden erforderlichen Informationen ein:
    • Name: Der Name, der Nutzern angezeigt wird, die mit den von dieser Anwendung erstellten Inhalten interagieren oder diese nutzen, z. B. in Nachrichten, in der Suche und in @Erwähnungen. Beispiel: Dialogflow CX App.
    • Avatar-URL: Das Avatarbild, das Nutzern angezeigt wird, die mit der App interagieren. Geben Sie eine HTTPS-URL an, die ein quadratisches PNG-Bild (Seitenverhältnis 1:1) hostet. Empfohlene Mindestgröße: 256 x 256 Pixel. Beispiel: https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
    • Beschreibung: Eine Beschreibung der App, z. B. A helpful bot that responds to real human conversation.
    • Umgebung: Die Umgebung, zu der eine Verbindung hergestellt werden soll. Wählen Sie gegebenenfalls eine Umgebung aus.
  8. Geben Sie E-Mail-Adressen ein, um diese Chat-App für bestimmte Personen und Gruppen verfügbar zu machen.
  9. Klicken Sie auf Start.

Test

Wenn Sie die konfigurierte App testen möchten, erwähnen Sie sie in einem Google Chat-Bereich oder senden Sie eine Direktnachricht.

Beispiel:

  1. Öffnen Sie Google Chat.
  2. Klicken Sie auf Neuer Chat.
  3. Geben Sie im Feld Eine oder mehrere Personen hinzufügen den Namen Ihrer Chat-App ein.
  4. Wählen Sie Ihre Chat-App aus den Ergebnissen aus. Eine Direktnachricht wird geöffnet.

Rich-Media-Antworten

Sie können Rich-Response-Nachrichten mit Benutzerdefinierte Nutzlast im Fulfillment unterstützen. Informationen zum Nachrichtenformat finden Sie in der Google Chat Message API.

SMS

Die folgende benutzerdefinierte Nutzlast stellt eine Textnachricht für Google Chat bereit:

{
  "text": "Hello, world"
}

Wenn Sie ein Chat-Add-on verwenden, stellt die folgende benutzerdefinierte Nutzlast eine Textnachricht für Google Chat bereit:

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "text": "Your pizza delivery is here!"
        }
      }
    }
  }
}

Kartennachricht

Die folgende benutzerdefinierte Nutzlast stellt eine Kartennachricht für Google Chat bereit:

{
  "cardsV2": [{
    "cardId": "createCardMessage",
    "card": {
      "header": {
        "title": "A card message!",
        "subtitle": "Sent from Dialogflow CX",
        "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
        "imageType": "CIRCLE"
      },
      "sections": [
        {
          "widgets": [
            {
              "buttonList": {
                "buttons": [
                  {
                    "text": "Read the docs!",
                    "onClick": {
                      "openLink": {
                        "url": "https://developers.google.com/workspace/chat"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

Die folgende benutzerdefinierte Nutzlast stellt eine Kartennachricht für Google Chat bereit, wenn Sie ein Chat-Add-on verwenden:

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "cardsV2": [
            {
              "cardId": "basic1",
              "card": {
                "header": {
                  "title": "This is a card!",
                  "subtitle": "Sent from Conversational Agents (Dialogflow CX)",
                  "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
                  "imageType": "CIRCLE"
                },
                "sections": [
                  {
                    "widgets": [
                      {
                        "buttonList": {
                          "buttons": [
                            {
                              "text": "Open Google!",
                              "color": {
                                "red": 0.101960786,
                                "green": 0.4509804,
                                "blue": 0.9098039
                              },
                              "onClick": {
                                "openLink": {
                                  "url": "http://google.com"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

Kanalspezifische Antworten

Wenn konfiguriert, werden kanalspezifische Antworten mit dem Kanal DF_CX_GOOGLE_CHAT automatisch verwendet, wenn der Agent auf Google Chat-Nachrichten antwortet.