データアクション統合を追加する

統合を使用するには、Genesys Cloud Function データアクション統合を 1 つ以上 Genesys Cloud 組織に追加します。複数の統合により、さまざまな構成とカスタムアクションを使用して、さまざまな AWS Lambda 関数を通じてデータを操作できます。

資格

関数内のカスタム コードは、外部システムとの認証を処理する役割を担います。資格情報をコード内に直接保存することは避けてください。代わりに、構成中にそれらを Genesys Cloud Function データ アクションに安全に渡します。資格情報はコード内に保存されないため、漏洩のリスクが軽減されます。コード自体を変更することなく、統合構成を通じて資格情報を簡単に更新できます。 

1. 統合を追加します。 

   [詳細] タブに統合が開きます。 を 詳細 タブを使用すると、統合名を変更したり、統合に関するメモを追加したりできます。 

    メモ：   注記:統合名を変更する場合は、必ず一意の名前を使用して、それを参照するGenesys Cloudアプリケーションの統合と関連するアクションを区別してください。.

2. 資格情報を追加する。
   1. クリックし、 構成 ] タブ。 
   2. クリック 資格情報 タブ。
   3. クリック 構成.

      [資格情報の構成] ダイアログボックスが表示されます。

   4. クリック資格情報フィールドの追加次の情報を入力します。
      • フィールド名
      • 値
   5.   [OK] をクリックします。
   6. 保存するをクリックします。

      インストールしたすべての統合の一覧が表示されます。

3. 統合を有効化します。
    メモ：   統合を有効にしない場合、統合に関連するデータアクションをテストできません。データアクションはGenesys Cloudアプリケーションに表示されません。
   1. 追加した統合の下で、 ステータス 変更するにはトグル 非 アクティブ 宛先 アクティブ.

      ステータス変更ダイアログボックスが表示されます。

   2. はいをクリックします。

統合がアクティブになりました。 インストールされている統合の編集、非アクティブ化、または削除を行うことができます。 詳細については、 統合の編集、非アクティブ化、または削除. 

次に カスタムアクションを作成する.

統合を使用するには、1つ以上のGenesys Cloudデータアクション統合をGenesys Cloud組織に追加します。 複数の統合を使用すると、プラットフォーム API からのデータを操作するために、さまざまな構成とデータアクションを使うことができます。

1. 統合を追加します。 

   [詳細] タブに統合が開きます。 を 詳細 タブを使用すると、統合名を変更したり、統合に関するメモを追加したりできます。 

    メモ：   注記:統合名を変更する場合は、必ず一意の名前を使用して、それを参照するGenesys Cloudアプリケーションの統合と関連するアクションを区別してください。.

2. 資格情報を追加する。

   認証情報はGenesys Cloud OAuthクライアントの認証情報を使用します。 

   1. クリックし、 構成 ] タブ。 
   2. クリック 資格情報 タブ。
   3. クリック 構成.

      [資格情報の構成] ダイアログボックスが表示されます。

   4. 以下の情報を入力してください。
      • クライアント ID: Genesys Cloud OAuthクライアントの作成時に生成されるID。
      • クライアント シークレット: Genesys Cloud OAuthクライアントの作成時に生成されるシークレット。
   5.   [OK] をクリックします。
   6. 保存するをクリックします。

      インストールしたすべての統合の一覧が表示されます。

3. 統合を有効化します。
    メモ：   統合を有効にしない場合、統合に関連するデータアクションをテストできません。データアクションはGenesys Cloudアプリケーションに表示されません。
   1. 追加した統合の下で、 ステータス 変更するにはトグル 非 アクティブ 宛先 アクティブ.

      ステータス変更ダイアログボックスが表示されます。

   2. はいをクリックします。

統合がアクティブになりました。 インストールされている統合の編集、非アクティブ化、または削除を行うことができます。 詳細については、 統合の編集、非アクティブ化、または削除.

次に カスタムアクションを作成する または データアクションを使用する.

統合の詳細については、以下を参照してください。Genesys Cloudデータアクションインテグレーションについて.

統合を使用するには、1つ以上のGoogleデータアクション統合をGenesys Cloud組織に追加します。 複数の統合により、さまざまな設定とデータアクションを使用して、さまざまなGoogleアカウントのデータを操作できます。

1. 統合を追加します。 

   [詳細] タブに統合が開きます。 を 詳細 タブを使用すると、統合名を変更したり、統合に関するメモを追加したりできます。 

    メモ：   注記:統合名を変更する場合は、必ず一意の名前を使用して、それを参照するGenesys Cloudアプリケーションの統合と関連するアクションを区別してください。.

2. 資格情報を追加する。 
   1. クリックし、 構成 ] タブ。 
   2. クリック 資格情報 タブ。
   3. クリック 構成.

      [資格情報の構成] ダイアログボックスが表示されます。

   4. を選択 資格情報タイプこのデータアクション統合で使用するGoogle アプリケーション用。
      • Google Cloud Platformの場合は、 googleCloudPlatformServiceAccount.
      • G Suiteの場合は、 googleGSuiteServiceAccount.
   5. に基づいて次の情報を入力します 資格情報タイプ 選択済み：

      googleCloudPlatformServiceAccount

      • クライアント ID: Googleサービスアカウントの一意のID。 また、アカウントが生成するJSONキーファイルのclient_id。
      • クライアントの電子メール： Googleサービスアカウントのメール。 また client_email アカウントが生成するJSONキーファイル内。 
      • 秘密鍵ID： 秘密鍵ID: private_key_id Googleサービスアカウントが生成するJSONキーファイル内。
      • 秘密鍵: 秘密鍵: private_key Googleサービスアカウントが生成するJSONキーファイル内。
        ヒント:   チップ: 値のエラーを防ぐには、 引用符の間にある内容全体。ただし、引用符は含まれません。. アクションサービスは、追加の文字を正しく処理します。

      googleGSuiteServiceAccount

      • サービスアカウントの電子メール： Googleサービスアカウントのメール。 また client_email アカウントが生成するJSONキーファイル内。
      • 秘密鍵ID： 秘密鍵ID: private_key_id Googleサービスアカウントが生成するJSONキーファイル内。 
      • 秘密鍵: 秘密鍵: private_key Googleサービスアカウントが生成するJSONキーファイル内。
      • 認証コード 統合にアクセスを許可するスコープのカンマ区切りのリスト (例: https://www.googleapis.com/auth/admin.reports.usage.readonly、https://www.googleapis.com/) auth/admin.reports.usage.readonly.」

        必要なスコープについては、個々のGoogleAPIドキュメントを参照してください。たとえば、 CustomerUsageReports： GoogleドキュメントでUserUsageReports：getを開きます

      • ユーザーの電子メールのなりすまし（オプション）： 統合が委任されたアクセスを要求しているユーザーの電子メールアドレス。
         メモ：   ユーザーを参照する一部のAPIには、偽装が必要です。 詳細については、を参照してください。 データアクションは403エラーを返します。

   6.   [OK] をクリックします。
   7. 保存するをクリックします。

      インストールしたすべての統合の一覧が表示されます。

3. 統合を有効化します。
    メモ：   統合を有効にしない場合、統合に関連するデータアクションをテストできません。データアクションはGenesys Cloudアプリケーションに表示されません。
   1. 追加した統合の下で、 ステータス 変更するにはトグル 非 アクティブ 宛先 アクティブ.

      ステータス変更ダイアログボックスが表示されます。

   2. はいをクリックします。

統合がアクティブになりました。 インストールされている統合の編集、非アクティブ化、または削除を行うことができます。 詳細については、 統合の編集、非アクティブ化、または削除.

次に カスタムアクションを作成する.

詳しくは、Google data actions integration について をご覧ください。

統合を使用するには、1つ以上のMicrosoft Dynamics 365データアクション統合をGenesys Cloud組織に追加します。 複数の統合により、さまざまな構成とデータアクションを使用して、さまざまな Microsoft Dynamics 365 アカウントのデータを操作することができます。 

1. 統合を追加します。 

   [詳細] タブに統合が開きます。 を 詳細 タブを使用すると、統合名を変更したり、統合に関するメモを追加したりできます。 

    メモ：   注記:統合名を変更する場合は、必ず一意の名前を使用して、それを参照するGenesys Cloudアプリケーションの統合と関連するアクションを区別してください。.

2. 資格情報を追加する。 
   1. クリックし、 構成 ] タブ。 
   2. クリック 資格情報 タブ。
   3. クリック 構成.

      [資格情報の構成] ダイアログボックスが表示されます。

   4. 以下の情報を入力してください。
      • ユーザー名: Microsoft Dynamics 365 ログイン ID です。

        ユーザーは、Microsoft Dynamics 365 データ操作の統合で利用できるようにする任意のデータにアクセスできる必要があります。

      • パスワード: Microsoft Dynamics 365 ログイン ID のパスワードです。 
      • ルート組織の Web アドレス: Microsoft Dynamics 365 組織の URL、たとえば、https ://com.
      • アプリケーション ID: Microsoft Dynamics 365 組織の ID。

        アプリケーションIDは、アプリケーション登録を通じて作成されます。マイクロソフト エントラ ID 。詳細については、統合を登録する。

   5.   [OK] をクリックします。
   6. 保存するをクリックします。

      インストールしたすべての統合の一覧が表示されます。

3. 統合を有効化します。
    メモ：   統合を有効にしない場合、統合に関連するデータアクションをテストできません。データアクションはGenesys Cloudアプリケーションに表示されません。
   1. 追加した統合の下で、 ステータス 変更するにはトグル 非 アクティブ 宛先 アクティブ.

      ステータス変更ダイアログボックスが表示されます。

   2. はいをクリックします。

統合がアクティブになりました。 インストールされている統合の編集、非アクティブ化、または削除を行うことができます。 詳細については、 統合の編集、非アクティブ化、または削除.

次に カスタムアクションを作成する または データアクションを使用する.

統合について詳しくは、以下を参照してください。 Microsoft Dynamics 365データアクション統合について。

統合を使用するには、1つ以上のSalesforceデータアクション統合をGenesys Cloud組織に追加します。 複数の統合を使用すると、異なる Salesforce アカウントのデータを操作するために、さまざまな構成とデータアクションを使うことができます。 

1. 統合を追加します。 

   [詳細] タブに統合が開きます。 を 詳細 タブを使用すると、統合名を変更したり、統合に関するメモを追加したりできます。 

    メモ：   注記:統合名を変更する場合は、必ず一意の名前を使用して、それを参照するGenesys Cloudアプリケーションの統合と関連するアクションを区別してください。.

2. 資格情報を追加する。 
   1. クリックし、 構成 ] タブ。 
   2. クリック 資格情報 タブ。
   3. クリック 構成.

      [資格情報の構成] ダイアログボックスが表示されます。

   4. 以下の情報を入力してください。
      • ユーザー名: Salesforce ログイン ID。

        API が有効になっている Salesforce プロファイルを使用し、選択したすべての取引先、サポート案件、および取引先担当者を表示します。 このユーザー(システム管理者が望ましい)は、Genesys Cloudアプリケーションで使用される標準フィールドおよびカスタムフィールドにアクセスできる必要があります。

      • パスワード: Salesforce ログイン ID のパスワード。 
      • セキュリティトークン: Salesforce 組織用に生成された API トークン。

        トークンは AS4DFA9SasdJas2HIasd1asdf のような英数字の文字列です。

      • ログイン URL: API に接続するために使用される Salesforce URL。

        そうしないと、サービスはデフォルトで https://login.salesforce.com になります。 テスト組織を使用します。 https://test.salesforce.com。

         メモ：   Salesforceで有効にするOAuth ユーザー名とパスワードのフローを許可するOAuth および OpenID Connect 設定の設定。詳細については、 Salesforce リリースノート。
   5.   [OK] をクリックします。
   6. 保存するをクリックします。

      インストールしたすべての統合の一覧が表示されます。

3. 統合を有効化します。
    メモ：   統合を有効にしない場合、統合に関連するデータアクションをテストできません。データアクションはGenesys Cloudアプリケーションに表示されません。
   1. 追加した統合の下で、 ステータス 変更するにはトグル 非 アクティブ 宛先 アクティブ.

      ステータス変更ダイアログボックスが表示されます。

   2. はいをクリックします。

統合がアクティブになりました。 インストールされている統合の編集、非アクティブ化、または削除を行うことができます。 詳細については、 統合の編集、非アクティブ化、または削除.

次に カスタムアクションを作成する または データアクションを使用する.

統合について詳しくは、以下を参照してください。 Salesforceデータアクション統合について。

統合を使用するには、Genesys Cloud組織に1つ以上のWebサービスデータアクション統合を追加します。 複数の統合により、さまざまな構成とカスタムアクションを使用して、さまざまな web サービスを通じてデータを操作できます。 

1. 統合を追加します。 

   [詳細] タブに統合が開きます。 を 詳細 タブを使用すると、統合名を変更したり、統合に関するメモを追加したりできます。 

    メモ：   注記:統合名を変更する場合は、必ず一意の名前を使用して、それを参照するGenesys Cloudアプリケーションの統合と関連するアクションを区別してください。.

2. 相互 TLS 証明書を構成します (Web サービスに必要な場合)。
   1. Configuration タブで、Properties を選択する。
   2. 値を選択してください相互 TLS クライアント証明機関。
      クライアント証明書のデフォルトの署名局は Genesys Cloud である。認証局（CA）としてDigiCertを選択することもできる。使用方法GET /api/v2/integrations/actions/certificatesパブリックAPIを使用すると、利用可能な証明書をダウンロードする使用中です。
      メモ: 

      • DigiCertの信頼できる証明書を使用する場合は、毎年の証明書のローテーションを処理する必要があります。シームレスで安全な接続を確保するため。詳細については、相互 TLS (mTLS) 証明書は公的に信頼されていますか?そしてDigiCert 証明書ローテーションアラート。
      • Genesys Cloud証明書を使用する場合、Genesys Cloudは証明書を自動的に更新および更新するルートCAとの信頼関係を確立することをお勧めします。 CAとの信頼関係を確立することで、新しい証明書が利用可能になったときに中断が生じないようにする。 詳細については、 データアクションのmTLSサポート.
3. 資格情報を追加します (web サービスに必要な場合)。
   1. クリックし、 構成 ] タブ。 
   2. クリック 資格情報 タブ。
   3. クリック 構成.

      [資格情報の構成] ダイアログボックスが表示されます。

   4. を選択し 資格情報の種類 資格情報を入力します。 詳細については、 資格情報の種類.
      警告:  統合アクションとパブリッシュアクションを構成した後は、資格情報の種類を変更しないでください。 資格情報の種類を変更すると、使用中のアクションが壊れる可能性があります。 アクティブな統合を新しい資格情報タイプに移行するには、 Genesys Cloudカスタマーケア. 
      • 基本認証
        1. 次の項目の情報を入力します。
           • ユーザー名: Web サービスのログイン ID。
           • パスワード (オプション) : Web サービスログイン ID のパスワード。 
      • ユーザー定義
        1. クリック 資格情報フィールドの追加.
        2. 追加 フィールド名 そして 値.
        3. ユーザー定義のフィールド名と値については、手順 i および ii を繰り返します。

        詳細については、 ユーザー定義資格情報タイプの使用方法。

      • ユーザー定義 (OAuth)
        1. クリック 資格情報フィールドの追加.
        2. 追加 フィールド名 そして 値.
        3. ユーザー定義のフィールド名と値については、手順 i および ii を繰り返します。

        詳細については、 ユーザー定義（OAuth）資格情報の種類を使用する方法 そして ユーザー定義（OAuth）信任状タイプのワークフロー。

   5.   [OK] をクリックします。
   6. 保存するをクリックします。

      インストールしたすべての統合の一覧が表示されます。

4. 統合を有効化します。
    メモ：   統合を有効にしない場合、統合に関連するデータアクションをテストできません。データアクションはGenesys Cloudアプリケーションに表示されません。
   1. 追加した統合の下で、 ステータス 変更するにはトグル 非 アクティブ 宛先 アクティブ.

      ステータス変更ダイアログボックスが表示されます。

   2. はいをクリックします。

統合がアクティブになりました。 インストールされている統合の編集、非アクティブ化、または削除を行うことができます。 詳細については、 統合の編集、非アクティブ化、または削除.

次に カスタムアクションを作成する.

統合について詳しくは、以下を参照してください。 Web サービス データアクションの統合について。

統合を使用するには、1つ以上のZendesk データアクション統合をGenesys Cloud組織に追加します。 複数の統合を使用すると、異なる Zendesk アカウントのデータを操作するために、さまざまな構成とデータアクションを使うことができます。 

1. 統合を追加します。 

   [詳細] タブに統合が開きます。 を 詳細 タブを使用すると、統合名を変更したり、統合に関するメモを追加したりできます。 

    メモ：   注記:統合名を変更する場合は、必ず一意の名前を使用して、それを参照するGenesys Cloudアプリケーションの統合と関連するアクションを区別してください。.

2. 資格情報を追加する。 
   1. クリックし、 構成 ] タブ。 
   2. クリック 資格情報 タブ。
   3. クリック 構成.

      [資格情報の構成] ダイアログボックスが表示されます。

   4. 以下の情報を入力してください。
      • 電子メール: Zendesk ログイン ID。
      • 基本サービス URL: APIへの接続に使用されるZendeskサービスのURL（https：// {subdomain}.zendesk.comの形式）。
      • API トークン: Zendesk 組織用に生成された API トークン。
   5.   [OK] をクリックします。
   6. 保存するをクリックします。

      インストールしたすべての統合の一覧が表示されます。

3. 統合を有効化します。
    メモ：   統合を有効にしない場合、統合に関連するデータアクションをテストできません。データアクションはGenesys Cloudアプリケーションに表示されません。
   1. 追加した統合の下で、 ステータス 変更するにはトグル 非 アクティブ 宛先 アクティブ.

      ステータス変更ダイアログボックスが表示されます。

   2. はいをクリックします。

統合がアクティブになりました。 インストールされている統合の編集、非アクティブ化、または削除を行うことができます。 詳細については、 統合の編集、非アクティブ化、または削除.

次に カスタムアクションを作成する または データアクションを使用する.

統合について詳しくは、以下を参照してください。 Zendeskデータアクション統合について。