流数据块:设置联系人属性 - Amazon Connect

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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

描述

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

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

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

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

支持的渠道

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

频道 是否支持?

语音

聊天

任务

流类型

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

  • 所有流

属性

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

“设置联系人属性”数据块的属性页面。

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

  • 当前联系人:属性是在运行此流的联系人上设置的。Amazon Connect 的其他区域均可访问这些属性,例如其他流程、模块、Lambda、联系人记录和 GetMetricData V2 API。

  • 相关联系人:这些属性与包含原始联系人属性副本的新联系人相关联。

    在联系人记录中,这是RelatedContactId

  • :这些属性仅限于配置这些属性的流。

    如果您不想在整个联系过程中保留数据,例如需要使用敏感信息(例如客户的信用卡号)来进行 Lambda 数据提取时,流属性会非常有用。

    • 流属性是存储在本地的临时变量,仅在流中使用。它们在流之外的任何地方都不可见,即使联系人转移到另一个流时也是如此。

    • 它们最大 32 KB(联系人记录属性部分的最大大小)。

    • 除非将它们明确配置为参数(在调用 AWS Lambda 函数数据块中,选择添加参数),否则它们不会被传递给 Lambda

    • 它们不会传递给模块。您可以在模块内设置流属性,但它不会被传递出模块。

    • 它们不会显示在联系记录中。

    • CCP 中的座席不会看到它们。

    • GetContactAttributes API 无法公开它们。

    • 如果您在流上启用了日志记录,密钥和值将显示在 Cloudwatch 日志中。

如何引用属性

  • 有关每个属性的 JSON 语法,请参阅可用联系人属性列表及其 JSONPath 参考信息

  • 要引用名称中包含特殊字符(例如空格)的属性,请在属性名称前后加上方括号和单引号。例如: $.Attributes.['user attribute name']

  • 要引用同一命名空间中的属性(如系统属性),可以使用属性名称或您指定为目标键的名称。

  • 要引用不同命名空间中的值(如引用外部属性),可以为该属性指定 JSONPath 语法。

  • 要使用联系人属性访问其他资源,可在您的流中设置用户定义的属性,并将您希望访问的资源的 Amazon 资源名称 (ARN) 作为属性值。

Lambda 示例

  • 要从 Lambda 函数查询中引用客户名称,请使用 $.External。 AttributeKey, AttributeKey 替换为 Lambda 函数返回的属性的密钥(或名称)。

  • 要在 Lambda 函数中使用 Amazon Connect 提示,可将一个用户定义的属性设置为该提示的 ARN,然后从 Lambda 函数访问该属性。

Amazon Lex 示例

  • 要引用 Amazon Lex 机器人的属性,请使用 $.Lex. 格式,然后加入要引用的亚马逊 Lex 机器人部分,例如 $.Lex。 IntentName。

  • 要对 Amazon Lex 自动程序槽引用客户输入,可使用 $.Lex.Slots.slotName,用自动程序中的槽名称替换 slotName

当属性超过 32 KB 时会发生什么

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

  • 通过将不必要的属性值设置为空来移除这些属性。

  • 如果这些属性仅在一个流程中使用,并且不需要在该流程之外引用(例如,由 Lambda 或其他流程引用),则使用流程属性。这样,您就不会不必要地将 32 KB 的信息从一个流保存到另一个流。

配置提示

  • 使用用户定义的目标密钥时,您可以随心所欲地命名它,但不能包含 $.(句点)字符。之所以不允许使用,是因为它们都用于定义 JSONPath 中的属性路径。

  • 您可以使用设置联系人属性数据块来设置 Amazon Lex V2 自动程序所需的语言属性。(您在 Amazon Connect 中的语言属性必须与构建 Amazon Lex V2 自动程序时使用的语言模型相匹配。) 下图显示了设置为西班牙语的语言属性。

    “设置联系人属性”的属性页面,值设置为“西班牙语”。

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

有关如何使用联系人属性的更多信息,请参阅使用 Amazon Connect 联系人属性

已配置的数据块

下图显示了该数据块已配置好的样子。它有两个分支:成功错误

已配置的“设置联系人属性”数据块。

流示例

Amazon Connect 包含一组流示例。有关如何在流设计器中访问流示例的说明,请参阅流示例。以下主题介绍了包含该数据块的流示例。

场景

有关使用此数据块的场景,请参阅以下主题: