Google Chat

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

Beschränkungen

Google Chat einrichten

Sie benötigen Folgendes, um die Google Chat-Integration für Ihren Agent einzurichten:

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. Bestätigen Sie, dass 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.

Einrichtung über „Konversations-Agents (Dialogflow CX)“

  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 an:
    • 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: Conversational Agents (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.
  8. Wählen Sie gegebenenfalls eine Umgebung aus.
  9. Geben Sie 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 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

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

SMS

Die folgende benutzerdefinierte Nutzlast stellt eine Google Chat-Textnachricht bereit:

{
  "text": "Hello, world"
}

Die folgende benutzerdefinierte Nutzlast stellt eine Google Chat-Textnachricht bereit, wenn Sie ein Chat-Add-on verwenden:

        {
            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 Conversational Agents (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 Kartenmitteilung für Google Chat bereit, wenn Sie ein Chat-Add-on verwenden:

{
  "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 Kundenservicemitarbeiter auf Google Chat-Nachrichten antwortet.