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

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

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

メモ： アクションを公開した後に設定を変更できます。詳細については、カスタムアクションで設定を変更する。

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

表示されたフィールドに情報を入力します。表示されるフィールドは、選択したHTTP方式と追加したコントラクトによって異なります。
メモ:
- AWS Lambdaデータアクションの統合とGoogle Cloud Functionsについては、以下を参照してください。特別なリクエスト構成セクション。
- 過度にネストされたJSONオブジェクトは、データアクションサービスのパフォーマンスに影響を与える可能性があります。パフォーマンスを維持するため、JSONオブジェクトの深さは50レベルに制限されている。詳しくは、Genesys Cloud Developer Center のLimits をご覧ください。
リクエスト URL テンプレート
セットリクエストURLテンプレート HTTPリクエストがヒットしたリモートエンドポイントへ。
ヘッダ（オプション）
リモートエンドポイントに送信される要求にHTTPヘッダーとして追加されるキーと値のペア。
注意： Acceptヘッダーを設定する場合は、ヘッダー値としてJSONメディアタイプを使用する必要があります。
Execution Timeout
Set the execution timeout between 1 and 60 seconds for the data action. The default timeout of 60 seconds is used when you do not set a timeout value. When the HTTP requests run longer than the set time, then the data action returns a timeout response. After the designated time limit, the data action execution is removed from the concurrency limit. For more information, see How many seconds before a data action times out?.
Note: To ensure that a flow’s timeout logic is executed correctly and to prevent unnecessary data action processing, set the data action’s timeout to be one second longer than the flow’s configured timeout. This best practice helps to manage concurrency limit by ensuring that the data action doesn’t continue after the flow has already timed out.
転送エンコーディング
Webサービスがサポートしていない場合転送エンコーディングに設定チャンク、追加転送エンコーディング：緩衝下ヘッダー。詳細については、カスタムアクションが予期せぬ理由で失敗する。
承認
要求構成に許可情報を含めることができます。詳細については、ユーザー定義資格情報タイプの使用方法そしてユーザー定義（OAuth）資格情報の種類を使用する方法。

特別リクエスト構成

The request configuration for custom actions that are associated with the AWS Lambda data actions integrations or that execute the Google Cloud Functions vary from the standard request configuration for web services.

リクエスト 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テンプレート HTTPリクエストがヒットしたリモートエンドポイントへ。
申請のタイプ
セット要求タイプに役職。このHTTPメソッドは、アクションがリクエスト設定とともにリクエストボディを送信することを保証します。
ヘッダー
に追加されるキーと値のペアカスタム上の地図 clientContext オブジェクト。の clientContext 次に、オブジェクトは呼び出しの値です環境オブジェクト。次の属性が存在する場合、それらは自動的に設定されます環境オブジェクト：
- ININ-組織ID
- ININ-Home-Organization-Id
- ININ-相関ID
- ININ-ユーザーID
のJavaの例 clientContext オブジェクト、参照インターフェースClientContext.
リクエストテンプレート
Any values that you specify under Request Template will be available in the event parameter of the invoked AWS Lambda function. The clientContext has length limits and cannot be used to pass certificates required for Genesys Cloud Function data actions. To include the certificates configured in credentials, use the body of the request template, which has no size restrictions.

リクエスト URL テンプレート
セットするリクエストURLテンプレート場所あなたがしたいことをGoogleクラウド機能のデータアクションを実行するには： https://{location-of-function}-{project-owning-function}/{function-name}.
申請のタイプ
セット要求タイプに役職。
リクエストテンプレート
リクエストテンプレート を${input.rawRequest} に設定 .

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

上級ユーザー（JSON）

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

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

下応答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      }"
 }
```
応答の部分の詳細な説明については、データアクションのレスポンス設定。

次、関数を追加するGenesys Cloud Function 向け。その他のデータアクションについては、アクションをテストする検証および実行エラーの場合。

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

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