在智能机器人生成器中,变量是与对话相关的数据的容器,例如客户姓名或商店订单 ID。在对话期间,消息传送智能机器人可以多种方式利用变量,包括:
- 插入智能机器人消息中,以形成个性化文本回复、显示动态信息和图像或创建对话分支。
- 根据终端用户的输入设置变量的值。
- 用于在“转接给专员”步骤创建的工单的标签中。
智能机器人在所有答案中最多包含 46 个唯一变量。每个唯一变量都可以根据需要在答案中多次使用。
关于变量名称和值
在智能机器人生成器中,每个变量都有名称和值。在回复中配置步骤时,名称将用作值的占位符。智能机器人在运行回复时会将变量的名称替换为变量的值。例如,您可以使用一个名为电邮的变量作为客户电邮地址的占位符。
变量在对话智能机器人中是全局性的。创建变量后,变量可通过自由文本或链接到另一个回复步骤用于终端用户对话中的所有后续回复。
处理空白变量
如果变量没有值,则为空白变量。消息传送智能机器人在对话期间会跳过空白变量。
例如,发送消息步骤包含“您的包裹的物流状态为 shipping_status”的智能机器人消息。如果在对话期间 shipping_status 变量为空白,智能机器人将发送消息“您的包裹的送货状态为 ”。
智能机器人消息 | 客户视图 |
---|---|
处理缺失变量
在进行 API 调用步骤中,如果响应中缺失一个已保存的变量,则将触发该步骤的“失败”分支。请参阅在智能机器人生成器中使用“进行 API 调用”步骤。
关于变量类型
客户变量
客户变量会存储客户在询问详情步骤中提供的信息。例如,该步骤可能会要求客户提供其姓名和电邮地址。
当在一个步骤中使用添加变量图标 () 插入变量时,客户变量将显示在客户的响应下。
外部服务变量
外部服务变量会存储在进行 API 调用步骤期间接收的来自外部系统的数据。例如,该步骤可以向物流供应商发出 REST API 请求,以获取包裹的当前状态。
管理员会在配置进行 API 调用步骤时创建外部服务变量。在配置过程中,管理员可以为每个变量设置一个自定义名称。
当在一个步骤中使用添加变量图标 () 插入变量时,外部服务变量将显示在外部服务的响应下。
消息传送元数据变量
消息传送元数据变量包含关于客户身份和身份验证状态的信息。消息传送元数据变量从用于消息传送身份验证的已签名 JSON 网络密钥 (JWT) 中获取值。
消息传送元数据变量默认不启用,并且仅适用于 Web Widget 和移动 SDK 渠道。有关启用和使用消息传送元数据变量的更多信息,请参阅在智能机器人回复中使用身份验证元数据。
如果启用,当在一个步骤中使用添加变量图标 () 插入变量时,消息传送元数据变量将显示在消息传送元数据下。
Sunshine Conversations 变量
在回复中使用变量
向外部系统发送数据
当使用进行 API 调用步骤对外部系统进行 REST API 调用时,管理员可以将插入变量添加到该步骤的端点 URL 字段的路径和查询字符串中。有关更多信息,请参阅在智能机器人生成器中使用进行 API 调用步骤。
创建回复的工作流程分支
设置变量值
管理员可使用设置变量步骤,根据终端用户在对话中的操作创建新变量并分配一个值,或选择现有变量并覆盖其值。变量可在智能机器人的所有回复中引用。
请参阅了解回复步骤类型:设置变量以获取使用详情。
在标签中使用变量
对于在转接给专员步骤创建的工单,管理员可以在添加的标签中使用变量。专员可以使用这些标签查看、组织和跟踪工单,以及用于自动操作,例如工单路由和其它业务规则。
尽管工单标签中的变量从技术上讲是回复的一部分,但其所遵循的规则和限制却与其它变量不同。
您可以使用从 API 调用生成的变量和系统变量。可用变量显示在选择下拉菜单中:
但是,含有终端用户输入的变量不能在标签中使用。它们将显示在下拉列表中,但将被禁用。例如,您无法使用在对话早期的询问详情步骤中收集的信息引用变量。
以下规则和建议适用于在标签中使用变量:
字符限制
- 每个硬编码标签限制为 80 个字符以内。
特殊字符
- 包含以下特殊字符的变量无法使用,也不会显示为可用变量:£、`、、\、[、]、{、}、(、)、<、>、%、&、?,+,@ ,!、*、$、#、=和 "
- 变量中使用的空格或逗号在标签中显示为下划线。
此外,在使用变量作为标签时,我们建议采用以下最佳实践:
- 标签通常用于路由对话或用于触发器条件。如果您要在工单中添加专员背景信息,我们建议使用自定义字段。
- 限制变量可能值的数量。太多的值会导致意外行为。
- 值选项应尽量简短,以免作为标签被截断。
- 值中避免含有特殊字符。