在智能机器人回复中使用身份验证元数据

在所有 Suite 服务模式中可用

此功能是人工智能专员的一部分。

智能机器人生成器变量使您可以根据对话相关的数据自定义消息传送智能机器人的回复。消息传送元数据变量是智能机器人生成器中使用的一种变量，包含当前客户身份和身份验证状态的相关信息。

消息传送元数据变量从用于消息传送身份验证的已签名 JSON 网络密钥 (JWT) 中获取值。在对话期间，消息传送智能机器人可以使用此数据自定义其响应、显示特定于客户的信息，或创建对话工作流程分支。

本文章包含以下主题：

有关智能机器人变量以及如何在回复中使用这些变量的概述，请参阅使用变量创建个性化的智能机器人回复。

启用消息传送元数据变量

消息传送元数据变量默认不启用。要启用消息传送元数据变量，管理员必须创建一个签名密钥，用于生成 JWT，以进行消息传送身份验证。消息传送身份验证和消息传送元数据变量仅适用于 Web Widget 和移动 SDK 渠道。

与其他类型的智能机器人变量不同，消息传送元数据变量具有预定义的名称。您无法在回复工作流程中设置或更改消息传送元数据变量的名称或值。

消息传送元数据变量名称	描述
提供的电邮	客户的电邮地址。此电邮地址取自用于消息传送身份验证的 JWT。
提供的名称	客户名称。此名称取自用于消息传送身份验证的 JWT。
已经过身份验证的外部 ID	识别客户的唯一字母数字字符串。此 ID 取自用于消息传送身份验证的 JWT。
已通过身份验证状态	如果为 true，则客户已通过身份验证。否则为 false。此变量始终为 true 或 false，永不为空。在按条件创建分支步骤中使用已通过身份验证状态变量时，仅支持是运算符。

使用提供的名称和提供的电邮变量时，请记住以下注意事项：

消息传送智能机器人会自动跳过询问详情步骤中已通过身份验证客户的名称和电邮变量集合。对于已通过身份验证的客户，这些变量为空，并将在对话的后续步骤中跳过，而应使用提供的名称和提供的电邮变量。

已跳过询问详情步骤中的名称和电邮变量收集 提供的名称和提供的电邮变量
用于消息传送身份验证的 JWT 不需要客户的名称或电邮地址。如果您组织的 JWT 中未包含名称或电邮地址，则相应提供的名称和提供的电邮变量为空，并在对话期间被跳过。
在这种情况下，我们建议您更新 JWT，使其包含名称和电邮地址。
对于未经身份验证的客户，提供的名称和提供的电邮变量为空。避免在回复未经身份验证的客户的步骤中使用这些变量。

如果客户未通过身份验证，则已通过身份验证状态变量的值为 false。其他消息传送元数据变量对于未经身份验证的客户为空，在对话期间会被跳过。

在创建使用消息传送元数据变量的回复时，请记住以下最佳实践：

如果您未在用于消息传送身份验证的 JWT 中包含客户的名称或电邮地址，则不要使用提供的名称和提供的电邮变量。
要构建可供已通过身份验证和未经身份验证的客户使用的回复工作流程，使用按条件创建分支步骤检查客户的已通过身份验证状态变量。仅在已通过身份验证状态 为 true 的分支中包括消息传送元数据变量。
如果您创建的回复仅供已通过身份验证的客户使用，且您组织的 JWT 包含名称和电邮地址，则对客户的名称和电邮地址使用变量提供的名称和提供的电邮地址。在这种情况下，您无需使用询问详情步骤再次收集此信息。