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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む1読むのに数分
  • 仮想エージェント API をインストールした後、スクリプト化された REST API リソースに移動してエンドポイントを確認し、認証を設定します。

    始める前に

    必要なロール:管理者

    手順

    1. 移動先 すべて > システム Web サービス > スクリプト済み Web サービス > スクリプト済み REST APIs.
    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 認証および Scripted REST APIs の可能なセキュリティ構成の詳細については、「受信 REST で OAuth を有効にする」を参照してください。

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

    次のタスク

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

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