Business Communications 开发者控制台

Business Messages 提供了一个网页界面,称为 Business Communications 开发者控制台。您可以使用此控制台来创建、管理和发布代理。

Business Communications 开发者控制台不同于 Google Cloud Platform。 (GCP) 控制台。您可以使用 Business Communications 开发者控制台来管理 Business Messages 代理,而使用 GCP 控制台来管理 GCP 专属设置(例如,结算和 API)及其他 GCP 资源。

虽然您可以使用 Business Communications 开发者控制台来创建和管理代理,但您也可以使用 Business Communications API 针对高级场景(例如集成到您自己的产品)创建和管理代理。

快速入门指南和方法指南将逐步介绍使用控制台和 API 的步骤。本页面简要介绍了界面布局以及控制台的用途。

如何使用该控制台

该控制台用于创建、管理、更新、验证和发布代理。借助此功能,您可以

控制台主屏幕

最初加载控制台时,您将看到代理选择屏幕。在本页面中,合作伙伴帐号设置链接会打开您的合作伙伴帐号设置页面。

此外,主屏幕还可用于:

  • 选择现有代理。
  • 创建新代理。
  • 对代理进行排序。
  • 按合作伙伴帐号过滤代理。

默认情况下,代理显示在卡片视图中。代理按上次更新时间排序。如需切换到列表视图,请使用右侧的 View as 选项。在列表视图中,代理可以按名称、类型、状态和上次更新日期进行排序。

如果您有多个合作伙伴帐号,则可以使用合作伙伴帐号下拉菜单选择器,按合作伙伴帐号过滤代理选择。

帐号设置

在“设置”页面中,您可以更新:

  • 商家名称
  • 显示名称
  • 技术联系人
  • Webhook

在侧边导航面板中,您可以访问品牌用户管理,以及您的服务帐号

品牌管理

品牌是商家、组织或团体。代理是品牌的对话代表。

您可以使用此页面来添加、修改和移除品牌。移除品牌的同时会删除所有关联的代理。如果品牌与已发布的代理相关联,则无法移除。

用户管理

使用此页面可为已注册的合作伙伴帐号添加和移除访问权限。如需切换帐号,请使用顶部导航栏中的下拉菜单。

添加用户

如需添加用户,请在电子邮件地址输入字段中输入其电子邮件地址,然后选择角色。

新用户可以拥有管理员读取者角色。管理者角色拥有控制台中所有功能的访问权限,读取者角色则拥有代理和营业地点信息的只读权限。

您添加新用户后,用户会收到一封电子邮件,通知他们现在有权访问合作伙伴帐号。

最初注册合作伙伴帐号的电子邮件地址具有 Owner 角色。

移除用户

如需移除用户,请执行以下操作:

  1. 在列表中找到要移除的用户。
  2. 点击 按钮。
  3. 选择移除用户
  4. 确认移除。

移除的用户会收到电子邮件通知,告知他们无法再访问帐号。

您无法移除拥有 Owner 角色的用户。如需更改或移除所有者,您需要与支持团队联系。

更改用户角色

如需更新用户的角色,请执行以下操作:

  1. 找到要更新的用户。
  2. 点击 按钮。
  3. 选择修改角色
  4. 从下拉菜单中选择新角色。
  5. 点击保存

服务帐号

当您调用 Business Communications 和 Business Messages API 时,可以使用服务帐号密钥对调用进行身份验证。借助服务帐号密钥,您可以创建和管理品牌、代理和营业地点,以及以代理的身份发送消息和请求。

如需生成服务帐号密钥,请从侧边导航栏中选择服务帐号。系统会打开与当前所选合作伙伴帐号相关联的 GCP 项目的 GCP 控制台。

如需创建服务帐号和密钥,请执行以下操作:

  1. 点击创建服务帐号
  2. 对于服务帐号名称,输入您的代理名称,然后点击创建
  3. 点击完成
  4. 在表中找到新的服务帐号,然后点击 > 创建密钥
  5. 选择 JSON,然后点击创建

浏览器会下载服务帐号密钥。

代理选择

选择代理后,系统会将您转到所选代理的“概览”页面。

概览会显示:

  • 品牌名称
  • 代理名称
  • 代理是在哪个合作伙伴帐号中创建的
  • 品牌 ID
  • 代理 ID
  • 代理测试网址,可让您查看与该代理的对话会以何种方式显示给用户,并让您有机会验证消息功能基础架构
  • 代理验证状态
  • 代理预览
  • 与代理关联的营业地点
  • 相关文档的链接

通过左侧导航栏,您可以访问以下内容:

代理信息

您可以前往“代理信息”页面,更新代理的属性。

该网页分为两列。使用左侧列中的输入字段更新代理字段,例如代理名称、徽标、欢迎辞、对话开场白以及营业地点和非本地入口点的属性。发布代理后,您无法更新某些字段,例如代理名称徽标

使用右列获取代理的测试网址,并预览代理在用户设备上的显示效果。

营业地点管理

验证代理后,您可以使用此页面添加营业地点、检索营业地点的测试网址,以及验证营业地点。

集成

使用本页面与 Dialogflow 集成并设置一个聊天机器人来回答常见问题解答。

调查

可以使用此页面自定义代理的客户调查问卷。

日志

请使用此页面调试消息传送问题。日志有效期为 14 天。 按对话 ID、消息 ID、时间戳、方向或状态进行过滤,以查找与用户问题相关的日志。您也可以检查此页面,以确认您没有无意中发送无效消息。

日志包含消息载荷,但隐去的敏感字段(例如消息文本内容)除外。失败和遭拒的消息还可以提供额外的错误详情,以便进行调试。

某些事件(例如输入状态指示器)没有递送收据,并且其状态会显示为“已发”。

显示“已投放”和“失败”状态的调试日志

验证

请使用此页面提交您的代理以进行验证

发布

使用此页面可针对营业地点和非本地入口点发布代理以及发布各个营业地点