測試裝置

在您啟動代理程式之前,它只能與指定的測試裝置通訊。這樣一來,您就能在內部測試服務機器人,同時避免意外提早提供給最終使用者。

如要與 RBM 服務專員通訊,測試裝置必須啟用 RCS。請注意,部分 Android 裝置預設不會啟用 RCS。您可以檢查裝置的 RCS 狀態,並在必要時使用「訊息」和「電信業者服務」應用程式的預發布版本,設定裝置啟用 RCS

當裝置支援 RCS 時,您可以傳送測試人員要求,邀請裝置測試您的服務專員。裝置接受要求後,即可接收並回應未啟動的服務機器人傳送的訊息。

每位服務專員每天最多可傳送 20 個測試人員要求,總計最多 200 個測試人員要求。如果您透過 RBM API 新增測試人員,且傳送超過 200 個要求,RBM 平台會傳回 429 RESOURCE_EXHAUSTED 回應。

查看裝置的 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('+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 範例代理程式

後續步驟

裝置接受測試人員要求後,就會成為代理程式的指定測試裝置。您可以將訊息事件功能檢查傳送到裝置,以測試服務專員的功能和工作流程。

移除測試裝置

移除測試裝置後,裝置就無法再接收未啟動的代理程式傳送的訊息。RBM 平台不會刪除由代理程式傳送至測試裝置,或儲存在測試裝置上的訊息。

  1. 開啟 Business Communications 開發人員控制台,使用 RBM Google 帳戶登入,然後點選您的服務專員。
  2. 在左側導覽面板中,按一下「裝置」
  3. 在「測試裝置清單」中找出裝置,然後按一下該清單項目的 選單。
  4. 按一下「移除裝置」