Google Chat

借助 Dialogflow CX 的 Google Chat 集成，您可以创建基于 Dialogflow CX 技术的具有自然语言理解功能的 Google Chat 应用。

限制

此集成仅支持代理的默认语言的文本输入。

设置 Google Chat

如需为代理设置 Google Chat 集成，您需要满足以下条件：

可访问 Google Chat 的 Google Workspace 账号。
Google Cloud 项目。

启用 Google Chat API

在使用 Google API 之前，您需要在 Google Cloud项目中启用这些 API。您可以在单个 Google Cloud项目中启用一个或多个 API。

在 https://console.cloud.google.com/中，启用 Google Chat API 和 Dialogflow API。
检查您是否在正确的云项目中启用了这些 API，然后点击下一步。
检查您是否正在启用正确的 API，然后点击启用。

通过 Dialogflow CX 进行设置

前往 Dialogflow CX 控制台。
选择您的 Google Cloud 项目。
选择您的代理。
前往导航菜单中的管理标签页。
选择集成。
点击 Google Chat 上的关联。
填写以下必填信息：
- 名称：对于与此应用创建的内容互动或使用相应内容（例如，在消息、搜索中以及用“@”提及时）的用户，该应用的显示名称。例如 Dialogflow CX App。
- 头像网址：向与应用互动的用户显示的头像图片。指定一个托管一张方形（宽高比为 1:1）PNG 图片的 HTTPS 网址。建议的最小尺寸：256 x 256 像素。例如 https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png。
- 说明：应用的说明。例如 A helpful bot that responds to real human conversation。
- 环境：要连接到的环境。选择适用的环境。
输入电子邮件地址，以便向特定人员和群组（如适用）提供此 Chat 应用。
点击开始。

测试

如需测试已配置的应用，请在 Google Chat 聊天室中提及该应用或发送私信。

例如：

打开 Google Chat。
点击发起新聊天。
在添加 1 位或多位用户字段中，输入 Chat 应用的名称。
从结果中选择您的 Chat 应用。系统会打开私信。

富响应消息

您可以在执行方式中使用自定义载荷来支持富响应消息。如需了解消息格式，请参阅 Google Chat 消息 API。

短信

以下自定义载荷提供 Google Chat 短信：

{
  "text": "Hello, world"
}

如果您使用的是 Chat 插件，则以下自定义载荷会提供 Google Chat 短信：

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

卡片消息

以下自定义载荷提供 Google Chat 卡片消息：

{
  "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"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

如果您使用的是 Chat 插件，则以下自定义载荷会提供 Google Chat 卡片消息：

{
  "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"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

渠道专属回复

配置后，当代理回复 Google Chat 聊天消息时，系统会自动使用渠道为 DF_CX_GOOGLE_CHAT 的渠道专用回复。