描述支持的渠道流类型配置提示属性获取配置文件创建配置文件更新配置文件获取配置文件对象获取计算的属性将联系人与配置文件关联如何在整个流中保留字段已配置的数据块

流数据块：客户资料

描述

使您能够检索、创建和更新客户资料。
- 您可以将该数据块配置为使用最多五个您选择的搜索标识符来检索配置文件。
使您能够检索客户配置文件的对象和计算出的属性。
- 您可以将该数据块配置为使用您选择的搜索标识符来检索对象。
- 您必须在此数据块中提供配置文件 ID。您可以手动提供 profileID，也可以在使用获取配置文件操作获得配置文件后使用保存在客户命名空间中的 profileID。
使您能够将联系（例如语音、聊天和任务）与现有客户配置文件相关联。
检索客户配置文件数据时，响应字段存储在该客户的联系人属性中，以便在后续数据块中使用。
您也可以使用以下 JSONPath 来引用响应字段：$.Customer. 例如，$.Customer.City 和 $.Customer.Asset.Status。
以下示例展示了如何使用该数据块：
- 检索配置文件后使用播放提示数据块，通过引用支持的配置文件字段，提供个性化的通话或聊天体验。
- 在检索配置文件数据后使用检查联系人属性数据块，根据该值的条件路由联系人。
- 有关更多信息，请参阅如何在整个流中保留字段。

支持的渠道

下表列出了此数据块如何路由正在使用指定渠道的联系人。

频道	是否支持?
语音	是
聊天	是
任务	是

流类型

您可以在以下流类型中使用此数据块：

所有流类型

配置提示

在使用此数据块之前，请确保您的 Amazon Connect 实例已启用 Customer Profiles。有关说明，请参阅使用 Customer Profiles。
在以下情况中，联系人会被路由到错误分支：
- 您的 Amazon Connect 实例未启用 Customer Profiles。
- 请求数据值无效。请求值不能超过 255 个字符。
- Customer Profiles API 请求受限。
- Customer Profiles 存在可用性问题。
在整个流中，客户配置文件联系人属性的总大小限制为 14,000 个字符（假设每个属性的最大大小为 255，则为 56 个属性）。这包括在流中作为响应字段保留在客户配置文件数据块中的所有值。

属性

客户配置文件流数据块中提供以下属性类型：

获取配置文件
创建配置文件
更新配置文件
获取配置文件对象
获取计算的属性
将联系人与配置文件关联

属性：获取配置文件

将属性配置为获取配置文件时，请注意以下事项：

您必须提供至少一个搜索标识符，总共最多五个。
如果提供了多个搜索标识符，则必须提供一个逻辑运算符，即 AND 或 OR。逻辑运算符将应用于所有搜索标识符，如下所示的表达式之一
- 即（a AND b AND c）
- 即（x OR y OR z）
定义要在后续数据块中保留的属性，将其存储在响应字段下的联系人属性中。
可以将联系人路由到以下分支
- 成功：找到了一个配置文件。响应字段存储在联系人属性中
- 错误：尝试查找配置文件时遇到错误。这可能是由于系统错误或获取配置文件的配置方式所致。
- 找到多个配置文件：找到了多个配置文件。
- 未找到：未找到配置文件。

下图显示了为获取配置文件操作配置的客户配置文件属性页面的示例。

显示的数据块配置为搜索与来电者的电话号码相匹配或共享存储在名为“帐户”的用户定义属性中相同账户号码的配置文件。找到一个配置文件后，“响应” 字段-AccountNumber、FirstName、LastNamePhoneNumber、和 “属性”。 LoyaltyPoints-存储在该特定客户的联系人属性中。

属性：创建配置文件

将属性配置为创建配置文件时，请注意以下事项：

在请求字段中指定要在创建配置文件时填充的属性
定义要在后续数据块中保留的属性，将其存储在响应字段下的联系人属性中。

可以将联系人路由到以下分支：

成功：配置文件已成功创建，响应字段存储在联系人属性中。
错误：创建配置文件过程中出现错误，可能是由于系统错误或创建配置文件操作配置错误所致。

下面显示的区块配置为使用名为 “语言” PhoneNumber的自定义属性创建配置文件。创建配置文件后，Attributes.Language 响应字段存储在联系人属性中，以便在后续数据块中使用。

属性：更新配置文件

将属性配置为更新配置文件时，请注意以下事项：

在使用更新配置文件数据块之前，请使用获取配置文件数据块，如下图所示。使用获取配置文件数据块查找您要更新的特定配置文件。
使用请求字段和请求字段值提供您要更新配置文件的属性和值。
定义要在后续数据块中保留的属性，将其存储在响应字段下的联系人属性中。

可以将联系人路由到以下分支：

成功：配置文件已成功更新，响应字段存储在联系人属性中。
错误：尝试更新配置文件时出错。这可能是由于系统错误或更新配置文件操作配置错误所致。

下面显示的区块配置为以用户输入为值的 “MailingAddress1” 更新配置文件。更新个人资料后，MailingAddress1 响应字段存储在联系人属性中，使其可用于后续区块中。

属性：获取配置文件对象

将属性配置为获取配置文件对象时，请注意以下事项：

必填配置文件 ID：此数据块需要配置文件 ID 才能运行。获取配置文件对象操作会检索与所提供的 ProfileID 关联的对象。确保使用前面的获取配置文件数据块提供 ProfileID，如下图所示。使用获取配置文件数据块确定特定的配置文件，然后在后续数据块中检索配置文件的对象。
- 您可以选择手动输入配置文件 ID 或使用存储在预定义的属性或用户属性中的预定义值。
您必须指明要从中检索信息的对象类型。
您必须从以下选项中选择一个进行对象检索：
- 使用最新的配置文件对象：此选项会始终检索最新的对象。
- 使用搜索标识符：此选项涉及使用提供的搜索标识符搜索和检索对象。
定义要在后续数据块中保留的属性，将其存储在响应字段下的联系人属性中。

可以将联系人路由到以下分支：

成功：成功找到配置文件对象，响应字段存储在联系人属性中。
错误：尝试检索配置文件对象时出错。这可能是由于系统错误或获取配置文件操作配置错误所致。
未找到：未找到对象。

下面显示的块配置为检索与 “客户” 命名空间下ProfileId保存的 “资产” 关联的 “资产” 类型的配置文件对象。在此特定场景中，数据块将使用资产 ID 搜索资产。找到资产后，资产价格和资产。 PurchaseDate存储在联系人属性中，使其可用于后续块。

属性：获取计算的属性

重要

要使用此操作，您的 Amazon Connect 实例必须拥有以下 API 的权限：ListCalculatedAttributeDefinitions以及GetCalculatedAttributeForProfile以下任一政策：AmazonConnectServiceLinkedRolePolicy或AmazonConnectServiceCustomerProfileAccess。

将属性配置为获取计算的属性时，请注意以下事项：

必填配置文件 ID：此数据块需要配置文件 ID 才能运行。获取计算的属性操作会检索与所提供的 ProfileID 关联的对象。确保使用前面的获取配置文件数据块提供 ProfileID，如下图所示。使用获取配置文件数据块确定特定的配置文件，然后在后续数据块中检索配置文件的计算属性。
- 您可以选择手动输入配置文件 ID 或使用存储在预定义的属性或用户属性中的预定义值。
定义要在后续数据块中保留的属性，将其存储在响应字段下的联系人属性中。
- 响应字段下的选项是为您的客户配置文件域定义的计算属性定义
- 如果计算属性的定义使用阈值，则计算的属性值将为布尔值，并返回 True/False。否则，它们将返回一个数字或字符串值。通过使用诸如 “等于”、“大于”、“小于” 和 “包含” 之类的条件，可以将计算属性的返回值用于 “检查联系人属性” 区块中的分支目的。

可以将联系人路由到以下分支：

成功：已找到计算的属性，响应字段存储在联系人属性中。
错误：尝试检索计算的属性时出错。这可能是由于系统错误或获取计算的属性操作配置错误所致。
未找到：未找到计算的属性。

下面显示的区块配置为获取属于联系人属性ProfileId中提供的计算属性。以下响应字段将被检索并存储在联系人属性中：平均通话持续时间和频繁来电者。

属性：将联系人与配置文件关联

重要

要使用此操作，您还必须在安全配置文件中启用“查看客户配置文件”权限。

将属性配置为将联系人与配置文件关联时，请注意以下事项：

在将联系人与配置文件关联前添加获取配置文件数据块，如下图所示。使用获取配置文件数据块先找到配置文件，然后在下一个数据块中将联系人与配置文件关联。
必填配置文件 ID：此数据块需要配置文件 ID 才能运行。确保使用前面的获取配置文件数据块提供 ProfileID，如下图所示。使用获取配置文件数据块在下一个数据块中确定您希望将联系人与之关联的特定配置文件。
- 您可以选择手动输入配置文件 ID 或使用存储在预定义的属性或用户属性中的预定义值。
您必须为联系人 ID 提供一个值。