複数のプロバイダーアプリケーションの構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：2分

    • 仮想エージェント API を使用する複数のプライマリボットがあり、それらを区別する必要がある場合は、AI エージェントをサポートするように複数のプロバイダーアプリケーションを構成できます。

    始める前に

    必要なロール：admin

    アプリケーションスコープ内にいることを確認してください 仮想エージェント API 。

    手順

    1. 移動先 すべて > sys_cs_provider_application.
    2. [ 新規 ] をクリックして、新しいプロバイダーアプリケーションを作成します。
    3. フォームで、フィールドに入力します。
      フィールド 説明
      名前 VA API カスタムボットなどのプロバイダーアプリケーションの名前。
      プロバイダー VA ボット間プロバイダーとしてプロバイダーを選択します。
      受信 ID 要求メッセージで使用される一意の受信 ID (custom_1 など)。
      メッセージ認証 受信通信用のトークンを使用してメッセージ認証を設定します。詳細については、「着信通信のメッセージ認証の設定」を参照してください。
    4. [Submit (送信)] を選択します。
    5. 移動先 すべて > システム Web サービス > REST メッセージ.
    6. [ 新規 ] をクリックして、新しい REST メッセージレコードを作成します。
    7. REST メッセージレコードで、フォームフィールドに入力します。
      フィールド 説明
      名前 REST メッセージレコードの名前。これは、新しく作成されたプロバイダーアプリケーションと同じである必要があります。
      エンドポイント プライマリボットの応答エンドポイント。
    8. [Submit (送信)] を選択します。
    9. [HTTP メソッド] セクションで、[新規] をクリックして新しいメソッドを作成するか、デフォルトの GET メソッドを上書きできます。
      フィールド 説明
      名前 HTTP メソッドの名前。postMessage と入力します。
      HTTP メソッド [ POST] を選択します。
      エンドポイント プライマリボットの応答エンドポイントを入力します。
      認証タイプ 要件に従って基本認証または OAuth 2.0 認証を構成します。ベーシック認証の構成の詳細については、「 ベーシック認証を使用した REST メッセージの構成」を参照してください。OAuth 2.0 の構成の詳細については、「 OAuth を使用した REST メッセージの構成」を参照してください。
    10. 新しく作成されたプロバイダーアプリケーションを使用するには、仮想エージェント API要求のappInboundIdパラメーターでプロバイダーアプリケーションの受信 ID を渡します。
      仮想エージェント API要求ごとに、appInboundIdパラメーターでプロバイダーアプリケーションの受信 ID を渡す必要があります。新しく作成されたプロバイダーアプリケーションを使用するサンプル 仮想エージェント API 要求を次に示します。
      
{
    "userId": "adminuser1",
    "emailId": "admin@example.com",
    "action": "START_CONVERSATION",
    "message": {
        "text": "",
        "typed": true
    },
    "appInboundId": "custom_1",
    "contextVariables": {
        "app_name": "test"
    }
}

      送信 HTTP ログを表示して、応答エンドポイントが呼び出されたことを確認することで、構成をテストできます。