设置测试设备

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

如需与 RBM 代理通信,测试设备需要启用 RCS。请注意,部分 Android 设备默认未启用 RCS。如需查看设备的 RCS 状态,请参阅查看设备的 RCS 状态

客服人员每天最多可以发送 20 份测试人员邀请,总限额为 200 份。

查看设备的 RCS 状态

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

如果您的设备未启用 RCS,请通过使用“信息”和“运营商服务”应用的预发布版本配置设备来启用 RCS

如果您的设备支持 RCS,您可以发送测试人员邀请。 当设备接受邀请后,即可开始与未发布的代理进行消息对话。

在设备上启用 RCS

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

当 RCS 在您的设备上处于有效状态时,您就可以发送测试人员邀请了。

发送测试人员邀请

如需邀请已启用 RCS 的设备成为测试人员,请发送测试人员邀请。 当设备接受邀请后,您的代理便可以向设备发送消息、事件和请求。

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

控制台

如需使用 Business Communications 开发者控制台发送测试人员邀请,请执行以下操作:

  1. 打开 Business Communications 开发者控制台,使用您的 RBM Google 账号登录,然后点击您的代理。
  2. 在左侧菜单中,选择设备
  3. 通过输入设备的电话号码(包括国家/地区代码和区号),将测试设备添加到测试设备列表。如需添加多个电话号码,请用英文逗号分隔。

当设备添加到列表后,系统会发送邀请。用户会在设备上看到邀请消息,并可以选择接受或拒绝。

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

API

如需使用 RBM 管理 API 发送测试人员邀请,请执行以下操作:

  • 使用以下代码。如需了解格式设置和值选项,请参阅 testers

cURL

curl -X POST "https://businesscommunications.googleapis.com/v1/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`" \
-d '{"phone_number": "PHONE_NUMBER", "agentId": "AGENT_ID"}'

Node.js

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

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', 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("+12223334444");
} 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('+12223334444')
此代码摘自 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("+12223334444");
此代码摘自 RBM 示例代理

如果您发送的邀请超过 200 份,RBM 平台会在响应中返回 429 RESOURCE_EXHAUSTED 错误代码。

重新发送测试人员邀请

如果需要,您可以重新发送测试人员邀请。结果取决于设备的当前邀请状态

设备状态 结果
PENDING 测试人员邀请已发送到设备。
ACCEPTED 测试人员邀请未发送到设备,设备保持 ACCEPTED 状态。
DECLINED 测试人员邀请已被拒绝。您必须先移除测试设备,然后才能重新发送邀请。否则,请求将失败。

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

获取测试设备的邀请状态

您邀请测试人员后,他们可以在自己的设备上接受或拒绝邀请。您可以查询 API 以了解设备的邀请状态

控制台

如需使用 Business Communications 开发者控制台获取测试设备的邀请状态,请执行以下操作:

  1. 打开 Business Communications 开发者控制台,使用您的 RBM Google 账号登录,然后点击您的代理。
  2. 在左侧菜单中,选择设备
  3. 通过输入设备的电话号码(包括国家/地区代码和区号),将测试设备添加到测试设备列表。如需添加多个电话号码,请用英文逗号分隔。

将测试设备添加到列表后,您可以在状态列中查看其状态。

API

如需使用 RBM Management API 获取测试设备的邀请状态,请执行以下操作:

  • 使用以下代码。如需了解格式设置和值选项,请参阅 testers

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

获取所有测试设备的状态

您可以查询您邀请的所有设备的邀请状态

控制台

如需使用 Business Communications 开发者控制台检查所有测试设备的邀请状态,请执行以下操作:

  1. 打开 Business Communications 开发者控制台,使用您的 RBM Google 账号登录,然后点击您的代理。
  2. 在左侧菜单中,选择设备
  3. 通过输入设备的电话号码(包括国家/地区代码和区号),将测试设备添加到测试设备列表。如需添加多个电话号码,请用英文逗号分隔。

将测试设备添加到列表后,您可以在状态列中查看其状态。

API

如需使用 RBM 管理 API 检查所有测试设备的邀请状态,请执行以下操作:

  • 使用以下代码。如需了解格式设置和值选项,请参阅 testers

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

移除测试设备

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

控制台

如需使用 Business Communications 开发者控制台移除测试设备,请执行以下操作:

  1. 打开 Business Communications 开发者控制台,使用您的 RBM Google 账号登录,然后点击您的代理。
  2. 在左侧菜单中,选择设备
  3. 测试设备列表中选择设备,然后点击 菜单。
  4. 点击移除设备

API

如需使用 RBM 管理 API 移除测试设备,请执行以下操作:

  • 使用以下代码。如需了解格式设置和值选项,请参阅 testers

cURL

curl -X DELETE "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"