測試裝置

您必須先啟動代理程式，才能與指定的測試裝置通訊。這可讓您在內部測試代理程式，同時防止使用者意外存取。

如要與 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，才能測試 RRM 代理程式。

在裝置上啟用 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('../libs/rbm_api_helper');

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

這個程式碼是由 RBM 範例代理程式摘錄。

Java

import com.google.rbm.samples.lib.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. 在「Test device list」中找到裝置，然後按一下該清單項目的 選單。
4. 按一下「移除裝置」。