統合用のカスタムアクションに設定を追加する

 メモ:   この記事は、AWS Lambda、Genesys Cloud、Google、Microsoft Dynamics 365、Salesforce、Web サービス、Zendesk データ アクションの統合に適用されます。

カスタムアクションを作成するときは、最初に契約を追加してから設定を追加します。 構成は、アクションがコントラクトを実装する方法を定義します。 詳細については、 データ操作のテスト そして カスタムアクションに設定を追加する。

 メモ:   アクションを公開した後に設定を変更できます。 詳細については、 カスタムアクションで設定を変更する
  1. クリックし、 構成 ] タブ。 
  2. HTTPメソッドを選択してください。
  3. リクエスト、アクションがWebサービスに送信するリクエストを設定します。 Genesysでは、下のフィールドを使用してリクエストを設定することをお勧めします。 単純な
    ヒント:   下のプロパティをクリックします 利用可能な入力 コピーしてすぐにリクエストに貼り付けることができます。 これらの特性はあなたの入力契約から来ます。 詳細については、 カスタムアクションに契約を追加する。 テンプレートでマクロを使うことができます。 詳細については、 データアクション用の速度マクロ

    表示されたフィールドに情報を入力します。 表示されるフィールドは、選択したHTTP方式と追加したコントラクトによって異なります。

    メモ: 
    • AWS Lambdaデータアクションの統合とGoogle Cloud Functionsについては、以下を参照してください。特別なリクエスト構成セクション。
    • 過度にネストされたJSONオブジェクトは、データアクションサービスのパフォーマンスに影響を与える可能性があります。 パフォーマンスを維持するため、JSONオブジェクトの深さは50レベルに制限されている。 詳しくは、Genesys Cloud Developer Center のLimits をご覧ください。
    • リクエスト URL テンプレート

      セット リクエストURLテンプレート HTTPリクエストがヒットしたリモートエンドポイントへ。

    • ヘッダ (オプション)

      リモートエンドポイントに送信される要求にHTTPヘッダーとして追加されるキーと値のペア。

      注意: Acceptヘッダーを設定する場合は、ヘッダー値としてJSONメディアタイプを使用する必要があります。

    • 転送エンコーディング

      Webサービスがサポートしていない場合 転送エンコーディング に設定 チャンク、 追加 転送エンコーディング: 緩衝ヘッダー。 詳細については、 カスタムアクションが予期せぬ理由で失敗する

    • 承認

      要求構成に許可情報を含めることができます。 詳細については、 ユーザー定義資格情報タイプの使用方法 そして ユーザー定義(OAuth)資格情報の種類を使用する方法

    特別リクエスト構成

    AdobeまたはAWS Lambdaデータアクション統合に関連付けられている、またはGoogle Cloud Functionsを実行するカスタムアクションのリクエスト構成は、ウェブサービスの標準リクエスト構成とは異なります。

    • リクエスト URL テンプレート

      セット リクエストURLテンプレート AWS Lambda関数のARNに。 詳細については、 AWS Lambda関数を呼び出すためのIAMリソースを作成する。 

    • 申請のタイプ

      セット 要求 タイプ に 役職。 このHTTPメソッドは、アクションがリクエスト設定とともにリクエストボディを送信することを保証します。

    • ヘッダー

      に追加されるキーと値のペア カスタム 上の地図 clientContext オブジェクト。 の clientContext 次に、オブジェクトは呼び出しの値です 環境 オブジェクト。 次の属性が存在する場合、それらは自動的に設定されます 環境 オブジェクト:

      • ININ-組織ID
      • ININ-Home-Organization-Id
      • ININ-相関ID
      • ININ-ユーザーID
      • ININ-統合ID

      のJavaの例 clientContext オブジェクト、参照 インターフェースClientContext

    • リクエストテンプレート

      指定した値 リクエストテンプレート で利用可能になります イベント 呼び出されたAWS Lambda関数のパラメーター。

    • リクエスト URL テンプレート

      セットする リクエストURLテンプレート 場所あなたがしたいことをGoogleクラウド機能のデータ アクションを実行するには: https://{location-of-function}-{project-owning-function}/{function-name}.

    • 申請のタイプ

      セット 要求 タイプ に 役職。

    • リクエストテンプレート

      リクエストテンプレート${input.rawRequest} に設定 . 

    要求の部分の詳細な説明については、 データアクションの設定要求

    JSONに精通している人はJSON入力オプションを使用できます。 JSONを作成するためのガイドとして、他のアクションまたは次の例の要求を使用してください。

    {
      "requestUrlTemplate": "https://www.example.com/health/check/services/${input.service}",
      "requestType": "GET",
      "headers": {},
      "requestTemplate": "${input.rawRequest}"
    }

  4. 応答JSON設定を追加します。

    JSON設定は、WebサービスまたはAWS Lambda関数からの応答がどのように処理されるかを定義します。

    JSONを作成するためのガイドとして、他のアクションまたは次の例で応答を使用できます。 成功テンプレートでマクロを使用する方法の詳細については、 データアクション用の速度マクロ

    ヒント:   下のプロパティをクリックします 利用可能な出力 コピーしてすばやく応答に貼り付けます。 これらの特性はあなたの生産契約から来ます。 詳細については、 カスタムアクションに契約を追加する
    {
          "translationMap": {
              "buildNumber": "$.Build-Version",
              "serviceName": "$.name",
              "status": "$.Status"
          },
          "successTemplate": "{\r\n      \t\"build\": ${buildNumber},\r\n      \t\"name\": ${serviceName},\r\n\"status\": ${status}\r\n      }"
     }

    応答の部分の詳細な説明については、 データアクションのレスポンス設定

次、 アクションをテストする 検証および実行エラー

詳細については、 統合のカスタムアクションについて

統合の詳細については、 データアクションの統合についてをご覧ください。