利用 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。
确认您是在正确的 Cloud 项目中启用 API,然后点击下一步。
确认您启用的 API 正确无误,然后点击启用。
通过 Dialogflow CX 设置
- 转到 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击左侧边栏菜单中的集成。
- 在 Google Chat 中点击连接。
- 填写以下必填信息:
<ph type="x-smartling-placeholder">
- </ph>
- 名称:向与此应用创建的内容互动或使用该应用创建的内容(例如在消息、搜索和用“@”提及的内容中)互动的用户显示的名称。例如
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。
- 点击发起新对话。
- 在添加一人或多人字段中,输入 Chat 应用的名称。
- 从结果中选择您的 Chat 应用。系统会打开一条私信。
富响应消息
在以下版本中,自定义载荷支持富响应消息: Fulfillment。请参阅 Google Chat Message API 消息格式
短信
以下自定义载荷提供 Google Chat text message:
{ "text": "Hello, world" }
卡片消息
以下自定义载荷提供 Google Chat 卡片消息:
{ 'cardsV2': [{ 'cardId': 'createCardMessage', 'card': { 'header': { 'title': 'A card message!', 'subtitle': 'Sent from Dialogflow', '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
的针对特定渠道的响应。