エージェントをテストするようにユーザーを招待します。
招待ユーザーは RCS が有効で、RBM プラットフォームから到達可能である必要があります。エージェントがユーザーをテスターに招待すると、RBM プラットフォーム管理エージェントは、エージェントのテスターになることの確認をユーザーに求めるメッセージを送信します。確認すると、ユーザーはテスターになります。
まだ起動していないエージェントは、そのエージェントのテスターであるユーザーとのみやり取りできます。起動されていないエージェントが非テスターにメッセージ、イベント、または機能のコールバックを送信しようとすると、RBM プラットフォームは 403 PERMISSION_DENIED
エラーを返します。
エージェントは、1 日に 20 件のテスター リクエストを送信できます(合計最大 200 件のテスター リクエストを送信できます)。これらの上限を超えるテスター リクエストを送信すると、RBM プラットフォームは 429 RESOURCE_EXHAUSTED
レスポンスを返します。
HTTP リクエスト
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
parent |
"phones/{E.164}"({E.164} は、E.164 形式のユーザーの電話番号)たとえば、米国の電話番号が +1-222-333-4444 の場合、エンドポイントは https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/ となります。 |
クエリ パラメータ
パラメータ | |
---|---|
agentId |
必須。エージェントの一意の識別子。 |
リクエスト本文
リクエストの本文には Tester
のインスタンスが含まれています。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Tester
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/rcsbusinessmessaging
詳細については、OAuth 2.0 の概要をご覧ください。