说明支持的渠道流类型配置提示 Properties 获取配置文件创建配置文件更新配置文件属性：检查客户细分成员资格获取配置文件对象获取计算的属性将联系人与配置文件关联属性：获取个人资料推荐如何在整个流中保留字段已配置的数据块

Connect Customer 中的流程块：客户档案

本主题定义了检索、创建和更新客户配置文件的流数据块。

说明

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

支持的渠道

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

频道	是否支持？
语音	是
Chat	是
任务	是
电子邮件	是

流类型

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

所有流类型

配置提示

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

Properties

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

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

属性：获取配置文件

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

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

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

示例数据块配置为搜索与来电者的电话号码相匹配或共享存储在名为“账户”的用户定义属性中相同账户号码的配置文件。找到一个个人资料后，以下字段将存储在该特定客户的联系人属性中：回复字段 - AccountNumber FirstName 、LastName、PhoneNumber、和Attributes.LoyaltyPoints。

属性：创建配置文件

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

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

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

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

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

属性：更新配置文件

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

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

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

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

下面显示的区块配置为使用用户输入作为值的 MailingAddress 1 来更新配置文件。更新配置文件时，“MailingAddress1” 响应字段存储在联系人属性中，可供后续区块使用。

属性：检查客户细分成员资格

重要

要使用此操作，您的 Connect 客户实例必须拥有以下 API 的权限： ListSegmentDefinitions GetSegmentMembership BatchGetProfile、、和 BatchGetCalculatedAttributeForProfile 以下任一策略：AmazonConnectServiceLinkedRolePolicy或AmazonConnectServiceCustomerProfileAccess。

重要

如果您正在检查由 Spark SQL 支持的区段的区段成员资格，则选中的区段是创建的最后一个区段，不会实时更新。最后一个 ComputedAt API 属性提供上次创建区段快照的时间。您可以运行新的分段快照来刷新分段。如果您收到 4XX 错误，请确保已创建分段快照。

将属性配置为检查客户细分成员资格时，请考虑以下事项：

必填配置文件 ID：此数据块需要配置文件 ID 才能运行。获取配置文件对象操作会检索与所提供的 ProfileID 关联的对象。确保使用前面的 “获取配置文件” 块提供 ProfileID。使用获取配置文件数据块确定特定的配置文件，然后在后续数据块中检索配置文件的对象。
- 您可以选择手动输入配置文件 ID 或使用存储在预定义的属性或用户属性中的预定义值。
  
  下图显示了配置为获取配置文件，然后检查客户细分成员资格的示例流。

您必须为客户细分提供一个值。您可以选择手动选择客户细分，或使用存储在预定义的属性或用户属性中的预定义值进行动态设置。
动态设置客户细分时，请提供一个引用客户细分的标识符的属性。您可以在 “查看区段详细信息” 页面上找到该标识符，也可以 SegmentDefinitionName 在 “客户档案 API” 中的ListSegmentDefinitions操作中找到该标识符。

下图显示了客户细分 ID 在查看客户细分详细信息页面上的位置。
下图显示了检查客户细分成员身份的示例。配置文件 ID 设置为动态检查，而客户细分设置为手动检查。

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

在客户细分中：配置文件属于客户细分。
不在客户细分中：配置文件不属于客户细分。
错误：尝试检查客户细分成员身份时出错。这可能是由于系统错误或 “检查区段成员资格” 操作的错误配置造成的。要了解有关流错误日志记录的更多信息，请参阅在亚马逊日志组中启用 Connect 客户流 CloudWatch 日志。

属性：获取配置文件对象

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

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

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

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

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

属性：获取计算的属性

重要

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

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

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

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

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

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

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

重要

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

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

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

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

成功：将联系人与配置文件关联。
错误：尝试将联系人与配置文件关联时遇到错误。这可能是由于系统错误或 “关联联系人配置文件” 操作配置错误所致。

以下数据块配置为将存储在联系人属性中带有的配置文件 ID 的配置文件与存储在联系人属性中的当前联系人 ID 关联。

“客户档案” AssociateContactToProfile 区块的属性页面。

属性：获取个人资料推荐

重要

要使用此操作，您的 Connect 客户实例必须具有以下任一策略GetProfileRecommendations中的以下 API 的权限：AmazonConnectServiceLinkedRolePolicy或AmazonConnectServiceCustomerProfileAccess。

有关如何设置和使用 “获取个人资料推荐” 区块的更多详细信息，请参阅第 4 步：在客户互动渠道中使用预测见解。