测试设备

在您发布代理之前，该代理只能与指定的测试设备通信。这样，您就可以在内部测试客服人员，同时防止最终用户意外提前访问。

如需与 RBM 代理通信，测试设备需要启用 RCS。请注意，某些 Android 设备默认未启用 RCS。您可以使用预发布版本的“信息”和“运营商服务”应用配置设备，以查看设备的 RCS 状态，并根据需要启用 RCS。

当您的设备支持 RCS 后，您可以发送测试人员请求，邀请该设备测试您的客服代理。设备接受请求后，就可以接收并响应来自未启动代理的消息。

代理每天可以发送 20 个测试人员请求，总数不得超过 200 个测试人员请求。如果您通过 RBM API 添加测试人员，并且发送的请求超过 200 个，RBM 平台会返回 429 RESOURCE_EXHAUSTED 响应。

注意：代理发布后，它可以与任何启用 RCS 的设备（而不仅仅是测试设备）进行通信。

检查设备的 RCS 状态

1. 在“信息”应用中，前往“信息”设置。
2. 点按 RCS 消息功能。如果您找不到“RCS 聊天”，请点按聊天功能。

3. 找到状态值。

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

后续步骤

如果您的设备已启用 RCS，您就可以发送测试人员请求。如果您的设备上未启用 RCS，您需要先在设备上启用 RCS，然后才能开始使用 RCS 测试 RBM 代理。

在设备上启用 RCS

如需在 Android 设备上启用 RCS，请在“信息”应用中开启 RCS 消息功能。

后续步骤

在您的设备上启用 RCS 后，您就可以发送测试人员请求了。

发送测试人员请求

如要邀请支持 RCS 的设备成为测试人员，您需要发送测试人员请求。 如果设备接受请求，您的代理便可以向设备发送消息、事件和请求。

如果设备未启用 RCS、未响应测试人员的请求或拒绝了请求，您的代理在尝试与设备通信时会收到 403 PERMISSION_DENIED 错误。

选项 1：使用 Business Communications 开发者控制台发送测试人员申请

1. 打开 Business Communications 开发者控制台，使用您的 RBM Google 账号登录，然后点击您的代理。
2. 在左侧导航栏中，点击设备。
3. 在添加测试设备部分，输入设备的电话号码，然后点击添加。

测试设备列表详细说明了您邀请测试代理的每台设备的测试人员请求状态。

选项 2：使用 RBM API 发送测试人员请求

以下代码会发送测试人员请求。如需了解格式设置和值选项，请参阅 phones.testers。

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('[phone]', function(response) {
   console.log(response);
});

此代码摘自 RBM 示例代理。

Java

import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Register the device as a tester
   rbmApiHelper.registerTester("[phone]");
} catch(Exception e) {
   e.printStackTrace();
}

此代码摘自 RBM 示例代理。

Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Send the tester invite to a device
rbm_service.invite_tester('[phone]')

此代码摘自 RBM 示例代理。

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Register the device as a tester
rbmApiHelper.RegisterTester("[phone]");

此代码摘自 RBM 示例代理。

后续步骤

设备接受测试人员请求后，便会成为您的代理的指定测试设备。您可以向设备发送消息、事件和功能检查，以测试代理的功能和工作流。

移除测试设备

移除测试设备后，该设备将无法再接收未启动的代理发送的消息。RBM 平台不会删除代理所发送的消息，这些消息将传输至测试设备或存储在测试设备上。

1. 打开 Business Communications 开发者控制台，使用您的 RBM Google 账号登录，然后点击您的代理。
2. 在左侧导航栏中，点击设备。
3. 在测试设备列表中找到相应设备，然后点击该列表项的 菜单。
4. 点击移除设备。