Business Messages 提供一个名为 Business Communications Developer Console 的网页界面。 您可以使用此控制台创建、管理和启动代理。
Business Communications Developer Console 不同于 Google Cloud Platform。 (GCP) Console。您可以使用 Business Communications Developer Console 管理 Business Messages 代理,并使用 GCP Console 管理 GCP 专属设置(例如结算和 API)和其他 GCP 资源。
虽然您可以使用 Business Communications Developer Console 创建和管理代理,但也可以使用 Business Communications API 创建和管理高级场景(例如与您自己的产品的集成)中的代理。
快速入门和方法指南逐步介绍了使用控制台和 API 的步骤。本页将简要介绍界面布局以及控制台的用途。
如何使用该控制台
控制台用于创建、管理、更新、验证和启动代理。借助它,您可以:
- 配置网络钩子和其他合作伙伴帐号设置。
- 创建和管理代理,其中包含定义品牌对话表示法的所有属性和数据。
- 配置非本地代理设置和消息可用性。
- 创建和管理代表商家实际营业地点的营业地点。
- 检索您的代理和位置测试网址,了解与您的代理的对话向用户展示的方式。
- 集成 Dialogflow 以回答常见问题。
- 验证您的代理和位置。
- 启动代理和位置。
控制台主屏幕
首次加载控制台时,您会看到代理选择屏幕。在此页面中,点击合作伙伴帐号设置链接可打开您的合作伙伴帐号设置页面。
此外,主屏幕还可用于:
- 选择现有代理。
- 创建新代理。
- 对代理进行排序。
- 按合作伙伴帐号过滤代理。
默认情况下,代理显示在卡片视图中。代理是按最后更新时间排序的。如需切换到列表视图,请使用右侧的 View as 选项。通过列表视图,代理可以按名称、类型、状态和上次更新日期进行排序。
如果您有多个合作伙伴帐号,则可以使用合作伙伴帐号下拉菜单选择器,按合作伙伴帐号过滤代理选择。
帐号设置
在“设置”页面中,您可以更新以下内容:
- 企业名称
- 显示名称
- 技术联系人
- 网络钩子
在侧边导航面板中,您可以访问品牌和用户管理,以及您的服务帐号。
品牌管理
品牌是商家、组织或群组。代理是品牌的对话表示形式。
使用此页面添加、修改和移除品牌。移除品牌也会删除所有关联的代理。如果某个品牌已与已发布的代理相关联,则无法移除。
用户管理
您可以通过此页面添加和移除对注册合作伙伴帐号的访问权限。如需切换帐号,请使用顶部导航栏中的下拉菜单。
添加用户
如需添加用户,请在电子邮件地址输入字段中输入其电子邮件地址,然后选择角色。
新用户可以拥有管理员或读取者角色。管理员角色可以使用控制台中的所有功能,而读取者角色提供代理和位置信息的只读权限。
您添加新用户后,用户会收到一封电子邮件,通知他们现在可以访问合作伙伴帐号。
最初注册合作伙伴帐号的电子邮件地址具有所有者角色。
移除用户
如需移出用户,请执行以下操作:
- 在列表中找到要移除的用户。
- 点击 按钮。
- 选择移除用户。
- 确认移除。
您移除的用户将收到电子邮件通知,告知他们将无法再访问该帐号。
您无法移除拥有 Owner 角色的用户。如需更改或移除所有者,您需要联系支持团队。
更改用户角色
要更新用户的角色,请执行以下操作:
- 找到您要更新的用户。
- 点击 按钮。
- 选择修改角色。
- 从下拉菜单中选择新角色。
- 点击保存。
服务帐号
调用 Business Communications API 和 Business Messages API 时,您需要使用服务帐号密钥对调用进行身份验证。借助服务帐号密钥,您可以创建和管理品牌、代理和位置,以及以代理的身份发送消息和请求。
如需生成服务帐号密钥,请从侧边导航栏中选择服务帐号。系统会打开与当前所选合作伙伴帐号关联的 GCP 项目的 GCP Console。
如需创建服务帐号和密钥,请执行以下操作:
- 点击创建服务帐号。
- 在服务帐号名称中,输入您的代理名称,然后点击创建。
- 点击完成。
- 在表中找到新的服务帐号,然后点击 > 创建密钥。
- 选择 JSON,然后点击创建。
您的浏览器会下载服务帐号密钥。
代理选择
选择代理后,您将进入所选代理的“概览”页面。
概览会显示:
- 品牌名称
- 代理名称
- 创建代理时使用的合作伙伴帐号
- 品牌 ID
- 代理 ID
- 代理测试网址,可让您查看与相应代理的对话向用户显示的方式,并让您有机会验证消息传递基础架构
- 代理验证状态
- 代理预览
- 与代理关联的位置
- 相关文档的链接
通过左侧导航栏,您可以访问以下内容:
代理信息
使用代理信息页更新代理的属性。
该页面分为两列。使用左列中的输入字段更新代理字段,例如代理名称、徽标、欢迎辞、对话启动器以及位置和非本地入口点的属性。启动代理后,您无法更新某些字段,例如代理名称和徽标。
使用右列获取代理的测试网址,并预览代理在用户设备上的显示效果。
营业地点管理
在验证您的代理后,您可以使用此页面添加营业地点、检索营业地点的测试网址,以及验证营业地点。
集成
使用本页面与 Dialogflow 集成并设置聊天机器人来回答常见问题解答。
调查
使用此页面自定义代理的客户调查问卷。
日志
请使用此页面调试消息传送问题。日志会保留 14 天。 按对话 ID、消息 ID、时间戳、方向或状态进行过滤,以查找与用户问题相关的日志。您还可以查看此页面,以确认您不会无意间发送无效消息。
日志包含消息载荷,但隐去的敏感字段(例如消息文本内容)除外。失败和遭拒的消息包含额外的错误详情,可帮助进行调试。
某些事件(如输入指示器)没有递送回执,并且其状态显示为“已发送”。
验证
使用此页面提交代理以进行验证。
发布
使用此页面启动代理(以获取位置和非本地入口点)以及启动各个位置。
广告
如果您支持广告主使用消息素材资源投放 Google 搜索广告,请使用此页面获取 Google Ads 链接。链接列表包含代理的每个问候语的链接。
若要将问候语与广告配对,广告客户需要提供首选问候语的链接。使用“链接”列表将单个链接发送给广告客户,或下载 CSV 文件(其中会包含广告素材资源所需的所有链接)。