Method: phones.testers.create

ユーザーをエージェントのテストに招待します。

招待されたユーザーは 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

string

「phones/{E.164}」。{E.164} は、E.164 形式のユーザーの電話番号です。たとえば、米国の電話番号 +1-222-333-4444 の場合、結果のエンドポイントは https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/ になります。

クエリ パラメータ

パラメータ
agentId

string

必須。エージェントの固有識別子。

リクエストの本文

リクエストの本文には Tester のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Tester のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/rcsbusinessmessaging

詳細については、OAuth 2.0 Overview をご覧ください。