添加数据操作集成
- AWS Lambda、Microsoft Dynamics 365、Genesys Cloud 和 Zendesk – 10
- Salesforce 和 Web 服务数据操作 – 50
- 谷歌云 – 100
要使用集成,请向您的 Genesys Cloud 组织添加一个或多个 AWS Lambda 数据操作集成。 多个集成允许您使用不同的配置和自定义操作,通过不同的 AWS Lambda 函数对数据执行操作。
- 添加集成。
集成将打开到 “详细信息” 选项卡。 在 详细信息 选项卡上,您可以更改集成名称并添加有关集成的注释。
注意: 如果更改集成名称,请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。 - 添加证书
- 单击配 置 选项卡。
- 单击 “ 凭据” 选项卡。
- 单击 “ 配置”。
此时将显示 “配置凭据” 对话框。
- 输入以下信息:
- 角色 ARN: 您的 AWS 账户中有权访问一个或多个 AWS Lambda 函数的角色。 此凭证允许 Genesys Cloud 访问和调用与此角色关联的 AWS Lambda 函数。
- 单击 “ 确定”。
- 单击 “ 保存”。
此时将显示已安装的所有集成的列表。
- 激活集成。注意: 如果您没有激活集成,则无法测试与集成相关的任何数据操作,并且数据操作将不会显示在 Genesys Cloud 应用程序中。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
此时将显示 “更改状态” 对话框。
- 单击 “ 是”。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
互动已无效。 您可以编辑、停用或删除已安装的集成。 有关更多信息,请参阅 编辑、停用或删除集成。
接下来, 创建自定义操作。
有关集成的更多信息,请参阅 关于 AWS Lambda 数据操作集成。
必备
- Genesys 云组织 中的 Genesys Cloud OAuth 客户端
要使用集成,请向您的 Genesys Cloud 组织添加一个或多个 Genesys Cloud 数据操作集成。 通过多种集成,您可以使用不同的配置和数据操作来处理来自平台 API 的数据。
- 添加集成。
集成将打开到 “详细信息” 选项卡。 在 详细信息 选项卡上,您可以更改集成名称并添加有关集成的注释。
注意: 如果更改集成名称,请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。 - 添加证书
这些凭证使用 Genesys Cloud OAuth 客户端凭证。
- 单击配 置 选项卡。
- 单击 “ 凭据” 选项卡。
- 单击 “ 配置”。
此时将显示 “配置凭据” 对话框。
- 输入以下信息:
- 客户端 ID: 创建 Genesys Cloud OAuth 客户端时生成的 ID。
- 客户端机密: 创建 Genesys Cloud OAuth 客户端时生成的密钥。
- 单击 “ 确定”。
- 单击 “ 保存”。
此时将显示已安装的所有集成的列表。
- 激活集成。注意: 如果您没有激活集成,则无法测试与集成相关的任何数据操作,并且数据操作将不会显示在 Genesys Cloud 应用程序中。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
此时将显示 “更改状态” 对话框。
- 单击 “ 是”。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
互动已无效。 您可以编辑、停用或删除已安装的集成。 有关更多信息,请参阅 编辑、停用或删除集成。
有关集成的更多信息,请参阅 关于 Genesys Cloud 数据操作集成。
要使用集成,请向您的 Genesys Cloud 组织添加一个或多个 Google 数据操作集成。 通过多种集成,您可以使用不同的配置和数据操作来处理不同 Google 帐号中的数据。
- 添加集成。
集成将打开到 “详细信息” 选项卡。 在 详细信息 选项卡上,您可以更改集成名称并添加有关集成的注释。
注意: 如果更改集成名称,请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。 - 添加证书
- 单击配 置 选项卡。
- 单击 “ 凭据” 选项卡。
- 单击 “ 配置”。
此时将显示 “配置凭据” 对话框。
- 为您将用 于此数据操作集成的 Google 应用程序选择 凭据类型。
- 对于 Google 云平台,请选择 GoogleCloudPlatform 服务帐户。
- 对于 G Suite,请选择 GoogleSuites 服务帐号。
- 根据选定的 凭据类型输入以下信 息:
- 客户端 ID: 您的 Google 服务帐号的唯一 ID。 还有你的账户生成的 JSON 密钥文件中的 client_id。
- 客户电子邮件: 您的 Google 服务帐号的电子邮件地址。 还有你的账户生成的 JSON 密钥文件中的 client_email。
- 私钥 ID: 您的谷歌服务帐号生成 的 JSON 密钥文件中的 private_key_id。
- 私钥: 您的谷歌服务帐号生成的 JSON 密钥文件 中的 private_key。 提示: 为防止值出现错误,请复 制引号之间的全部内容,但不包括引号。 操作服务会正确处理其他字符。
- 服务帐户电子邮件: 您的 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 错误。
- 单击 “ 确定”。
- 单击 “ 保存”。
此时将显示已安装的所有集成的列表。
- 激活集成。注意: 如果您没有激活集成,则无法测试与集成相关的任何数据操作,并且数据操作将不会显示在 Genesys Cloud 应用程序中。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
此时将显示 “更改状态” 对话框。
- 单击 “ 是”。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
互动已无效。 您可以编辑、停用或删除已安装的集成。 有关更多信息,请参阅 编辑、停用或删除集成。
接下来, 创建自定义操作。
有关更多信息,请参阅关于 Google 数据操作集成。
必备
- 这整合注册在微软Entra ID
要使用该集成,请向你的 Genesys Cloud 组织添加一个或多个 Microsoft Dynamics 365 数据操作集成。 多个集成允许你使用不同的配置和数据操作来处理不同 Microsoft Dynamics 365 帐户中的数据。
- 添加集成。
集成将打开到 “详细信息” 选项卡。 在 详细信息 选项卡上,您可以更改集成名称并添加有关集成的注释。
注意: 如果更改集成名称,请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。 - 添加证书
- 单击配 置 选项卡。
- 单击 “ 凭据” 选项卡。
- 单击 “ 配置”。
此时将显示 “配置凭据” 对话框。
- 输入以下信息:
- 用户名: 你的微软 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注册集成。
- 用户名: 你的微软 Dynamics 365 登录 ID。
- 单击 “ 确定”。
- 单击 “ 保存”。
此时将显示已安装的所有集成的列表。
- 激活集成。注意: 如果您没有激活集成,则无法测试与集成相关的任何数据操作,并且数据操作将不会显示在 Genesys Cloud 应用程序中。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
此时将显示 “更改状态” 对话框。
- 单击 “ 是”。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
互动已无效。 您可以编辑、停用或删除已安装的集成。 有关更多信息,请参阅 编辑、停用或删除集成。
有关集成的详细信息,请参阅 关于 Microsoft Dynamics 365 数据操作集成。
要使用该集成,请向 Genesys Cloud 组织添加一个或多个 Salesforce 数据操作集成。 多种集成允许您使用不同的配置和数据操作来处理不同 Salesforce 帐户中的数据。
- 添加集成。
集成将打开到 “详细信息” 选项卡。 在 详细信息 选项卡上,您可以更改集成名称并添加有关集成的注释。
注意: 如果更改集成名称,请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。 - 添加证书
- 单击配 置 选项卡。
- 单击 “ 凭据” 选项卡。
- 单击 “ 配置”。
此时将显示 “配置凭据” 对话框。
- 输入以下信息:
- 用户名: 您的 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 发行说明。
- 用户名: 您的 Salesforce 登录 ID。
- 单击 “ 确定”。
- 单击 “ 保存”。
此时将显示已安装的所有集成的列表。
- 激活集成。注意: 如果您没有激活集成,则无法测试与集成相关的任何数据操作,并且数据操作将不会显示在 Genesys Cloud 应用程序中。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
此时将显示 “更改状态” 对话框。
- 单击 “ 是”。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
互动已无效。 您可以编辑、停用或删除已安装的集成。 有关更多信息,请参阅 编辑、停用或删除集成。
有关集成的更多信息,请参阅 关于 Salesforce 数据操作集成。
要使用该集成,请向 Genesys Cloud 组织添加一个或多个 Web 服务数据操作集成。 多种集成允许您使用不同的配置和自定义操作,通过不同的 Web 服务对数据进行操作。
- 添加集成。
集成将打开到 “详细信息” 选项卡。 在 详细信息 选项卡上,您可以更改集成名称并添加有关集成的注释。
注意: 如果更改集成名称,请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。 - 配置相互 TLS 证书(如果 Web 服务需要)。
- 上配置选项卡,选择特性。
- Select the value for Mutual TLS Client Certificate Authority.
The default signing authority of the client certificate is Genesys Cloud. You can also select DigiCert as the Certificate Authority (CA). Using theGET /api/v2/integrations/actions/certificates
public API, you can download the available certificates in use.注释:- 如果您使用 DigiCert 可信证书,则必须处理年度证书轮换确保无缝、安全的连接。 有关更多信息,请参阅相互 TLS (mTLS) 证书是否受到公开信任? 。
- 如果您使用 Genesys Cloud 证书,则 Genesys Cloud 建议与根 CA 建立信任关系,根 CA 会自动续订和更新证书。 与 CA 建立信任关系可确保新证书可用时不会出现中断。 有关更多信息,请参阅 MTL 对数据操作的支持。
- 添加凭据(如果 Web 服务需要)。
- 单击配 置 选项卡。
- 单击 “ 凭据” 选项卡。
- 单击 “ 配置”。
此时将显示 “配置凭据” 对话框。
- 选择 凭据类型 并输入凭据信息。 有关更多信息,请参阅 凭据类型。
警告: 配置集成和发布操作后,请勿更改凭据类型。 更改凭据类型可能会中断正在使用的任何操作。 要将活动集成迁移到新的凭证类型,请联系 Genesys Cloud 客户关怀团队。
- 基本验证
- 输入以下项目的信息:
- 用户名: 您的 Web 服务登录 ID。
- 密码 (可选): Web 服务登录 ID 的密码。
- 输入以下项目的信息:
- 用户定义的
- 单击 添加凭据字段。
- 添加 字段名称 和 值。
- 重复步骤 i 和 ii 以获取更多用户定义的字段名称和值。
有关更多信息,请参阅 如何使用用户定义的凭据类型。
- 用户定义的 (OAuth)
- 单击 添加凭据字段。
- 添加 字段名称 和 值。
- 重复步骤 i 和 ii 以获取更多用户定义的字段名称和值。
有关更多信息,请参阅 如何使用用户定义 (OAuth) 凭据类型 和用户定义 (OAuth) 凭据类型的 工作流。
- 基本验证
- 单击 “ 确定”。
- 单击 “ 保存”。
此时将显示已安装的所有集成的列表。
- 激活集成。注意: 如果您没有激活集成,则无法测试与集成相关的任何数据操作,并且数据操作将不会显示在 Genesys Cloud 应用程序中。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
此时将显示 “更改状态” 对话框。
- 单击 “ 是”。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
互动已无效。 您可以编辑、停用或删除已安装的集成。 有关更多信息,请参阅 编辑、停用或删除集成。
接下来, 创建自定义操作。
有关集成的详细信息,请参阅 关于 Web 服务数据操作集成。
要使用该集成,请向您的 Genesys Cloud 组织添加一个或多个 Zendesk 数据操作集成。 多种集成允许您使用不同的配置和数据操作来处理不同 Zendesk 账户中的数据。
- 添加集成。
集成将打开到 “详细信息” 选项卡。 在 详细信息 选项卡上,您可以更改集成名称并添加有关集成的注释。
注意: 如果更改集成名称,请确保使用唯一的名称来区分引用它们的 Genesys Cloud 应用程序中的集成和相关操作。 - 添加证书
- 单击配 置 选项卡。
- 单击 “ 凭据” 选项卡。
- 单击 “ 配置”。
此时将显示 “配置凭据” 对话框。
- 输入以下信息:
- 电子邮件地址: 您的 Zendesk 登录 ID。
- 基本服务 URL: 用于连接到 API 的 Zendesk 服务的 URL,格式为 https://{subdomain}.zendesk.com。
- API 令牌: 为您的 Zendesk 组织生成的 API 令牌。
- 单击 “ 确定”。
- 单击 “ 保存”。
此时将显示已安装的所有集成的列表。
- 激活集成。注意: 如果您没有激活集成,则无法测试与集成相关的任何数据操作,并且数据操作将不会显示在 Genesys Cloud 应用程序中。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
此时将显示 “更改状态” 对话框。
- 单击 “ 是”。
- 在刚刚添加的集成下,单击 状态 开关将其从 “ 不活动” 更改 为 “ 活动”。
互动已无效。 您可以编辑、停用或删除已安装的集成。 有关更多信息,请参阅 编辑、停用或删除集成。
有关集成的更多信息,请参阅 关于 Zendesk 数据操作集成。