Google Chat

Mit der Google Chat-Integration von Dialogflow CX können Sie Google Chat-Apps mit Natural Language Understanding basierend auf der Dialogflow CX-Technologie erstellen.

Beschränkungen

Google Chat einrichten

Für die Einrichtung der Google Chat-Integration für Ihren Agent 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 einzigen Google Cloud Projekt aktivieren.

  1. Aktivieren Sie in der https://console.cloud.google.com/die Google Chat API und die Dialogflow API.

  2. Bestätigen Sie, dass Sie die APIs im richtigen Cloud-Projekt aktivieren, und klicken Sie auf Weiter.

  3. Bestätigen Sie, dass Sie die richtigen APIs aktivieren, und klicken Sie auf Aktivieren.

Über Dialogflow CX einrichten

  1. Rufen Sie die Dialogflow CX Console auf.
  2. Wählen Sie Ihr Google Cloud Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Verwalten.
  5. Klicken Sie im linken Seitenleistenmenü auf Integrations.
  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 App 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. Beispiel: A helpful bot that responds to real human conversation.
  8. Wählen Sie gegebenenfalls eine Umgebung aus.
  9. Geben Sie gegebenenfalls E-Mail-Adressen ein, um diese Chat-App bestimmten Personen und Gruppen zur Verfügung zu stellen.
  10. Klicken Sie auf Start.

Test

Wenn Sie Ihre konfigurierte App testen möchten, erwähnen Sie sie in einem Google Chat-Gruppenbereich oder senden Sie ihr eine Direktnachricht. Beispiel:

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

Rich-Media-Antworten

Rich-Media-Antworten werden über Benutzerdefinierte Nutzlast in der Auftragsausführung unterstützt. Das Nachrichtenformat finden Sie unter Google Chat Message API.

SMS

Die folgende benutzerdefinierte Nutzlast stellt eine Google Chat SMS bereit:

{
  "text": "Hello, world"
}

Die folgende benutzerdefinierte Nutzlast stellt eine Google Chat SMS bereit, wenn Sie ein Chat-Add-onverwenden:

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

Kartennachricht

Die folgende benutzerdefinierte Nutzlast stellt eine Google Chat Kartennachricht 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 Google Chat Kartennachricht bereit, wenn Sie ein Chat-Add-onverwenden:

{
  "host_app_data_action": {
    "chat_data_action": {
      "create_message_action": {
        "message": {
          "cardsV2": [
            {
              "card_id": "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.