理解 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,这个值可以在流程中读出,也可以显示在访客的详细信息之中。

如图所示:

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,529评论 5 475
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,015评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,409评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,385评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,387评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,466评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,880评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,528评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,727评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,528评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,602评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,302评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,873评论 3 306
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,890评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,132评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,777评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,310评论 2 342

推荐阅读更多精彩内容

  • 点击查看原文 Web SDK 开发手册 SDK 概述 网易云信 SDK 为 Web 应用提供一个完善的 IM 系统...
    layjoy阅读 13,648评论 0 15
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,579评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,361评论 25 707
  • 我的职业是固定的 固定的站在那里 不能动 我穷 需要它来维持生命 除了将泪水保存到工作结束 我不知道还能做什么 站...
    方城子夜阅读 137评论 1 0
  • 解决方式两种: Android在打release包时,可能会出现这种错误。 解决办法就是在build.gradle...
    风之丨旅人阅读 354评论 0 0