流数据块：设置联系人属性

描述

将键值对存储为联系人属性。您设置了一个稍后在流中引用的值。

例如，基于客户账户类型，为路由到队列的客户创建个性化的问候语。也可以为公司名或业务线定义一个属性，以包括在说给客户听的“文本到语音转换”字符串中。

设置联系人属性数据块非常有用，例如，可用于将从外部源检索的属性复制到用户定义的属性。

有关联系人属性的更多信息，请参阅使用 Amazon Connect 联系人属性。

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

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

下图显示了设置联系人属性数据块的属性页面。它被配置为在当前联系人上设置用户定义的属性，键greetingPlayed值为 true，值为 true。

您可以选择设置以下属性：

当前联系人：属性是在运行此流的联系人上设置的。Amazon Connect 的其他区域均可访问这些属性，例如其他流程、模块、Lambda、联系人记录和 GetMetricData V API 2。
相关联系人：这些属性与包含原始联系人属性副本的新联系人相关联。

在联系人记录中，这是RelatedContactId。
流：这些属性仅限于配置这些属性的流。

如果您不想在整个联系过程中保留数据，例如需要使用敏感信息（例如客户的信用卡号）来进行 Lambda 数据提取时，流属性会非常有用。
- 流属性是存储在本地的临时变量，仅在流中使用。它们在流之外的任何地方都不可见，即使联系人转移到另一个流时也是如此。
- 它们最大 32 KB（联系人记录属性部分的最大大小）。
- 除非将它们明确配置为参数（在调用 AWS Lambda 函数数据块中，选择添加参数），否则它们不会被传递给 Lambda
- 它们不会传递给模块。您可以在模块内设置流属性，但它不会被传递出模块。
- 它们不会显示在联系记录中。
- 他们没有出现在特工面前CCP.
- 他们GetContactAttributesAPI无法揭露他们。
- 如果您在流上启用了日志记录，密钥和值将显示在 Cloudwatch 日志中。

有关每个属性的JSON语法，请参见可用联系人属性列表及其JSONPath参考。
要引用名称中包含特殊字符（例如空格）的属性，请在属性名称前后加上方括号和单引号。例如： $.Attributes.['user attribute name']。
要引用同一命名空间中的属性（如系统属性），可以使用属性名称或您指定为目标键的名称。
要引用其他命名空间中的值，例如引用外部属性，请指定该属性的JSONPath语法。
要使用联系人属性访问其他资源，请在流程中设置用户定义的属性，并使用您要访问的资源的 Amazon 资源名称 (ARN) 作为该属性的值。

要从 Lambda 函数查询中引用客户名称，请使用 $.External。 AttributeKey， AttributeKey 替换为 Lambda 函数返回的属性的密钥（或名称）。
要在 Lambda 函数中使用 Amazon Connect 提示符，请ARN为提示设置用户定义的属性，然后从 Lambda 函数访问该属性。

要引用 Amazon Lex 机器人的属性，请使用 $.Lex. 格式，然后包括要引用的 Amazon Lex 机器人部分，例如 $.Lex。 IntentName。
要将客户输入的内容引用到 Amazon Lex 机器人插槽，请使用 $.Lex.Slots。 slotName，slotName替换为机器人中插槽的名称。

属性可以最大为 32 KB，这是联系人记录属性部分的最大大小。当联系人的属性超过 32 KB 时，该联系人将沿着错误分支向下传送。作为缓解措施，请考虑以下选项：

通过将不必要的属性值设置为空来移除这些属性。
如果这些属性仅在一个流程中使用，并且不需要在该流程之外引用（例如，由 Lambda 或其他流程引用），则使用流程属性。这样，您就不会不必要地将 32 KB 的信息从一个流保存到另一个流。

使用用户定义的目标密钥时，您可以随心所欲地命名它，但不能包含 $ 和 .（句点）字符。不允许使用它们，因为它们都用于定义中的属性路径JSONPath。
您可以使用设置联系人属性数据块来设置 Amazon Lex V2 自动程序所需的语言属性。（您在 Amazon Connect 中的语言属性必须与构建 Amazon Lex V2 自动程序时使用的语言模型相匹配。）下图显示了设置为西班牙语的语言属性。

或者，您可以使用设置语音数据块来设置 Amazon Lex V2 自动程序所需的语言。