理解 PPMESSAGE 流程中的变量
PPMESSAGE 流程中可以应用变量,这些变量可以用于逻辑计算节点,正则表达式节点,消息发送节点。正确理解变量,可以让消息流程异常强大。
在 PPMESSAGE 中变量分成以下类:
- 内置的系统变量,这些变量往往是跟访客的一些属性值
- 定义变量,通过‘保存用户变量’能够创造自定义变量,这些变量的值是访客的某些指定属性的拷贝
- 自定义字段变量,这些变量针对用户属性的自定义字段
- 事件变量,这些变量针对用户自定义事件
在逻辑计算、正则表达式计算、发送消息节点上我们可以直接引用系统内置变量和自定义变量。
系统内置变量
系统内置变量名称及含义如下表:
变量名称 | 变量含义 |
---|---|
user_fullname | 访客全名 |
user_email | 访客邮件地址 |
user_mobile | 访客手机号码 |
user_language | 访客语言 |
user_country | 访客国建 |
user_city | 访客城市 |
browser_name | 浏览器名称 |
app_name | 移动应用名称 |
is_anonymous_user | 访客是匿名的 |
is_app_user | 访客通过移动应用而来 |
is_browser_user | 访客通过网页渠道而来 |
is_sms_user | 访客通过短消息渠道而来 |
is_email_user | 访客通过邮件渠道而来 |
is_telephone_user | 访客从电话渠道而来 |
is_service_user | 访客是个客服 |
is_wechat_public_user | 访客来自微信公众号 |
is_wechat_private_user | 访客来自个人微信 |
user_web_sessions | 网页会话次数 |
page_title | 访问网页标题 |
page_url | 访问网页 URL |
browser_language | 浏览器语言 |
is_assigned_user | 已经分配了客服的访客 |
message_subtype | 消息类型 |
message_body | 消息内容 |
email_body | 邮件内容 |
email_subject | 邮件主题 |
email_recipient | 邮件接受者 |
called_number | 被叫号码 |
caller_number | 主叫号码 |
sms_from | 短消息来源 |
sms_to | 短消息发给谁 |
sms_body | 短消息内容 |
user_input_dtmf | 电话按键 |
创建自定义变量
通过·获取客户数据·创建一个变量,这个变量名字必须以 var_ 开头,以免与系统变量命名冲突。
拖放这个按钮:
双击这个节点:
在字段名称中选择想复制的内容,在输出变量中定义变量名称,注意必须以 var_ 开头。
自定义字段变量
打开 设置 - 开发者设置 - 访客字段:
可以添加自定义字段,自定义字段的变量通过 extra_field:field_uuid 定义,如定义了一个字段为 ESP,其 UUID 为 bd08e6c0-4b79-11e7-89e5-985aebe0f03a, 那么在流程中这个字段值对应的变量即为 extra_field:bd08e6c0-4b79-11e7-89e5-985aebe0f03a。
事件变量
在访客字段中还可以增加自定义事件,自定义事件变量只能用来衡量自定义事件的次数,并且变量命名为 track_event:event_uuid。如果定义了一个自定义变量为 click,事件 UUID 为2a223e84-6232-11e7-b287-00163e00061e,那么它在流程中的变量名称为 track_event:2a223e84-6232-11e7-b287-00163e00061e。
直接引用变量
如在 以座席用户回复消息 这个节点中:
输入参数 中 消息源 可以选择 变量,然后就可以在内容中直接填写变量内容。
通过模板变量引用
同样是 以座席用户回复消息,可以选择消息源为文本,而文本中可以直接引用变量,如按照客户来源创建一个欢迎词:
您好,欢迎来自 {{ user_country }} {{ user_city }} 的朋友
设置访客自定义字段值
在网页客户端可以为访客的自定义字段设置值,这样可以便于给访客分类,或者导向不同的座席做一些提前的数据准备。
必须在聊天组件已经成功加载的情况下执行
window.PP.setVar({"extra_field:bd08e6c0-4b79-11e7-89e5-985aebe0f03a": "Hello World"}, function() {
//成功设置
}, function() {
//设置失败
});
上边的代码演示了给一个访客的自定义字段进行赋值,自定义字段的 UUID 是 bd08e6c0-4b79-11e7-89e5-985aebe0f03a,赋值为 Hello World,这个值可以在流程中读出,也可以显示在访客的详细信息之中。
如图所示: