添加数据操作集成-Genesys 云资源中心

注意： 本文适用于 AWS Lambda、Genesys Cloud、Google、Microsoft Dynamics 365、Salesforce、Web 服务和 Zendesk 数据操作集成。

重要提示：您可以在单个 Genesys Cloud 组织中安装每种集成类型的多个集成。您可以安装的最大集成数量为：

AWS Lambda、Microsoft Dynamics 365、Genesys Cloud 和 Zendesk – 10
Salesforce 和 Web 服务数据操作 – 50
谷歌云 – 100

必备

在您的 AWS 账户中创建的 IAM 资源

要使用集成，请向您的 Genesys Cloud 组织添加一个或多个 AWS Lambda 数据操作集成。多个集成允许您使用不同的配置和自定义操作，通过不同的 AWS Lambda 函数对数据执行操作。

注意： 当您添加多个特定类型的集成时，Genesys Cloud 会通过在每个额外实例的默认名称后添加一个数字来自动使名称唯一。唯一的集成名称区分引用它们的 Genesys Cloud 应用程序中的集成和相关数据操作。

添加集成。
集成将打开到 “详细信息” 选项卡。在 详细信息 选项卡上，您可以更改集成名称并添加有关集成的注释。

注意： 如果更改集成名称，请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。
添加证书
1. 单击配置选项卡。
2. 单击 “ 凭据” 选项卡。
3. 单击 “ 配置”。
  此时将显示 “配置凭据” 对话框。
4. 输入以下信息：
  - 角色 ARN：您的 AWS 账户中有权访问一个或多个 AWS Lambda 函数的角色。此凭证允许 Genesys Cloud 访问和调用与此角色关联的 AWS Lambda 函数。
5. 单击 “ 确定”。
6. 单击 “ 保存”。
  此时将显示已安装的所有集成的列表。
激活集成。
注意： 如果您没有激活集成，则无法测试与集成相关的任何数据操作，并且数据操作将不会显示在 Genesys Cloud 应用程序中。
1. 在刚刚添加的集成下，单击状态开关将其从 “ 不活动” 更改 为 “ 活动”。
  此时将显示 “更改状态” 对话框。
2. 单击 “ 是”。

互动已无效。您可以编辑、停用或删除已安装的集成。有关更多信息，请参阅编辑、停用或删除集成。

接下来，创建自定义操作。

有关集成的更多信息，请参阅关于 AWS Lambda 数据操作集成。

必备

Genesys 云组织中的 Genesys Cloud OAuth 客户端

要使用集成，请向您的 Genesys Cloud 组织添加一个或多个 Genesys Cloud 数据操作集成。通过多种集成，您可以使用不同的配置和数据操作来处理来自平台 API 的数据。

添加集成。
集成将打开到 “详细信息” 选项卡。在 详细信息 选项卡上，您可以更改集成名称并添加有关集成的注释。

注意： 如果更改集成名称，请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。
添加证书
这些凭证使用 Genesys Cloud OAuth 客户端凭证。
1. 单击配置选项卡。
2. 单击 “ 凭据” 选项卡。
3. 单击 “ 配置”。
  此时将显示 “配置凭据” 对话框。
4. 输入以下信息：
  - 客户端 ID： 创建 Genesys Cloud OAuth 客户端时生成的 ID。
  - 客户端机密： 创建 Genesys Cloud OAuth 客户端时生成的密钥。
5. 单击 “ 确定”。
6. 单击 “ 保存”。
  此时将显示已安装的所有集成的列表。
激活集成。
注意： 如果您没有激活集成，则无法测试与集成相关的任何数据操作，并且数据操作将不会显示在 Genesys Cloud 应用程序中。
1. 在刚刚添加的集成下，单击状态开关将其从 “ 不活动” 更改 为 “ 活动”。
  此时将显示 “更改状态” 对话框。
2. 单击 “ 是”。

互动已无效。您可以编辑、停用或删除已安装的集成。有关更多信息，请参阅编辑、停用或删除集成。

接下来，创建自定义操作或使用数据操作。

有关集成的更多信息，请参阅关于 Genesys Cloud 数据操作集成。

要使用集成，请向您的 Genesys Cloud 组织添加一个或多个 Google 数据操作集成。通过多种集成，您可以使用不同的配置和数据操作来处理不同 Google 帐号中的数据。

添加集成。
集成将打开到 “详细信息” 选项卡。在 详细信息 选项卡上，您可以更改集成名称并添加有关集成的注释。

注意： 如果更改集成名称，请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。
添加证书
1. 单击配置选项卡。
2. 单击 “ 凭据” 选项卡。
3. 单击 “ 配置”。
  此时将显示 “配置凭据” 对话框。
4. 为您将用 于此数据操作集成的 Google 应用程序选择 凭据类型。
  - 对于 Google 云平台，请选择 GoogleCloudPlatform 服务帐户。
  - 对于 G Suite，请选择 GoogleSuites 服务帐号。
5. 根据选定的 凭据类型输入以下信 息：
  GoogleCloudPlatform 服务帐户
  客户端 ID： 您的 Google 服务帐号的唯一 ID。还有你的账户生成的 JSON 密钥文件中的 client_id。
  
  客户电子邮件：您的 Google 服务帐号的电子邮件地址。还有你的账户生成的 JSON 密钥文件中的 client_email。
  
  私钥 ID：您的谷歌服务帐号生成的 JSON 密钥文件中的 private_key_id。
  
  私钥：您的谷歌服务帐号生成的 JSON 密钥文件中的 private_key。
  提示：为防止值出现错误，请复制引号之间的全部内容，但不包括引号。操作服务会正确处理其他字符。
  GoogleGSuites 服务账号
  服务帐户电子邮件：您的 Google 服务帐号的电子邮件地址。还有你的账户生成的 JSON 密钥文件中的 client_email。
  
  私钥 ID：您的谷歌服务帐号生成的 JSON 密钥文件中的 private_key_id。
  
  私钥：您的谷歌服务帐号生成的 JSON 密钥文件中的 private_key。
  
  授权范围：应授予集成访问权限的以逗号分隔的范围列表，例如“https://www.googleapis.com/auth/admin.reports.usage.readonly, https://www.googleapis.com/ auth/admin.reports.usage.readonly。”
  有关所需范围的信息，请参阅各个 Google API 文档，例如客户使用情况报告： get 和用户使用情况报告：获取谷歌文档。
  
  冒充用户电子邮件（可选）：集成请求委派访问权限的用户的电子邮件地址。
  注意： 某些引用用户的 API 需要模拟。有关详细信息，请参阅数据操作返回 403 错误。
6. 单击 “ 确定”。
7. 单击 “ 保存”。
  此时将显示已安装的所有集成的列表。
激活集成。
注意： 如果您没有激活集成，则无法测试与集成相关的任何数据操作，并且数据操作将不会显示在 Genesys Cloud 应用程序中。
1. 在刚刚添加的集成下，单击状态开关将其从 “ 不活动” 更改 为 “ 活动”。
  此时将显示 “更改状态” 对话框。
2. 单击 “ 是”。

互动已无效。您可以编辑、停用或删除已安装的集成。有关更多信息，请参阅编辑、停用或删除集成。

接下来，创建自定义操作。

有关更多信息，请参阅关于 Google 数据操作集成。

必备

这整合注册在微软Entra ID

要使用该集成，请向你的 Genesys Cloud 组织添加一个或多个 Microsoft Dynamics 365 数据操作集成。多个集成允许你使用不同的配置和数据操作来处理不同 Microsoft Dynamics 365 帐户中的数据。

添加集成。
集成将打开到 “详细信息” 选项卡。在 详细信息 选项卡上，您可以更改集成名称并添加有关集成的注释。

注意： 如果更改集成名称，请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。
添加证书
1. 单击配置选项卡。
2. 单击 “ 凭据” 选项卡。
3. 单击 “ 配置”。
  此时将显示 “配置凭据” 对话框。
4. 输入以下信息：
  - 用户名： 你的微软 Dynamics 365 登录 ID。
    用户必须能够访问要提供给 Microsoft Dynamics 365 数据操作集成的任何数据。
  - 密码你的微软 Dynamics 365 登录 ID 的密码。
  - 根组织 Web 地址：你的微软 Dynamics 365 组织的 URL，例如 https://contoso.crm.dynamics.com。
  - 应用程序标签 你的微软 Dynamics 365 组织的 ID。
    应用程序 ID 是通过在微软Entra ID 。有关详细信息，请参阅For more information, see注册集成。
5. 单击 “ 确定”。
6. 单击 “ 保存”。
  此时将显示已安装的所有集成的列表。
激活集成。
注意： 如果您没有激活集成，则无法测试与集成相关的任何数据操作，并且数据操作将不会显示在 Genesys Cloud 应用程序中。
1. 在刚刚添加的集成下，单击状态开关将其从 “ 不活动” 更改 为 “ 活动”。
  此时将显示 “更改状态” 对话框。
2. 单击 “ 是”。

互动已无效。您可以编辑、停用或删除已安装的集成。有关更多信息，请参阅编辑、停用或删除集成。

接下来，创建自定义操作或使用数据操作。

有关集成的详细信息，请参阅关于 Microsoft Dynamics 365 数据操作集成。

要使用该集成，请向 Genesys Cloud 组织添加一个或多个 Salesforce 数据操作集成。多种集成允许您使用不同的配置和数据操作来处理不同 Salesforce 帐户中的数据。

添加集成。
集成将打开到 “详细信息” 选项卡。在 详细信息 选项卡上，您可以更改集成名称并添加有关集成的注释。

注意： 如果更改集成名称，请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。
添加证书
1. 单击配置选项卡。
2. 单击 “ 凭据” 选项卡。
3. 单击 “ 配置”。
  此时将显示 “配置凭据” 对话框。
4. 输入以下信息：
  - 用户名： 您的 Salesforce 登录 ID。
    使用已为账户、案例和联系人选择了 “启用 API” 并选择了 “查看全部” 的 Salesforce 配置文件。此用户（最好是系统管理员）必须能够访问 Genesys Cloud 应用程序中使用的任何标准和自定义字段。
  - 密码您的 Salesforce 登录 ID 的密码。
  - 安全令牌：为 Salesforce 组织生成的 API 令牌。
    令牌是一个字母数字字符串，如 as4dfa9sasdjas2Hiasd1ASD1asDdf。
  - 登录网址：用于连接到 API 的 Salesforce URL。
    该服务默认为 https://login.salesforce.com。对于测试组织，请选择 https://test.salesforce.com。
    
    注意： 在 Salesforce 中，启用允许 OAuth 用户名-密码流程OAuth 和 OpenID Connect 设置中的设置。有关详细信息，请参阅For more information, see Salesforce 发行说明。
5. 单击 “ 确定”。
6. 单击 “ 保存”。
  此时将显示已安装的所有集成的列表。
激活集成。
注意： 如果您没有激活集成，则无法测试与集成相关的任何数据操作，并且数据操作将不会显示在 Genesys Cloud 应用程序中。
1. 在刚刚添加的集成下，单击状态开关将其从 “ 不活动” 更改 为 “ 活动”。
  此时将显示 “更改状态” 对话框。
2. 单击 “ 是”。

互动已无效。您可以编辑、停用或删除已安装的集成。有关更多信息，请参阅编辑、停用或删除集成。

接下来，创建自定义操作或使用数据操作。

有关集成的更多信息，请参阅关于 Salesforce 数据操作集成。

要使用该集成，请向 Genesys Cloud 组织添加一个或多个 Web 服务数据操作集成。多种集成允许您使用不同的配置和自定义操作，通过不同的 Web 服务对数据进行操作。

添加集成。
集成将打开到 “详细信息” 选项卡。在 详细信息 选项卡上，您可以更改集成名称并添加有关集成的注释。

注意： 如果更改集成名称，请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。
配置相互 TLS 证书（如果 Web 服务需要）。
1. 上配置选项卡，选择特性。
2. 选择值相互 TLS 客户端证书颁发机构。
  客户端证书的默认签名机构是 Genesys Cloud。您也可以选择 DigiCert 作为证书颁发机构 (CA)。使用获取 /api/v2/integrations/actions/certificates公共API，你可以下载可用的证书正在使用。
  注释：
  - 如果您使用 DigiCert 可信证书，则必须处理年度证书轮换确保无缝、安全的连接。有关更多信息，请参阅相互 TLS (mTLS) 证书是否受到公开信任？。
  - 如果您使用 Genesys Cloud 证书，则 Genesys Cloud 建议与根 CA 建立信任关系，根 CA 会自动续订和更新证书。与 CA 建立信任关系可确保新证书可用时不会出现中断。有关更多信息，请参阅 MTL 对数据操作的支持。
添加凭据（如果 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. 单击 “ 确定”。
6. 单击 “ 保存”。
  此时将显示已安装的所有集成的列表。
激活集成。
注意： 如果您没有激活集成，则无法测试与集成相关的任何数据操作，并且数据操作将不会显示在 Genesys Cloud 应用程序中。
1. 在刚刚添加的集成下，单击状态开关将其从 “ 不活动” 更改 为 “ 活动”。
  此时将显示 “更改状态” 对话框。
2. 单击 “ 是”。

互动已无效。您可以编辑、停用或删除已安装的集成。有关更多信息，请参阅编辑、停用或删除集成。

接下来，创建自定义操作。

有关集成的详细信息，请参阅关于 Web 服务数据操作集成。

要使用该集成，请向您的 Genesys Cloud 组织添加一个或多个 Zendesk 数据操作集成。多种集成允许您使用不同的配置和数据操作来处理不同 Zendesk 账户中的数据。

添加集成。
集成将打开到 “详细信息” 选项卡。在 详细信息 选项卡上，您可以更改集成名称并添加有关集成的注释。

注意： 如果更改集成名称，请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。
添加证书
1. 单击配置选项卡。
2. 单击 “ 凭据” 选项卡。
3. 单击 “ 配置”。
  此时将显示 “配置凭据” 对话框。
4. 输入以下信息：
  - 电子邮件地址： 您的 Zendesk 登录 ID。
  - 基本服务 URL：用于连接到 API 的 Zendesk 服务的 URL，格式为 https://{subdomain}.zendesk.com。
  - API 令牌：为您的 Zendesk 组织生成的 API 令牌。
5. 单击 “ 确定”。
6. 单击 “ 保存”。
  此时将显示已安装的所有集成的列表。
激活集成。
注意： 如果您没有激活集成，则无法测试与集成相关的任何数据操作，并且数据操作将不会显示在 Genesys Cloud 应用程序中。
1. 在刚刚添加的集成下，单击状态开关将其从 “ 不活动” 更改 为 “ 活动”。
  此时将显示 “更改状态” 对话框。
2. 单击 “ 是”。

互动已无效。您可以编辑、停用或删除已安装的集成。有关更多信息，请参阅编辑、停用或删除集成。

接下来，创建自定义操作或使用数据操作。

有关集成的更多信息，请参阅关于 Zendesk 数据操作集成。

添加数据操作集成

GoogleCloudPlatform 服务帐户

GoogleGSuites 服务账号