Google Chat

借助 Conversational Agents (Dialogflow CX) 的 Google Chat 集成功能，您可以创建 Google Chat 基于对话代理 (Dialogflow CX) 技术的自然语言理解功能。

限制

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

设置 Google Chat

如需为代理设置 Google Chat 集成，您需要具备以下各项：

一个有权访问 Google Chat 的 Google Workspace 账号。
具有一个 Google Cloud 项目。

启用 Google Chat API

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

在 Google Cloud 控制台中，启用 Google Chat API 和 Dialogflow API。
确认您要启用 API 的 Cloud 项目正确无误，然后点击下一步。
确认您要启用的 API 正确无误，然后点击启用。

通过对话式客服 (Dialogflow CX) 进行设置

转到 Dialogflow CX 控制台。
选择您的 Google Cloud 项目。
选择您的代理。
选择管理标签页。
点击左侧边栏菜单中的集成。
在 Google Chat 中点击连接。
填写以下必填信息：
- 名称：当用户与此应用创建的内容互动或使用该应用创建的内容（例如在消息、搜索和用“@”提及的内容中）进行互动或消费时，系统向其显示的名称。例如 Conversational Agents (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 应用。系统随即会打开一条私信。

富响应消息

在以下版本中，自定义载荷支持富响应消息： Fulfillment。请参阅 Google Chat 消息 API 消息格式

短信

以下自定义载荷会提供 Google Chat 文本消息：

{
  "text": "Hello, world"
}

卡片消息

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

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

针对特定频道的响应

配置后，当代理回复 Google Chat 消息时，系统会自动使用频道为 DF_CX_GOOGLE_CHAT 的针对特定渠道的响应。