工作流程生成器变量 使您可以根据与对话相关的数据自定义消息传送智能机器人的答案。消息传送元数据变量是一种工作流程生成器变量,包含关于当前客户身份和身份验证状态的信息。
消息传送元数据变量从用于 消息传送身份验证的已签名 JSON 网络密钥 (JWT) 中获取值。在对话期间,消息传送智能机器人可以使用此数据自定义其响应、显示特定于客户的信息,或分支对话的工作流程。
这篇文章包括以下主题:
有关工作流程生成器变量以及如何在答案工作流程中使用它们的更广泛的概述,请参阅 使用变量个性化智能机器人答案。
启用消息传送元数据变量
消息传送元数据变量默认未启用。要启用消息传送元数据变量,管理员必须 创建一个签名密钥 ,用于生成 JWT 以进行消息传送身份验证。消息传送身份验证和消息传送元数据变量仅可用于 Web Widget 和移动 SDK 渠道。
有关设置消息传送身份验证的更多信息,请参阅 在 Web Widget 和移动 SDK 的消息传送中对终端用户进行身份验证。
支持的消息传送元数据变量
与其他类型的工作流程生成器变量不同,消息传送元数据变量具有预定义的名称。您无法在答案工作流程中设置或更改消息传送元数据变量的名称或值。
消息传送元数据变量名称 | 描述 |
---|---|
提供的电邮 | 客户的电邮地址。此电邮地址取自用于消息传送身份验证的 JWT。 |
提供的名称 | 客户的名称。此名称取自用于消息传送身份验证的 JWT。 |
已经过身份验证的外部 ID | 用于识别客户的唯一字母数字字符串。此 ID 来自用于消息传送身份验证的 JWT。 |
已通过身份验证状态 | 如果为 true,则客户已通过身份验证。否则为 false。此变量始终为 true 或 false,绝不为空。 当在 按条件分支的 步骤中使用已通过 身份验证的状态 变量时,仅支持 Is 运算符。 |
使用提供的名称和提供的电邮变量
使用“ 提供的名称 ”和“ 提供的电邮 ”变量时,请记住以下注意事项:
- 消息传送智能机器人在“ 询问详情” 步骤中自动跳过收集已通过身份验证的客户的 姓名 和 电邮 变量。对于已通过身份验证的客户,这些变量为空,在对话的后续步骤中将被跳过。请改用“ 提供的名称 ”和“ 提供的电邮 ”变量。
从“ 询问详情” 步骤已跳过 名称 和 电邮 变量集合 提供的名称 和 提供的电邮 变量 - 用于消息传送身份验证的 JWT 不需要客户的姓名或电邮地址。如果您的组织未在其 JWT 中包含名称或电邮地址,则对话期间相应的“ 提供的名称 ”和“ 提供的电邮 ”变量将为空并跳过。
在这种情况下,我们建议更新您的 JWT,在其中包含名称和电邮地址。
- 对于未经身份验证的客户, 提供的名称 和 提供的电邮 变量为空。避免在未经身份验证的客户的回答步骤中使用这些变量。
对未经身份验证的客户使用消息传送元数据变量
如果客户未通过身份验证,则 Authenticated 状态 变量的值为 false。对于未经身份验证的客户,其他消息传送元数据变量为空,在对话期间将被跳过。
使用消息传送元数据变量的最佳实践
当创建使用消息传送元数据变量的答案时,请记住以下最佳实践:
- 如果您未在用于消息传送身份验证的 JWT 中包含客户的名称或电邮地址,请勿使用 提供的名称 和 提供的电邮 变量。
- 要建立一个对已通过身份验证和未通过身份验证的客户都可用的答案工作流程,使用“ 按条件分支” 步骤检查客户的“已通过 身份验证” 变量。仅在 Authenticated Status 为 true 的分支中包含消息传送元数据变量。
- 如果您正在构建一个仅供已通过身份验证的客户使用的答案,并且您组织的 JWT 包含名称和电邮地址,请使用“ 提供的名称 ”和“ 提供的电邮 ”变量作为客户的名称和电邮地址。在这种情况下,您无需使用“ 询问详情” 步骤再次收集此信息。
翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性
如对翻译准确性有任何疑问,请以文章的英语版本为准。