全部产品
Search
文档中心

Chat App 消息服务:如何使用可用变量

更新时间:Oct 08, 2026

可用变量是组件配置的通用配置项,在可用变量区域中默认创建了常用变量,供流程编排过程中调用。本文介绍默认的可用变量,以及可用变量的新增、插入、删除操作。

前置步骤

使用可用变量前,需要您先进入需编辑的旅程中,找到想使用可用变量的目标组件。

  1. 登录Chat App 消息服务控制台。

  2. 在智能客户旅程列表页面,单击需编辑旅程右侧的编辑按钮,进入旅程的画布编辑页面。

  3. 在画布中,单击需使用可用变量的组件,在右侧配置面板中,即可查看到可用变量区域。

    例如,选中发送 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****

新增变量

您可以参考下方操作新增可用变量,可大致分为三种方式新增变量,操作前,请您完成前置步骤。

设置变量组件新增变量

  1. 在画布左侧的组件库中拖拽设置变量组件至画布中。

  2. 单击画布中的设置变量组件,在右侧的变量配置中完成新增变量,

  3. 如需新增多个变量,单击添加变量进行添加,添加完成后单击保存。

    在右侧变量配置区域,填写变量的 Key 和 Value。

  4. 在弹出的对话框中单击保存,完成保存。

插入变量中新增变量

  1. 在流程的画布中,可在发送Viber消息、发送Instagram消息等组件右侧配置栏消息设置中新增变量,输入 {{ 可选择变量或自定义新变量。在 Message Settings 配置面板的 Content 输入区域中,输入 {{ 即可触发变量选择下拉列表,可选变量包括 chatFlowSessionId、incomingOutId 和 incomingUuid。

  2. 单击保存。在弹出的对话框中单击保存,完成保存。

画布开始栏新增变量(仅限触发器类型为手动)

  1. 单击画布中的开始,在右侧的基础配置中关闭不接受传入变量,在变量名称栏输入需要新增的变量名称。

  2. 如需新增多个变量,可单击添加变量进行添加。添加完成后单击保存。

  3. 在弹出的对话框中单击保存,完成保存。

插入变量

  • 可以参考下方操作插入可用变量,操作前,请您完成前置步骤。

  • 在组件配置区域中,输入 {{ 可选择变量或自定义新变量。在Message Settings配置面板的Content输入区域中,输入 {{ 即可触发变量选择下拉列表,可选变量包括 chatFlowSessionId、incomingOutId、incomingUuid。

删除变量

您可以参考下方操作删除可用变量,可大致区分为三种方式进行删除,操作前,请您完成前置步骤。

重要

删除变量只能在变量来源的组件中删除对应的变量,不支持删除默认的系统变量,删除变量会导致引用此变量的位置无法获得参数,请谨慎操作。

设置变量组件中删除变量

  1. 单击画布中的设置变量组件,在右侧的配置栏,对需要进行删除的变量单击删除。

    说明

    如果之前在设置变量组件中是通过插入变量的方式新增的变量,那么在删除此变量时,单击右侧的插入变量,在弹出的对话框中单击删除。

    删除变量后,单击顶部的 保存 按钮以保存流程配置。

  2. 完成删除后单击保存,在弹出的对话框中单击保存,完成保存。

画布开始中删除变量(仅限触发器类型为手动)

  1. 单击画布中的开始,在右侧的配置栏单击删除图标。

    删除变量后,单击保存。

  2. 完成删除后单击保存,在弹出的对话框中单击保存,完成保存。