构建首个代理

代理 一种程序化实体，代表品牌向用户发送消息。代理包括用户互动时接触到的所有界面以及为互动提供支持所需的所有代码或基础架构。代理可以提供简单的单向体验（例如发送通知），也可以进行对话，并在用户反复交流时做出回应。

用户在其设备上通过支持 RCS 的消息应用（例如 Google 信息）与客服人员互动。在此快速入门中，您将创建一个基本 RBM 代理，该代理可以向测试设备发送简单消息并接收响应。

前提条件

在开始使用聊天机器人之前，您需要准备以下内容：

• 您的代理将代表的品牌的名称
• 代理的
  • 名称
  • 代理将在哪个区域运行
  • 结算类别
  • 用例
• 一部装有有效电话号码的 Android 设备
• 一台可以运行示例代码的开发机器

设置测试设备

如需与未启动的 RBM 代理通信，测试设备需要支持 RCS，但默认情况下，并非所有 Android 设备都能接收 RCS 消息。您可以使用预发布版本的“信息”和“运营商服务”应用配置设备，以查看设备的 RCS 状态，并在必要时启用 RCS。

查看设备的 RCS 状态

1. 在“信息”应用中，点按 按钮，然后点按设置。

2. 点按聊天功能，然后找到状态值。

   如果状态为已连接，则表示您的设备上已启用 RCS。

后续步骤

如果您的设备上启用了 RCS，您就可以设置客服人员了。 如果您的设备上 RCS 处于非活动状态，您需要先在设备上启用 RCS，然后才能测试 RBM 代理。

设置代理

RBM 代理使用 RBM API 向用户发送消息、事件和其他请求。创建代理时，您需要启用对 RBM API 的访问权限，并定义代理的基本信息。

确定客服人员所在的区域

RBM 客服人员可位于以下三个区域之一：北美洲、欧洲和亚太地区。RBM API 支持三个区域性端点，可帮助商家遵守地区性和业务要求。

创建代理时，请根据适用的法规、要求以及与最终用户的距离，为您的代理选择区域。此区域决定了代理在哪里运行以及在哪里存储数据。

如果您或您的目标用户不在这些区域内，请选择离您最近的区域，以最大限度地缩短延迟时间。例如：

• 如果您位于拉丁美洲，请选择北美地区。
• 如果您位于非洲，请选择“欧洲”地区。
• 如果您位于澳大利亚，请选择亚太地区。

请勿根据目标运营商来确定代理的区域。所有地区都可以平等地使用全球运营商。

注意 ：创建代理后，您将无法更改代理所在的区域。

确定代理的结算类别

创建 RBM 代理时，您需要根据代理与用户的互动方式指定其结算类别。选择与您的客服人员的预期行为最相符的类别：

• 对话式：适用于与用户进行多轮对话的客服。
• 基本消息或单个消息：适用于不希望频繁回复消息的客服人员。

注意 ：两种非对话式结算类别（基本消息和单条消息）的运作方式完全相同。这是一个历史遗留问题，我们正在努力简化。目前，您可以随意为非对话式消息（无论是纯文本还是富媒体卡片）使用任一类别。系统会按标准非对话式费率向您收费。如需了解详情，请参阅代理结算类别。

您只能在发布代理之前更改代理的账单类别。如果您需要在发布后更改结算类别，请发送电子邮件至 [e-mail]。

如需详细了解 RBM 结算模型，请参阅 RBM 结算常见问题解答。

确定代理的用例

每个 RBM 代理都必须有一个预定义的用例。这有助于对代理进行分类并应用正确的业务规则，从而提供良好的用户体验。RBM 支持以下四种用例：

• OTP：安全验证账号或确认交易所需的动态密码。
• 事务性：分享与客户现有服务或产品直接相关的信息的通知、更新或提醒，例如提醒客户账号活动存在异常、购买确认和送货通知。
• 促销：面向新客户或现有客户的销售、营销和促销信息，旨在提高认知度、互动度和销售额。
• 多用途：将事务性消息和促销消息结合使用的对话，例如发送账号通知后跟随折扣优惠或升级到新产品或服务。

对于可发送的内容，每种用例都有不同的规则。如需详细了解每种用例并找到最适合您的代理的用例，请参阅为您的代理选择合适的用例。

代理提交发布后，您将无法更改用例。在提交代理之前，请查看您所在国家/地区的使用情形和业务规则。

创建代理

请按照以下说明在商务沟通开发者控制台中创建客服人员。

注意： 如需使用 RBM Management API 创建代理，请参阅管理代理文档。

如需创建代理，请执行以下操作：

1. 前往 Business Communications 开发者控制台，然后使用您的 RBM 合作伙伴 Google 账号登录。
2. 在首页上，点击 + 创建代理。
3. 在 New RCS Business Messaging agent（新建 RCS Business Messaging 客服）窗口中，指定以下信息：
   • 代理所代表的品牌
   • 代理名称
   • 托管区域
   • 结算类别
   • 用例
4. 点击创建代理。

代理可用后，您就可以添加商家和品牌信息了。请参阅创建代理。

邀请测试设备

现在，您已经有了代理，并且测试设备支持 RCS，接下来您可以邀请设备来测试代理。

1. 在左侧导航栏中，点击设备。
2. 对于添加测试设备，请输入设备的电话号码，然后点击添加。
3. 在测试设备上，接受针对您的代理的测试人员请求。

如果您在测试设备上未收到邀请，请确认您的设备是否已启用 RCS。

发送消息

有了注册的测试设备，您的代理现在可以发送消息了。

您需要使用服务账号密钥来安全地对 API 调用进行身份验证。如果您尚未为合作伙伴账号创建服务账号密钥，请立即创建。

在开发机器上的终端中，运行以下命令：

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  }
}'

• 将 REGION 替换为 asia、europe 或 us，具体取决于代理的区域。
• 将 PHONE_NUMBER 替换为测试设备的电话号码。应包含国家/地区代码、区号和前置的 +，但不包含分隔符。例如 [phone]。
• 将 AGENT ID 替换为您的客服人员 ID，该 ID 位于 Business Communications 开发者控制台的客服人员信息页面上。
• 将 PATH_TO_SERVICE_ACCOUNT_KEY 替换为您之前创建的密钥的路径。

您应该会在测试设备上收到代理发送的“Hello, world!”消息。如果您在测试设备上没有收到消息，请检查您在命令中输入的电话号码和服务账号密钥路径是否正确，以及格式是否正确。

如需发送不同类型的消息（例如建议的回复和富媒体卡片），请参阅发送消息。

后续步骤

现在，您的代理可以向测试设备发送消息了，接下来就需要构建符合您业务需求的功能。获取以您偏好的语言提供的示例代理，然后按照示例自述文件中的说明操作。

配置示例代理后，请查看 RBM 的最佳实践，了解代理如何发送和接收消息。