デバイスをテストする

エージェントが起動するまで、エージェントは指定したテストデバイスとのみ通信できます。これにより、エンドユーザーへの偶発的な早期アクセスを防止しながら、エージェントを内部でテストできます。

RBM エージェントと通信するには、テストデバイスを RCS 対応にする必要があります。なお、一部の Android デバイスでは、RCS がデフォルトで有効になっていません。デバイスの RCS ステータスを確認できます。また、必要に応じて、プレリリース版のメッセージ アプリと Carrier Services アプリを含むようにデバイスを設定することで、RCS を有効にできます。

デバイスが RCS 対応の場合、テスター リクエストを送信して、エージェントをテストするようデバイスに招待できます。デバイスは、リクエストを受け入れると、ロック解除されたエージェントからのメッセージを受信して応答できるようになります。

エージェントは、1 日に 20 件のテスター リクエストを送信できます。テスター リクエストの最大数は 200 です。RBM API を使用してテスターを追加し、200 を超えるリクエストを送信すると、RBM プラットフォームから 429 RESOURCE_EXHAUSTED レスポンスが返されます。

デバイスの RCS ステータスを確認する

  1. メッセージ アプリで [メッセージの設定] に移動します。
  2. [RCS チャット] をタップします。[RCS チャット] が表示されない場合は、[チャット機能] をタップします。

  3. [ステータス] の値を確認します。

    [ステータス] が [接続済み] の場合、デバイスで 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('../libs/rbm_api_helper');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', 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("+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. [Test device list] でデバイスを見つけ、そのリストアイテムの メニューをクリックします。
  4. [デバイスの削除] をクリックします。