本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Amazon Connect 流数据块：Customer Profiles
本主题定义了检索、创建和更新客户配置文件的流数据块。
## 说明
+ 使您能够检索、创建和更新客户资料。
+ 您可以将该数据块配置为使用最多五个您选择的搜索标识符来检索配置文件。
+ 使您能够检索客户配置文件的对象和计算出的属性。
+ 您可以将该数据块配置为使用您选择的搜索标识符来检索对象。
+ 您必须在此数据块中提供配置文件 ID。您可以手动提供 **profileID**，也可以在使用**获取配置文件**操作获得配置文件后使用保存在客户命名空间中的 **profileID**。
+ 使您能够将联系（例如语音、聊天和任务）与现有客户配置文件相关联。
+ 检索客户配置文件数据时，**响应字段**存储在[该客户的联系人属性中](connect-attrib-list.md#customer-profiles-attributes)，以便在后续数据块中使用。
+ 您也可以使用以下方法引用 “**响应” 字段** JSONPath：`$.Customer.`例如，`$.Customer.City`和`$.Customer.Asset.Status`。
+ 以下示例展示了如何使用该数据块：
+ 检索配置文件后使用[播放提示](play.md)数据块，通过引用支持的配置文件字段，提供个性化的通话或聊天体验。
+ 在检索配置文件数据后使用[检查联系属性](check-contact-attributes.md)数据块，根据该值的条件路由联系人。
+ 有关更多信息，请参阅[如何在整个流中保留字段](#customer-profiles-block-persist-fields)。
## 支持的渠道
下表列出了此数据块如何路由正在使用指定渠道的联系人。
| 频道 | 是否支持？ |
| --- | --- |
| 语音 | 是 |
| Chat | 是 |
| 任务 | 是 |
| 电子邮件 | 是 |
## 流类型
您可以在以下[流类型](create-contact-flow.md#contact-flow-types)中使用此数据块：
+ 所有流类型
## 配置提示
+ 在使用此数据块之前，请确保您的 Amazon Connect 实例已启用 Customer Profiles。有关说明，请参阅[使用 Amazon Connect Customer Profiles](customer-profiles.md)。
+ 在以下情况中，联系人会被路由到**错误**分支：
+ 您的 Amazon Connect 实例未启用 Customer Profiles。
+ 请求数据值无效。请求值不能超过 255 个字符。
+ Customer Profiles API 请求受限。
+ Customer Profiles 存在可用性问题。
+ 在整个流中，[客户配置文件联系人属性](connect-attrib-list.md#customer-profiles-attributes)的总大小限制为 14,000 个字符（假设每个属性的最大大小为 255，则为 56 个属性）。这包括在流中作为**响应字段**保留在客户配置文件数据块中的所有值。
## Properties
客户配置文件流数据块中提供以下属性类型：
+ **[获取配置文件](#customer-profiles-block-properties-get-profile)**
+ **[创建配置文件](#customer-profiles-block-properties-create-profile)**
+ **[更新配置文件](#customer-profiles-block-properties-update-profile)**
+ **[获取配置文件对象](#customer-profiles-block-properties-get-profile-object)**
+ **[获取计算的属性](#customer-profiles-block-properties-get-calculated-attributes)**
+ **[将联系人与配置文件关联](#customer-profiles-block-properties-associate.title)**
## 属性：获取配置文件
将属性配置为**获取配置文件**时，请注意以下事项：
+ 您必须提供至少一个搜索标识符，总共最多五个。
+ 如果提供了多个搜索标识符，则必须提供一个逻辑运算符，即 **AND** 或 **OR**。逻辑运算符应用于所有搜索标识符，如以下表达式之一所示：
+ （a **AND** b **AND** c）
+ （x **OR** y **OR** z）
+ 定义要在后续数据块中保留的属性，将其存储在**响应字段**下的联系人属性中。
+ 可以将联系人路由到以下分支
+ **成功：**找到了一个配置文件。响应字段存储在联系人属性中
+ **错误：**尝试查找配置文件时遇到错误。这可能是由于系统错误或**获取配置文件**的配置方式所致。
+ **找到多个配置文件：**找到了多个配置文件。
+ **未找到：**未找到配置文件。
下图显示了为**获取配置文件**操作配置的客户配置文件**属性**页面的示例。
示例数据块配置为搜索与来电者的**电话**号码相匹配或共享存储在名为“账户”的用户定义属性中相同**账户**号码的配置文件。找到一个个人资料后，以下字段将存储在该特定客户的联系人属性中：“**回应” 字段**-**AccountNumber**、**FirstName**LastName**PhoneNumber******、和 **“属性”。 LoyaltyPoints**。
## 属性：创建配置文件
将属性配置为**创建配置文件**时，请注意以下事项：
+ 在**请求字段**中指定要在创建配置文件时填充的属性
+ 定义要在后续数据块中保留的属性，将其存储在**响应字段**下的联系人属性中。
可以将联系人路由到以下分支：
+ **成功：**配置文件已成功创建，**响应字段**存储在联系人属性中。
+ **错误：**创建配置文件过程中出现错误，可能是由于系统错误或**创建配置文件**操作配置错误所致。
以下示例块配置为使用名为 “语言” **PhoneNumber**的自定义属性创建配置文件。创建配置文件后，**Attributes.Language** 响应字段存储在联系人属性中，以便在后续数据块中使用。
## 属性：更新配置文件
将属性配置为**更新配置文件**时，请注意以下事项：
+ 在使用**更新配置文件**数据块之前，请使用**获取配置文件**数据块，如下图所示。使用**获取配置文件**数据块查找您要更新的特定配置文件。
+ 使用**请求字段**和**请求字段值**提供您要更新配置文件的属性和值。
+ 定义要在后续数据块中保留的属性，将其存储在**响应字段**下的联系人属性中。
可以将联系人路由到以下分支：
+ **成功：**配置文件已成功更新，**响应字段**存储在联系人属性中。
+ **错误：**尝试更新配置文件时出错。这可能是由于系统错误或**更新配置文件**操作配置错误所致。
下面显示的区块配置为以用户输入为值的 “**MailingAddress1**” 更新配置文件。更新个人资料后，**MailingAddress1** 响应字段存储在联系人属性中，使其可用于后续区块中。
## 属性：检查客户细分成员资格
**重要**
要使用此操作，您的 Amazon Connect 实例必须具有以下任意一项的权限 APIs： ListSegmentDefinitions GetSegmentMembership BatchGetProfile、、，以及 BatchGetCalculatedAttributeForProfile 以下任一政策：**AmazonConnectServiceLinkedRolePolicy**或**AmazonConnectServiceCustomerProfileAccess**。
**重要**
如果您正在检查由 Spark SQL 支持的区段的区段成员资格，则所检查的区段是上次创建且未实时更新的区段。 lastComputedAt API 属性提供了上次创建区段快照的时间。您可以运行新的区段快照来刷新区段。如果您收到 4XX 错误，请确保您已创建区段快照。
将属性配置为**检查客户细分成员资格**时，请考虑以下事项：
+ **必填配置文件 ID：**此数据块需要配置文件 ID 才能运行。**获取配置文件对象**操作会检索与所提供的 **ProfileID** 关联的对象。确保使用前面的**获取配置文件**数据块提供 **ProfileID**。使用**获取配置文件**数据块确定特定的配置文件，然后在后续数据块中检索配置文件的对象。
+ 您可以选择手动输入配置文件 ID 或使用存储在预定义的属性或用户属性中的预定义值。
下图显示了配置为获取配置文件，然后检查客户细分成员资格的示例流。
+ 您必须为客户细分提供一个值。您可以选择手动选择客户细分，或使用存储在预定义的属性或用户属性中的预定义值进行动态设置。
+ 动态设置客户细分时，请提供一个引用客户细分的标识符的属性。您可以在**查看细分详情**页面或客户资料 API SegmentDefinitionName 中的[ListSegmentDefinitions](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListSegmentDefinitions.html)操作中找到该标识符。
下图显示了**客户细分 ID** 在**查看客户细分详细信息**页面上的位置。
+ 下图显示了检查客户细分成员身份的示例。**配置文件 ID** 设置为动态检查，而**客户细分**设置为手动检查。
**可以将联系人路由到以下分支**
+ **在客户细分中**：配置文件属于客户细分。
+ **不在客户细分中**：配置文件不属于客户细分。
+ **错误**：尝试检查客户细分成员身份时出错。这可能是由于系统错误或**检查客户细分成员身份**操作的配置错误所致。要了解有关流错误日志记录的更多信息，请参阅[在亚马逊日志组中启用 Amazon Connect 流 CloudWatch 日志](contact-flow-logs.md)。
## 属性：获取配置文件对象
将属性配置为**获取配置文件对象**时，请注意以下事项：
+ **必填配置文件 ID：**此数据块需要配置文件 ID 才能运行。**获取配置文件对象**操作会检索与所提供的 **ProfileID** 关联的对象。确保使用前面的**获取配置文件**数据块提供 **ProfileID**，如下图所示。使用**获取配置文件**数据块确定特定的配置文件，然后在后续数据块中检索配置文件的对象。
+ 您可以选择手动输入配置文件 ID 或使用存储在预定义的属性或用户属性中的预定义值。
+ 您必须指明要从中检索信息的对象类型。
+ 您必须从以下选项中选择一个进行对象检索：
+ **使用最新的配置文件对象：**此选项会始终检索最新的对象。
+ **使用搜索标识符：**此选项涉及使用提供的搜索标识符搜索和检索对象。
+ 定义要在后续数据块中保留的属性，将其存储在**响应字段**下的联系人属性中。
可以将联系人路由到以下分支：
+ **成功：**成功找到配置文件对象，**响应字段**存储在联系人属性中。
+ **错误：**尝试检索配置文件对象时出错。这可能是由于系统错误或**获取配置文件**操作配置错误所致。
+ **未找到：**未找到对象。
下面显示的块配置为检索与 “客户” 命名空间下**ProfileId**保存的 “资产” 关联的 “资产” 类型的配置文件对象。在此特定场景中，数据块将使用资产 ID 搜索资产。**找到资产后，**资产价格和资产。** PurchaseDate**存储在联系人属性中，使其可用于后续块。
## 属性：获取计算的属性
**重要**
要使用此操作，您的 Amazon Connect 实例必须拥有以下任意一项的权限 APIs：`ListCalculatedAttributeDefinitions`和`GetCalculatedAttributeForProfile`以下任一政策：**AmazonConnectServiceLinkedRolePolicy**或**AmazonConnectServiceCustomerProfileAccess**。
将属性配置为**获取计算的属性**时，请注意以下事项：
+ **必填配置文件 ID：**此数据块需要配置文件 ID 才能运行。**获取计算的属性**操作会检索与所提供的 **ProfileID** 关联的对象。确保使用前面的**获取配置文件**数据块提供 **ProfileID**，如下图所示。使用**获取配置文件**数据块确定特定的配置文件，然后在后续数据块中检索配置文件的计算属性。
+ 您可以选择手动输入配置文件 ID 或使用存储在预定义的属性或用户属性中的预定义值。
+ 定义要在后续数据块中保留的属性，将其存储在**响应字段**下的联系人属性中。
+ **响应字段**下的选项是为您的客户配置文件域定义的计算属性定义
+ 如果计算属性的定义使用阈值，则计算的属性值将为布尔值，并返回 True/False。否则，它们将返回一个数字或字符串值。在**检查联系人属性**数据块中，可使用**等于**、**大于**、**小于**和**包含**等条件，利用计算的属性的返回值来添加分支。
可以将联系人路由到以下分支：
+ **成功：**已找到计算的属性，响应字段存储在联系人属性中。
+ **错误：**尝试检索计算的属性时出错。这可能是由于系统错误或**获取计算的属性**操作配置错误所致。
+ **未找到：**未找到计算的属性。
下面显示的区块配置为获取属于联系人属性**ProfileId**中提供的计算属性。以下**响应字段**将被检索并存储在联系人属性中：**平均通话持续时间**和**频繁来电者**。
## 属性：将联系人与配置文件关联
**重要**
要使用此操作，您的 Amazon Connect 实例必须拥有以下任意一项的权限 APIs：`ListCalculatedAttributeDefinitions`和`GetCalculatedAttributeForProfile`以下任一政策：**AmazonConnectServiceLinkedRolePolicy**或**AmazonConnectServiceCustomerProfileAccess**。
要使用此操作，您还必须在安全配置文件中启用“查看客户配置文件”权限。
将属性配置为**将联系人与配置文件关联**时，请注意以下事项：
+ 在**将联系人与配置文件关联**前添加**获取配置文件**数据块，如下图所示。使用**获取配置文件**数据块先找到配置文件，然后在下一个数据块中将联系人与配置文件关联。
+ **必填配置文件 ID：**此数据块需要配置文件 ID 才能运行。确保使用前面的**获取配置文件**数据块提供 **ProfileID**，如下图所示。使用**获取配置文件**数据块在下一个数据块中确定您希望将联系人与之关联的特定配置文件。
+ 您可以选择手动输入配置文件 ID 或使用存储在预定义的属性或用户属性中的预定义值。
+ 您必须为联系人 ID 提供一个值。
可以将联系人路由到以下分支：
+ **成功：**将联系人与配置文件关联。
+ **错误：**尝试将联系人与配置文件关联时遇到错误。这可能是由于系统错误或**将联系人与配置文件关联**操作配置错误所致。
以下数据块配置为将存储在联系人属性中带有的**配置文件 ID** 的配置文件与存储在联系人属性中的当前联系人 ID 关联。
## 属性：获取个人资料推荐
**重要**
要使用此操作，您的 Amazon Connect 实例必须拥有以下 API 的权限：`GetProfileRecommendations`在以下任一政策中：**AmazonConnectServiceLinkedRolePolicy**或**AmazonConnectServiceCustomerProfileAccess**。
有关如何设置和使用 “**获取个人资料推荐**” 区块的更多详细信息，请参阅[第 4 步：在客户互动渠道中使用预测性见解](predictive-insights-get-started.md#use-across-customer-engagement-channels)。
## 如何在整个流中保留字段
假设您希望客户在不直接与座席沟通的情况下与您的联系中心互动并了解其交付订单的状态。此外，假设您要优先处理之前延迟超过 10 分钟的客户来电。
在这些情况下，IVR 需要获取有关客户的相关信息。这是通过“客户配置文件”数据块实现的。其次，IVR 需要在其他流数据块中利用这些客户数据，以便为客户提供个性化体验和主动服务。
1. 使用**播放提示**，通过姓名来问候客户并告知他们的状态来实现个性化体验。
1. 使用**检查联系人属性**，根据客户在以前交互中的“平均等待时间”有条件地路由客户
## 已配置的数据块
下图显示了该数据块已配置好的样子。它显示了四个分支：**成功**、**错误**、**找到多个**和**未找到**。
