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

如图所示:

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

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