创建代理来管理品牌

选择是使用 Business Communications 开发者控制台还是 API 管理代理。

开发者控制台 API

注册成为合作伙伴后，您可以为自己管理的品牌创建 Business Messages 代理，从而为这些品牌启用对话功能。

代理：对话式的品牌代表，由合作伙伴管理。包括用户互动时接触到的所有界面以及为互动提供支持所需的所有代码或基础架构。

代理是一个会与用户互动的对话实体。您可以为所管理的每个品牌创建一个代理。您可以使用 Business Communications API 创建和管理代理，并可使用 Business Messages API 控制代理的消息功能。

代理涵盖品牌的业务职能（例如在线支持）和实体营业地点（如有）。每条消息都包含用户从中发起对话的上下文。您的消息传输基础架构可以检测用户是否查看了特定营业地点或寻求一般支持，并且可以将消息传输到正确的目的地。

例如，如果您管理 Growing Tree Bank 品牌（它有一个网站和两个营业地点），则可以创建一个“Growing Tree Bank”代理。用户可以通过常规搜索或基于地点的搜索发现该代理，用户找到该代理的情况信息会与每条消息一起传递到您的 webhook。您可以根据这些情况信息将消息传输给某个营业地点的员工或网站支持团队，后者会创建响应并继续与用户对话。

预期

在创建代理之前，请了解代理对 Business Messages 的预期。

• 代理应遵循 Business Messages 的对话设计中所述的设计指南。

• 在自动化程序无法完成请求或用户请求对话人工代表时，代理应安排人工代表解答问题。

  注意 ：如果您的代理不支持人工代表，则无法从基于位置的入口点或非本地入口点发布代理。为您的代理指定人工互动类型，以便代理显示在由 Google 管理的入口点上。

• 代理应保持客户满意度评分 (CSAT) 至少为 80%，且商家回复率 (MRR) 至少为 95%，如指标中所述。

创建代理

创建代理时，您可以启用 Business Messages 小助手机器人来帮助您探索平台。借助小助手机器人，您可以快速发起与代理的对话，以便试用可用功能并查找可帮助您实现这些功能的资源。这在您创建首个代理时特别有用。

若要创建代理，您需要收集并提交品牌的相关信息，以及您希望以何种方式将代理显示给用户。

注意：您需要有 Business Messages Google 账号才能创建代理。如需注册账号，请参阅在 Business Messages 中注册并查看对代理运营的预期。

如果您管理多个品牌，请重复上述步骤，为每个品牌创建一个代理。

前提条件

在为您管理的品牌创建代理之前，您需要收集一些信息：

• 品牌名称
• 代理名称

创建代理

收集完信息后，您就可以创建代理了。

注意：如需为代理启用 Business Messages 小助手机器人，您首先需要停用任何现有的 webhook 或 Dialogflow 集成。

1. 打开 Business Communications 开发者控制台，然后使用您的 Business Messages Google 帐号登录。
2. 点击创建代理。
3. 对于代理类型，请选择 Business Messages。
4. 输入品牌名称和代理名称的值。
5. 执行以下任一项操作：
   • 如需体验与代理的对话并在对话中探索可用功能，请选择启用 Business Messages 小助手机器人。
   • 如需自定义您的代理并使其准备好处理消息，请取消选择启用 Business Messages 小助手机器人。
6. 点击创建代理。

如果您启用了 Business Messages 小助手机器人，则可以立即发起对话。否则，请继续设置 webhook。

设置代理级 webhook

您会在 webhook 中收到发送给代理的消息。如果您希望特定代理的消息到达其他 webhook，可以设置代理级 webhook。

注意：如果您启用了 Business Messages 小助手机器人，则需要先将其停用，然后才能在 webhook 中收到消息。

1. 打开 Business Communications 开发者控制台，然后使用您的 Business Messages Google 帐号登录。
2. 点击您的代理。
3. 点击集成。
4. 对于网络钩子，点击配置。
5. 在网络钩子端点网址部分，输入 webhook 的网址，以“https://”开头。
6. 记下您的 clientToken 值。您需要使用它来验证您收到的消息是否来自 Google。

7. 将 webhook 配置为接受具有指定 clientToken 参数的 POST 请求，并发送包含 secret 参数的值的 200 OK 响应。

   例如，如果您的 webhook 收到具有以下正文内容的 POST 请求

   {
     "clientToken":"SJENCPGJESMGUFPY",
     "secret":"0123456789"
   }
   

   webhook 应确认 clientToken 值，如果 clientToken 正确无误，则返回 200 OK 响应，并将 secret 网址参数设置为 0123456789。

8. 在控制台中，点击验证。

   Business Messages 验证您的 webhook 后，对话框将关闭。

测试代理

每个代理都有测试网址，可让您查看与该代理的对话对用户的显示效果，并让您有机会验证消息传递基础架构。

如需测试代理，请按以下步骤操作：

1. 打开 Business Communications 开发者控制台，然后使用您的 Business Messages Google 帐号登录。
2. 选择您的代理。

3. 在概览页面上的代理的测试网址下，选择如何访问测试网址：

   • 如需在移动设备上访问这些网址，请点击 Android 按钮或 iOS 按钮。然后，使用相应的设备扫描二维码，并点击发布。或者，点击复制 Android 网址或复制 iOS 网址，以便将代理的测试网址复制到设备的剪贴板。
   • 如需将这些网址发送到您的电子邮件地址，请点击发送。

4. 在您的移动设备上打开相应网址。（iOS 设备需要 Google 地图应用。）

注意 ：您还可以在 Business Communications 开发者控制台中与代理预览进行交互，以测试代理。

更新代理信息

创建代理后，您可以在“代理信息”页面上修改代理的信息：

• 品牌名称
• 代理名称

• 代理徽标（1024x1024 像素）

  在对话中，徽标显示为直径为 1024 像素的圆形。确保您的徽标显示为圆形时效果良好。

  测试徽标

  输入徽标的网址，以查看其对用户的显示效果。

  注意：托管图片的网络服务器必须允许将图片嵌入到其他网站中。

• 电话号码

• 隐私权政策网址

• 默认语言区域

• 欢迎辞

• 离线消息

• 对话开场白

• 通过主要和辅助互动方式实现消息功能可用性

“概览”和“代理信息”页面可让您预览代理在对话中的显示效果。

验证代理后，您只能更新以下字段：

• 电话号码
• 自定义代理 ID
• 默认语言区域
• 欢迎辞
• 离线信息
• 隐私权政策
• 对话开场白
• 主要互动方式

如果您在验证代理后需要更新其他字段，请与我们联系。（您必须先使用 Business Messages Google 账号登录。如需注册账号，请参阅在 Business Messages 中注册。）

删除代理

在您删除代理后，Business Messages 会删除所有代理数据。Business Messages 不会删除代理所发送的消息，这些消息将传输至用户设备或存储在用户设备上。发送给用户的消息不是代理数据。

如果代理具有关联的营业地点，或者您已尝试对代理进行一次或多次验证，删除请求将失败。如需更新营业地点，请参阅添加营业地点。

您无法删除已通过验证的代理。如需删除您已验证或尝试验证的代理，请与我们联系。（您必须先使用 Business Messages Google 账号登录。如需注册账号，请参阅在 Business Messages 中注册。）

警告：删除某个代理后，该代理的所有相关信息都会从 Business Messages 中永久移除。

如需删除代理，请按以下步骤操作：

1. 打开 Business Communications 开发者控制台，然后使用您的 Business Messages Google 帐号登录。
2. 选择您的代理。
3. 在“概览”页面的底部，点击删除代理。
4. 输入“DELETE”，然后点击删除代理。

删除代理并不会删除关联的品牌数据。您可以使用 Business Communications API 删除品牌。

后续步骤

现在您有了代理，可以执行以下步骤：

• 向代理中添加营业地点
• 设计对话体验
• 制定消息传递流程