可用变量是组件配置的通用配置项,在可用变量区域中默认创建了常用变量,供流程编排过程中调用。本文介绍默认的可用变量,以及可用变量的新增、插入、删除操作。
前置步骤
使用可用变量前,需要您先进入需编辑的旅程中,找到想使用可用变量的目标组件。
在智能客户旅程列表页面,单击需编辑旅程右侧的编辑按钮,进入旅程的画布编辑页面。
在画布中,单击需使用可用变量的组件,在右侧配置面板中,即可查看到可用变量区域。
例如,选中发送 WhatsApp 消息组件后,右侧配置面板的可用变量区域显示
incomingMessage、serviceId、customerPhoneNumber等可用变量。说明触发类型为上行消息触发(WhatsApp、Instagram、Viber、Messenger 等)的旅程中有预置的系统变量。若是 API 事件触发的旅程,需要在开始中添加变量以便在触发旅程后可接收您传递的参数。
默认变量
变量名 | 描述 | 示例 |
incomingMessageType | 用户上行的消息类型。 | 目前支持text、location、button、interactive |
incomingMessage | 用户第一条上行消息。 | Hello |
wabaId | WABA(WhatsApp Business Account)ID。 | 10***********23 |
wabaPhoneNumber | WABA下的电话号码。 | 861301111**** |
customerPhoneNumber | 终端用户电话号码。 | 861310000**** |
customerName | 终端用户名称。 | John |
customerPhoneNumberOrBsuid | 手机号码为空时会有 BSUID 值 | 861310000****或 CN.124789*** |
bsuid | 仅接收 BSUID 值 | CN.124789*** |
chatFlowSessionId | 旅程会话 ID | 78434861**** |
新增变量
您可以参考下方操作新增可用变量,可大致分为三种方式新增变量,操作前,请您完成前置步骤。
设置变量组件新增变量
在画布左侧的组件库中拖拽设置变量组件至画布中。
单击画布中的设置变量组件,在右侧的变量配置中完成新增变量,
如需新增多个变量,单击添加变量进行添加,添加完成后单击保存。
在右侧变量配置区域,填写变量的 Key 和 Value。
在弹出的对话框中单击保存,完成保存。
插入变量中新增变量
在流程的画布中,可在发送Viber消息、发送Instagram消息等组件右侧配置栏消息设置中新增变量,输入 {{ 可选择变量或自定义新变量。在 Message Settings 配置面板的 Content 输入区域中,输入
{{即可触发变量选择下拉列表,可选变量包括chatFlowSessionId、incomingOutId和incomingUuid。单击保存。在弹出的对话框中单击保存,完成保存。
画布开始栏新增变量(仅限触发器类型为手动)
单击画布中的开始,在右侧的基础配置中关闭不接受传入变量,在变量名称栏输入需要新增的变量名称。
如需新增多个变量,可单击添加变量进行添加。添加完成后单击保存。
在弹出的对话框中单击保存,完成保存。
插入变量
可以参考下方操作插入可用变量,操作前,请您完成前置步骤。
在组件配置区域中,输入 {{ 可选择变量或自定义新变量。在Message Settings配置面板的Content输入区域中,输入
{{即可触发变量选择下拉列表,可选变量包括chatFlowSessionId、incomingOutId、incomingUuid。
删除变量
您可以参考下方操作删除可用变量,可大致区分为三种方式进行删除,操作前,请您完成前置步骤。
删除变量只能在变量来源的组件中删除对应的变量,不支持删除默认的系统变量,删除变量会导致引用此变量的位置无法获得参数,请谨慎操作。
设置变量组件中删除变量
单击画布中的设置变量组件,在右侧的配置栏,对需要进行删除的变量单击删除。
说明如果之前在设置变量组件中是通过插入变量的方式新增的变量,那么在删除此变量时,单击右侧的插入变量,在弹出的对话框中单击删除。
删除变量后,单击顶部的 保存 按钮以保存流程配置。
完成删除后单击保存,在弹出的对话框中单击保存,完成保存。
画布开始中删除变量(仅限触发器类型为手动)
单击画布中的开始,在右侧的配置栏单击删除图标。
删除变量后,单击保存。
完成删除后单击保存,在弹出的对话框中单击保存,完成保存。