エージェントを起動するまでは、指定したテストデバイスとのみ通信できます。これにより、エンドユーザーへの早期アクセスを誤って防ぎながら、エージェントを社内でテストできます。
RBM エージェントと通信するには、テストデバイスで RCS を有効にする必要があります。一部の Android デバイスでは、RCS がデフォルトで有効になっていません。デバイスの RCS のステータスを確認したり、必要に応じて RCS を有効にしたりするには、Google のメッセージ アプリと Carrier Services アプリのプレリリース バージョンを使用してデバイスを構成します。
デバイスで RCS が有効になっている場合は、テスター リクエストを送信して、デバイスをエージェントのテストに招待できます。デバイスがリクエストを承認すると、未公開エージェントからのメッセージを受信して返信できるようになります。
エージェントは 1 日に 20 件のテスター リクエストを送信できます。最大合計は 200 件のテスター リクエストです。RBM API を使用してテスターを追加し、200 件を超えるリクエストを送信すると、RBM プラットフォームから 429 RESOURCE_EXHAUSTED レスポンスが返されます。
デバイスの RCS のステータスを確認する
- メッセージ アプリで [メッセージの設定] に移動します。
- [RCS チャット] をタップします。[RCS チャット] が見つからない場合は、[チャット機能] をタップしてください。
[ステータス] の値を確認します。
[ステータス] が [接続済み] の場合、デバイスで RCS が有効になっています。
次のステップ
デバイスで RCS が有効になっている場合は、テスター リクエストを送信できます。デバイスで RCS が有効になっていない場合は、デバイスで RCS を有効にしてから、RBM エージェントのテストを開始する必要があります。
デバイスで RCS を有効にする
Android デバイスで RCS を有効にするには、Google のメッセージ アプリで RCS チャットをオンにする必要があります。
次のステップ
デバイスで RCS が有効になったら、テスター リクエストを送信できます。
テスター リクエストを送信する
RCS 対応デバイスをテスターとして招待するには、テスター リクエストを送信します。デバイスがリクエストを承認すると、エージェントはデバイスにメッセージ、イベント、リクエストを送信できます。
デバイスで RCS が有効になっていない場合、テスターのリクエストに応答しなかった場合、またはリクエストを拒否した場合、エージェントはデバイスとの通信を試みると 403 PERMISSION_DENIED エラーを受け取ります。
方法 1: Business Communications デベロッパー コンソールでテスター リクエストを送信する
- ビジネス コミュニケーション デベロッパー コンソールを開き、RBM Google アカウントでログインして、エージェントをクリックします。
- 左側のナビゲーションで [デバイス] をクリックします。
- [テストデバイスを追加] で、デバイスの電話番号を入力し、[追加] をクリックします。
テストデバイスのリストには、エージェントのテストに招待した各デバイスのテスター リクエストのステータスが表示されます。
方法 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 プラットフォームでは、エージェントから送信されたメッセージがテストデバイスに転送中または保存中の場合、そのメッセージは削除されません。
- ビジネス コミュニケーション デベロッパー コンソールを開き、RBM Google アカウントでログインして、エージェントをクリックします。
- 左側のナビゲーションで [デバイス] をクリックします。
- [テストデバイスのリスト] でデバイスを見つけ、そのリストアイテムの メニューをクリックします。
- [デバイスの削除] をクリックします。