Flow Builder变量允许您根据与对话相关的数据定制消息传递机器人的答案。消息传递元数据变量是Flow Builder变量的一种类型,它包含有关当前客户身份和身份验证状态的信息。
消息传递元数据变量从签名的JSON Web令牌(jwt)中获取它们的值消息身份验证.在对话期间,消息传递机器人可以使用此数据自定义其响应、显示特定于客户的信息或分支对话流。
本文包括以下主题:
有关Flow Builder变量的更广泛概述以及如何在回答流中使用它们,请参见使用变量来个性化机器人的答案.
启用消息传递元数据变量
默认情况下不启用消息传递元数据变量。要启用消息传递元数据变量,管理员必须创建签名密钥用于生成用于消息传递身份验证的jwt。消息传递身份验证和消息传递元数据变量仅可用于Web Widget和移动SDK通道。
有关设置消息传递身份验证的详细信息,请参见对Web Widget和移动SDK的消息传递中的最终用户进行身份验证.
支持的消息传递元数据变量
与其他类型的Flow Builder变量不同,消息传递元数据变量具有预定义的名称。您不能在应答流中设置或更改消息传递元数据变量的名称或值。
消息传递元数据变量名称 | 描述 |
---|---|
提供电子邮件 | 客户的电子邮件地址。此电子邮件地址是从用于消息传递身份验证的JWT中提取的。 |
提供的名称 | 客户名称。这个名称是从用于消息传递身份验证的JWT中提取的。 |
经过认证的外部ID | 标识客户的唯一字母数字字符串。这个ID是从用于消息传递身份验证的JWT中提取的。 |
验证状态 | 如果为true,则对客户进行身份验证。否则,假的。这个变量总是为真或假,永远不会为空。 在使用验证状态a中的变量按条件分支步骤,只有是支持Operator。 |
使用提供的名称和提供的电子邮件变量
在使用时,请记住以下注意事项提供的名称和提供电子邮件变量:
- 消息传递机器人会自动跳过名字和电子邮件中已验证的客户的变量询问细节的一步。对于经过身份验证的客户,这些变量为空,并在对话的后续步骤中被跳过。相反,使用提供的名称和提供电子邮件变量。
跳过名字和电子邮件变量集合询问细节一步 提供的名称和提供电子邮件变量 - 用于消息传递身份验证的jwt不需要客户的姓名或电子邮件地址。如果您的组织没有在其jwt中包含姓名或电子邮件地址,则各自的提供的名称和提供电子邮件变量为空,并在对话期间被跳过。
在这种情况下,我们建议更新jwt以包含姓名和电子邮件地址。
- 的提供的名称和提供电子邮件对于未经身份验证的客户,变量为空。避免在未经身份验证的客户的回答步骤中使用这些变量。
对未经身份验证的客户使用消息传递元数据变量
如果客户没有经过身份验证,则验证状态变量的值为false。其他消息传递元数据变量对于未经身份验证的客户是空的,并且在对话期间被跳过。
使用消息传递元数据变量的最佳实践
在创建使用消息传递元数据变量的答案时,请牢记以下最佳实践:
- 如果在用于消息传递身份验证的jwt中没有包含客户的姓名或电子邮件地址,则不要使用提供的名称和提供电子邮件变量。
- 要构建对经过身份验证和未经过身份验证的客户都可用的回答流,请使用按条件分支步骤检查客户的验证状态变量。仅在以下分支中包含消息传递元数据变量验证状态是真的。
- 如果您正在构建一个仅对经过身份验证的客户可用的答案,并且您的组织的jwt包含姓名和电子邮件地址,则使用提供的名称和提供电子邮件变量表示客户的姓名和电子邮件地址。在这种情况下,您不需要使用询问细节的一步。
0评论
请登录留下评论。