构建首个代理

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

消息在启用了 RBM 的对话中的流程

前提条件

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

设置测试设备

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

查看设备的 RCS 状态

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

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

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

后续步骤

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

设置代理

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

确定客服人员所在的区域

RBM API 支持三个区域性端点，可帮助商家遵守地区性和业务要求。RBM 代理可以位于以下三个区域之一：

  • 北美洲
  • 欧洲
  • 亚太地区

创建代理时，请根据适用的法规、要求以及与最终用户的距离，为其选择区域。请注意，地区不局限于国家/地区。它用于标识您的代理在哪个区域运营。Google 会使用这些信息来确定消息数据的存储位置以及如何适当地路由消息流量。

确定代理的结算类别

在其网络上批准 RBM 内容的运营商还会使用以下结算框架向其订阅者收取 RBM 消息传送费用：

  • 对话 - 对话费用是指在给定时间段内包含多条 A2P 和 P2A 消息的对话。
  • 单条消息 - 包含丰富 RBM 内容（例如包含复合信息卡或轮播界面的消息）的单条消息的费用。
  • 基本消息 - 纯文本消息（最多 160 个字符），需要付费。

创建代理时，请选择与代理逻辑行为最相符的结算类别：

  • 对话型 - 此类代理可参与复杂的用户互动，其中消息会在双方之间交换。

以下两个类别绝不会创建对话式结算事件。运营商会根据传送的内容，按基本短信或单条短信的价格向您收费。

  • 单个消息 - 此类客服人员通常会发送内容丰富的消息，很少希望收到回复。
  • 基本消息 - 此代理会将短信升级为 RBM，并且很少会收到回复。通常，客服人员发送的纯文本短信不应超过 160 个字符。但代理没有限制；如果被编程为发送更丰富的内容，则可以发送更丰富的内容，并且会相应地计费。

您可以在发布代理之前更改代理的账单类别。请与我们联系，讨论改用其他结算类别。

确定代理的用例

每个 RBM 代理都必须有一个预定义的用例，该用例反映了它打算与最终用户进行对话的性质，并帮助企业遵守业务规则。RBM 支持以下四种用例：

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

如需更详细地了解何时使用每种使用情形，请参阅选择合适的使用情形。

代理提交发布后，您将无法更改用例。在提交客服人员之前，请务必查看您所在国家/地区的应用场景和业务规则。

创建代理

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

  1. 打开 Business Communications 开发者控制台，然后使用您的 RBM 合作伙伴 Google 账号登录。
  2. 点击创建代理。
  3. 对于代理类型，请选择 RCS Business Messaging。
  4. 对于品牌，请选择您的代理将代表的品牌，或点击添加新品牌并输入品牌名称。
  5. 输入代理的姓名，然后选择代理所在的区域、结算类别和用例。然后，点击创建代理。
  6. 当您的客服人员有空时，点击客服人员的姓名。

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

邀请测试设备

现在，您已经有了代理，并且测试设备支持 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 替换为测试设备的电话号码。应包含国家/地区代码、区号和前置的 +，但不包含分隔符。例如 +14155555555。
  • 将 AGENT ID 替换为您的代理 ID，该 ID 位于 Business Communications 开发者控制台的代理信息页面上。
  • 将 PATH_TO_SERVICE_ACCOUNT_KEY 替换为您之前创建的密钥的路径。

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

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

后续步骤

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

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

上一页
设置你的合作伙伴账号