統合のカスタムアクションに契約を追加する


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

このページで説明されている機能は近日リリース予定です。詳細については、さまざまなデータアクション統合のリリース ノート参照してください。AWSラムダMicrosoft Dynamics 365PureCloudSalesforceウェブサービスZendesk

カスタムアクションを作成するときは、まずアクションを追加してから契約を追加します。契約は、あなたがその実行のためにアクションに提供する情報とそれが最終的に返す応答を定義します。詳細については、 インテグレーション用のカスタムアクションを作成する.

注意:アクションを公開した後で契約を変更することはできません。
  1. クリック セットアップ タブ。
  2. クリック 契約 タブ。
  3. 入力契約、クリック シンプル または JSON 契約を構成します。Genesysでは、単純な入力方法を使用することをお勧めします。

    入力コントラクトは、実行するアクションに提供する情報を定義します。

    ノート
    • 入力コントラクトは、キーと値のペアを持つオブジェクトを受け入れます。キーと値のペアは、次のデータ型に制限されています。文字列、整数、数値、ブール値、null。入力コントラクトは、ネストされたオブジェクトをサポートしていません。
    • 入力コントラクトのプロパティ名は、英字(az、AZ)で始まり、英字、数字(0-9)、ハイフン( - )、またはアンダースコア(_)のみを含む必要があります。

    インターフェイスを使用して、オブジェクトとオブジェクトプロパティを追加します。インターフェイスは、JSONスキーマを正しくフォーマットおよび構造化します。

    Genesysでは、 Architectワークフローで簡単に識別できるように、タイトルと説明を追加することをお勧めします。

    タイトル:追加するスキーマアイテムのタイトル。

    データ型セレクター:スキーマアイテムにデータ型を割り当てます。スキーマの最上位項目はオブジェクトのみです。オブジェクトプロパティには、文字列、数値、整数、ブール値、またはnullを指定できます。

    アスタリスク :アイテムが必要かどうかを示します。デフォルトは、スキーマの最上位アイテムが必要です。

    チャット :説明を追加した場合、アイコンにカーソルを合わせると暗くなり、説明が表示されます。(展開された構成オプションに説明を追加できます。クリック 鉛筆 

    プラス :オブジェクトプロパティに新しい行を追加します。多数のプロパティを追加できます。インターフェイスの構成オプションは、さまざまなデータ型(文字列、数値、整数、ブール値、またはnull)を使用できることを除いて、最上位オブジェクトに似ています。

    鉛筆 :より多くの構成オプションを備えたインターフェースを開きます。これらのオプションは、選択したデータタイプによって異なります。設定を保存するには、チェックマークをクリックします

    削除する :行を削除します。チェックマークをクリックした後 、チェックマークをクリックします 削除の確認またはクリック 削除する 削除をキャンセルします。


    他のアクションから入力コントラクトをコピーするか、またはJSONスキーマを作成するためのガイドとして次の例を使用できます。

    入力契約

    {
      "$schema": "http://json-schema.org/draft-04/schema#",
      "type": "object",
      "required": [
        "service"
      ],
      "properties": {
        "service": {
          "type": "string"
        }
      }
    }


  4. 出力契約、クリック シンプル または JSON 契約を構成します。Genesysでは、単純な入力方法を使用することをお勧めします。

    出力コントラクトは、実行が成功した後にアクションが返す情報を定義します。

    注意:出力コントラクトは、ネストされた配列をサポートしていません。


    インターフェイスを使用して、オブジェクトとオブジェクトプロパティ、または配列と配列項目を追加します。インターフェイスは、JSONスキーマを正しくフォーマットおよび構造化します。

    Genesysでは、 Architectワークフローで簡単に識別できるように、タイトルと説明を追加することをお勧めします。

    タイトル:追加するスキーマアイテムのタイトル。

    データ型セレクター:スキーマアイテムにデータ型を割り当てます。スキーマの最上位のアイテムは、オブジェクトまたは配列です。オブジェクトのプロパティまたは配列項目には、文字列、数値、整数、ブール値、またはnullを使用できます。

    アスタリスク :アイテムが必要かどうかを示します。デフォルトは、スキーマの最上位アイテムが必要です。

    チャット :説明を追加した場合、アイコンにカーソルを合わせると暗くなり、説明が表示されます。(展開された構成オプションに説明を追加できます。クリック 鉛筆

    プラス :オブジェクトプロパティまたは配列項目の新しい行を追加します。多数のオブジェクトプロパティまたは配列項目を追加できます。インターフェースの構成オプションは、オブジェクトまたは配列に似ていますが、異なるデータ型(文字列、数値、整数、ブール、またはnull)が利用できる点が異なります。

    鉛筆 :より多くの構成オプションを備えたインターフェースを開きます。これらのオプションは、選択したデータタイプによって異なります。設定を保存するには、チェックマークをクリックします

    削除する :行を削除します。チェックマークをクリックした後 、チェックマークをクリックします 削除の確認またはクリック 削除する  削除をキャンセルします。



    他のアクションから出力コントラクトをコピーするか、またはJSONスキーマを作成するためのガイドとして以下の例を使用できます。

    出力契約

    {
      "$schema": "http://json-schema.org/draft-04/schema#",
      "type": "object",
      "required": [
        "build",
        "name",
        "status"
      ],
      "properties": {
        "build": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "status": {
          "type": "string"
        }
      }
    }


    次、 設定を追加

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

    統合について詳しくは、AWS Lambdaデータアクション統合についてMicrosoft Dynamics 365データアクション統合についてPureCloudデータアクション統合についてSalesforceデータアクション統合についてWeb サービス データアクションの統合について、そして Zendeskデータアクション統合についてを参照してください。