設定測試裝置

在推出代理程式之前，代理程式只能與指定的測試裝置通訊。這項功能可讓您在內部測試代理程式，避免使用者在無意間提早存取。

如要與 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 Management 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 測試人員拒絕邀請。您必須先移除測試裝置，才能重新傳送邀請。否則要求會失敗。

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

取得測試裝置的邀請狀態

測試人員收到邀請後，可以在裝置上接受或拒絕。您可以查詢裝置的邀請狀態。

主控台

如要透過 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`"

取得所有測試裝置的狀態

您可以查詢所有受邀裝置的邀請狀態。

主控台

如要透過商家通訊開發人員控制台查看所有測試裝置的邀請狀態，請按照下列步驟操作：

  1. 開啟 Business Communications 開發人員控制台，使用 RBM Google 帳戶登入，然後按一下您的代理程式。
  2. 選取左選單中的「裝置」。
  3. 輸入裝置的電話號碼 (包括國家/地區代碼和區碼)，將測試裝置新增至「測試裝置清單」。如要新增多組電話號碼，請以逗號分隔各組電話號碼。

將測試裝置新增至清單後，您可以在「狀態」欄中查看裝置狀態。

API

如要使用 RBM Management 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 Management 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`"
上一頁
編輯服務專員資訊
下一頁
深層連結