受信 REST エンドポイントの確認と受信認証の構成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:1分
  • 仮想エージェント API をインストールした後、スクリプト化された REST API リソースに移動してエンドポイントを確認し、認証を設定します。

    始める前に

    必要なロール:admin

    手順

    1. 移動先 すべて > システム Web サービス > スクリプト化 Web サービス > スクリプト化 REST API.
    2. VA ボット統合レコードを選択して開きます。
    3. [リソース] タブで、BOT 統合レコードを開きます。
    4. 受信 REST API リソースの詳細を確認します。

      形式は https://<customer instance>/api/sn_va_as_service/bot/integration です。

      REST エンドポイントのリソースパス値を確認します。

      要求パラメーターと送信例の説明については、「仮想エージェントボット統合 API」を参照してください。

    5. [セキュリティ] タブで、[認証が必要] チェックボックスをオンにします。
      [認証が必要] チェックボックスをオンにします。
    6. 基本認証、OAuth 認証、ハッシュ、または静的トークンのいずれかの方法を使用してプロバイダー認証を設定します。
      注:
      [認証が必要] を選択した場合、基本認証または OAuth 認証によるゲストの使用はすぐに利用可能です。ユーザーアカウントのリンクをサポートするには、静的認証またはハッシュトークンベースの認証を使用する必要があります。トークンベースの認証 (静的またはハッシュ) は、基本認証または OAuth 認証の有無にかかわらず使用できます。トークンは、要求本文またはヘッダーのいずれかで渡すことができます。トークンが両方の場所で指定されている場合、ヘッダーのトークンが受け入れられます。
      次のいずれかの操作を行います。
      • 基本認証または OAuth 認証を設定します。

        OAuth 認証およびスクリプト済み REST API の可能なセキュリティ構成の詳細については、「受信 REST で OAuth を有効にする」を参照してください。

      • メッセージ認証を設定します。これには、静的トークンまたはハッシュトークンの設定、プロバイダー認証の設定、およびチャネル ID の設定が含まれます。詳細については、「受信通信用のメッセージ認証の設定」を参照してください。

    次のタスク

    メッセージ認証を使用している場合は、受信通信用のメッセージ認証の設定

    仮想エージェント API の出力応答 REST エンドポイントと送信認証の構成