使用帮助_V5智能客服

智能硬件: 无线打印机; 微信WIFI

网页客服功能: 获取和安装代码; 关于QQ客服; 关于阿里旺旺; 浮动条的显示条件; 自定义客服图标和文字链接

高级培训指令

为了使培训更灵活、有效，系统会逐步开放一些指令供大家调用。
使用方法：编辑问答时，根据需求将指令直接插入在【上一句问题】、【上一句回复】、【问题】或【回复】的文本框中(以各指令【生效范围】为准)。

[vs=*] 通配符: 通过这个指令可实现模糊匹配，插入[vs=*]表示这个位置可以匹配任意的字符，且不限字符数。

生效范围：
- 上一句问题
- 上一句回复
- 当前问题

示例详解：
- V5KF[vs=*]：可匹配“V5KF棒”、“V5KF尤其特别棒！！！” 等以 V5KF 开头的句子

- [vs=*]V5KF：可匹配“爱V5KF” 、“大爱V5KF”、“我的最爱——V5KF” 等以 V5KF 结尾的句子

- [vs=*]V5KF[vs=*]：可匹配“我的最爱——V5KF尤其特别棒！！！” 等包含 V5KF 的句子

- [vs=*]使用[vs=*]V5KF[vs=*]：可匹配“使用你们V5KF系统很方便”，但不能匹配“V5KF系统使用很方便”。也就是说，两个关键字的位置是严格对应的。

- [vs=*]：当无法匹配现有问答数据又没设置机器人_应急回答时将生效(请慎用，推荐设置机器人_应急回答)。

[vs=表达式] 匹配表达式: 这个指令跟[vs=*]功能很相似，但它能按指定类型、规则的内容去精确匹配，如：邮箱地址和手机号码等。

生效范围：
- 当前问题
- 当前回复

信息列表：
- [vs=数值] 中文和阿拉伯数字，如：520、3.1415926 和一百二十三等
- [vs=坐标位置] 用户通过微信发送过来的位置坐标
- [vs=电邮地址] Email邮箱地址，如：test@v5kf.com
- [vs=手机号码] 国内的手机号码，如：13510108888
- [vs=固定电话] 国内的座机号码，如：0755-26011007 或 26011007
- [vs=身份证号] 国内的身份证号码，如：431002198901021513

PS: 表达式持续开放中...

匹配示例(在问题中编辑)：
- 请拨打[vs=手机号码]：可匹配“请拨打13510108888”、“请拨打 18813148888” 等明文请拨打+手机号码的句子

- [vs=数值]加[vs=数值][vs=*]：可匹配“5加1=?” 、“三加7等于” 等数值表达式与通配符[vs=*] 组成的加法公式

- [vs=坐标位置]：可匹配用户在微信发送的位置，这个表达式只能单独调用，不与其它明文和表达式混合使用。

调用示例(在回复中编辑)：
- 问题规则= [vs=电邮地址] 回复规则= 我们将尽快把方案发送到[vs=电邮地址] ：问题内容=test@v5kf.com，回复内容=我们将尽快把方案发送到test@v5kf.com

- 问题规则= [vs=身份证号]预定[vs=数值]个位子 回复规则= 成功为[vs=身份证号]预留[vs=数值]个位子 ：问题内容=431002198901021513预定2个位子，回复内容=成功为431002198901021513预留2个位子

- 问题规则= [vs=坐标位置] 回复规则= 您的当前坐标：[vs=坐标位置] ：用户发送位置后，调用表达式将自动获取到坐标经纬度，回复内容=您的当前坐标：114.067421,22.546159。 PS: 此坐标为手机传过来未经转换的，可能与百度等坐标值有一定偏差。

- 问题规则= [vs=数值]比[vs=数值]大 回复规则= [vs=数值p2]比[vs=数值p1]小 ：问题内容=7比4大，回复内容=4比7小。

备注：除了坐标位置，其他表达式都可以填写多个，并结合 p+序号（如：[vs=手机号码p1]、[vs=手机号码p2]）调用相应位置的内容

[vs_rx=表达式] 正则表达式: 除了官方提供的匹配表达式，有高级需求的用户可以通过正式表达式设计更灵活、强大的指令。
[vs_rx=[1-9]\d{5}$] ，此指令用于问题中匹配，其中蓝色内容为表达式。
[vs_rx=p1] ，此指令用于回复中调用，对应第1个表达式匹配的内容；如果把数字改成其它的，比如 [vs_rx=p3] 则对应第3个表达式匹配的内容。

生效范围：
- 当前问题
- 当前回复

示例详解：
- 问题规则= [vs_rx=^1[3458]\d{9}$] 回复规则= 这是谁的手机号码？ ：问题内容=13900008888，回复内容=这是谁的手机号码？

- 问题规则= [vs=*]身份证[vs=*][vs_rx=(^\d{15}$)|(^\d{17}[0-9xX]$)] 回复规则= 身份证[vs_rx=p1]预订成功 ：问题内容=这是我的身份证号码431002199409041519，回复内容=身份证431002199409041519预订成功

备注：表达式可以配合其它指令(如: [vs=*])配置多个，并在回复中通过 p+序号（如：[vs_rx=p1]、[vs_rx=p1]）调用相应位置的内容

此指令比较复杂，需要懂点技术或深入了解才能上手，可通过此页面测试或学习正式表达式：正式表达式手册及测试工具

[emot=*/] 插入表情: 配合表情代码，替换指令中的*号组合成 [emot=表情编码/] 即可识别或调用出相应的表情。
备注：微信端对话，系统会自动转换成微信适用的表情。

生效范围：
- 当前问题
- 当前回复

示例详解：
- [emot=哈哈/]笑死我了：表情哈哈结合明文"笑死我了"

- 欺负人[emot=嚎啕大哭/]：明文"欺负人"结合表情 嚎啕大哭

- 问题中填写：[emot=打瞌睡/]：问题=打瞌睡，回复=困了就休息会呗

通用表情(网页客服与微信平台)：

[emot=哈哈/]

[emot=得瑟/]

[emot=示好/]

[emot=哼/]

[emot=嚎啕大哭/]

[emot=不懂/]

[emot=俏皮/]

[emot=别惹我/]

[emot=呜呜/]

[emot=打瞌睡/]

[emot=雷倒/]

[emot=再见啦/]

[emot=汗到/]

[emot=晕翻/]

[emot=被激怒/]

[emot=不好意思/]

微信专用表情：

[emot=饥饿/]

[emot=惊恐/]

[emot=大兵/]

[emot=奋斗/]

[emot=咒骂/]

[emot=嘘/]

[emot=折磨/]

[emot=骷髅/]

[emot=敲打/]

[emot=抠鼻/]

[emot=鼓掌/]

[emot=坏笑/]

[emot=鄙视/]

[emot=阴险/]

[emot=吓/]

[emot=恐吓/]

[emot=西瓜/]

[emot=啤酒/]

[emot=球类/]

[emot=咖啡/]

[emot=猪头/]

[emot=示爱/]

[emot=爱心/]

[emot=心碎/]

[emot=瓢虫/]

[emot=便便/]

[emot=月亮/]

[emot=太阳/]

[emot=礼物/]

[emot=拥抱/]

[emot=强/]

[emot=弱/]

[emot=握手/]

[emot=胜利/]

[emot=抱拳/]

[emot=勾引/]

[emot=拳头/]

[emot=NO/]

[emot=OK/]

[emot=发抖/]

[emot=转圈/]

[emot=磕头/]

[emot=回头/]

[emot=跳绳/]

[emot=挥手/]

[emot=激动/]

[emot=献吻/]

[emot=太极/]

[emot=撇嘴/]

[emot=色/]

[emot=发呆/]

[emot=害羞/]

[emot=闭嘴/]

[emot=惊讶/]

[emot=吐/]

[url] 生成文字链接: 给用户显示一大串的URL链接(比如：http://www.v5kf.com/web/help.html)是不太友好的体验，可以用此指令实现文字链接(比如：查看帮助)。

生效范围：
- 当前回复

示例详解：
- [URL="http://www.v5kf.com"]点击这里[/URL]：点击这里

- 还有问题请点击 [URL="http://www.v5kf.com/web/help.html"]查看帮助[/URL]：还有问题请点击查看帮助

[vs_robot=*] 控制机器人状态: 对话中的某些场景中(用户主动要求或人工客服在回复)，有时需要暂时关闭机器人自动回复功能(本次对话或当前问题)。通过以下指令可以灵活控制：

-[vs_robot=skip] 跳过此问题的回复(应急回答也会跳过)，但不会影响其它问题的回复，此用户下一个问题会正常处理
-[vs_robot=stop] 关闭机器人在本次对话的自动回复，之后的问题也将不回复，此用户下一次的对话(大约10分钟之后)才能恢复
-[vs_robot=start] 恢复机器人自动回复的功能

生效范围：
- 当前回复

示例详解：
- 问题规则= 你给我闭嘴 回复= [vs_robot=skip] ：问题内容=你给我闭嘴，无回复内容。备注：适合设置在应急回答中，下一句问题仍会正常处理

- 问题规则= 你给我滚远点 回复= [vs_robot=stop]5555，被你抛弃了，想我时发送"你回来" ：问题内容=你给我滚远点，回复内容=5555，被你抛弃了，想我时发送"你回来"。备注：之后用户再发送任何内容也不会回复了

- 问题规则= [vs=*]你回来[vs=*] 回复规则= [vs_robot=start]我已经滚远了 ：问题内容=好吧，你回来，回复内容=我已经滚远了。备注：之后将恢复自动回复功能

[vs_pm=*] 调用机器人信息: 经常有朋友问，如何在回复中调用机器人姓名或公司电话等信息。
配合设置机器人中的信息参数，替换指令中 [vs_pm=*] 的*号组合成 [vs_pm=信息名称] 即可调用出相应的信息内容。
如果信息中设置了图文或语音此指令将无效。

生效范围：
- 当前回复

示例详解：
- 我叫[vs_pm=机器人_姓名]：机器人_姓名=小五，回复=我叫小五

- 你来[vs_pm=机器人_地址]找我呀：机器人_地址=深圳，回复=你来深圳找我呀

- 我不懂时，会跟你说：[vs_pm=机器人_应急回答]：机器人_应急回答=我败了，回复=我不懂时，会跟你说：我败了

[vs_user=*] 调用用户信息: 通过这个指令可以调用当前对话的用户信息，并能配合其它指令使用(比如：[vs_api_url])。

生效范围：
- 当前回复

信息列表：
- [vs_user=id] 该用户在系统中的编号(整数型的唯一标识)
- [vs_user=wxkey] 该用户的微信帐号(微信官方称为OpenID)
- [vs_user=nickname] 该用户绑定的昵称(非微信昵称，此用户在公众号留言或微信墙等功能中设置的昵称)
- [vs_user=location] 获取该用户的位置坐标，PS: 此坐标为手机传过来未经转换的，可能与百度等坐标值有一定偏差
- [vs_user=city] 获取该用户的所在城市名
- [vs_user=address] 获取该用户的详细地址

备注: 获取位置的几个指令需用户向公众号至少发送过一次位置才能支持...

[vs=mn] 对话开场白: 大家都在打听，微信开场白只能在粉丝关注时发送，能不能之后打开对话再发送一次呢？恭喜你，现在可以通过指令[vs=mn]来实现。
同一个用户如果在一个小时内没有发送消息，下一条消息(无论用户发送什么内容)都会当作新的对话并触发[vs=mn]的回复，
如果你觉得一个小时过于频繁，可以在指令中设置间隔时间：[vs=mn,7] ，其中的数字就是指7小时(可设置1-24)。

生效范围：
- 当前问题

示例详解：
- 问题规则= [vs=mn] 回复规则= 欢迎回来 ：问题内容=好忙啊，回复内容=欢迎回来

- 问题规则= [vs=mn,24] 回复规则= 忙什么呢？一天都没见到你了 ：问题内容=哈哈，回复内容=忙什么呢？一天都没见到你了

- 问题规则= [vs=mn] 回复规则= [vs_pm=机器人_微信开场白] ：问题内容=继续，回复内容=这里是V5KF(实际内容以设置的开场白为准，注：如果开场白设置了图文或语音将无效。)

[vs=mark] 标记消息: 这个指令可以帮助你对一些重要的消息做标记并收集起来，方便今后在海量数据中(网页、微信、易信和微淘等对话消息)快速浏览和检索。
培训时，在问题最前端插入[vs=mark]指令即可。

生效范围：
- 当前问题

示例详解：
- 问题规则= [vs=mark]投诉[vs=*] 回复规则= 收到您的反馈([vs=*p1])，我们会尽快处理 ：问题内容=投诉你们的客服老是不在线，回复内容=收到您的反馈(你们的客服老是不在线)，我们会尽快处理

该问答被匹配时，产生的消息会自动标记，你可以进入数据中心->消息分析->标记消息查看管理。

[vs_wd=词条1|词条2|词条n] 匹配多个词: 在培训时经常遇到这样的情况，西红柿是什么，番茄是什么？要培训两句，现在一句搞定。

生效范围：
- 当前问题

示例详解：
- 喜欢吃[vs_wd=番茄|西红柿]：可匹配“喜欢吃番茄” 和 “喜欢吃西红柿”

- [vs=*][vs_wd=刘德华|黎明|郭富城|张学友]是四大天王：可匹配“张学友是四大天王” 和 “我猜黎明是四大天王” 等

备注：此指令是按词匹配，比如 [vs_wd=小苹果|Apple] 这个就不行，因为系统会将 小苹果 拆分成两个词：“小” “苹果”

[vs_date] [vs_time] 调用时间、日期: 将本地日期和时间按指定格式调用出来，并能配合其它指令使用。

生效范围：
- 当前回复

示例详解：
- [vs_date=YYYY-MM-DD] =2013-05-20

- [vs_date=YY年M月D日] =13年5月20日

- [vs_time=HH:MM:SS] =17:22:33

- 当前时间是：[vs_time=HH点MM分] =当前时间是：17点22分

[vs=pa] 调用当前问题完整内容: 通过这个指令可以把用户当前的问题调用出来。

生效范围：
- 当前回复

示例详解：
- [vs=pa]：问题=我去年买了个表，回复=我去年买了个表

- [vs=pa]？我也不懂，你教教我嘛：问题=怎样翻墙，回复=怎样翻墙？我也不懂，你教教我嘛

- 你想听[vs=pa]吗？：问题=笑话，回复=你想听笑话吗？

[vs=*p] 调用当前问题星号内容: 如果在问题规则中用到了[vs=*]，星号的序号配合这个指令能把星号匹配的内容调用出来。
[vs=*p1] 对应第1个星号匹配的内容、[vs=*p4] 对应第4个星号匹配的内容。

生效范围：
- 当前回复

示例详解：
- 问题规则= 我叫[vs=*] 回复规则= [vs=*p1]，很高兴认识你 ：问题内容=我叫小五，回复内容=小五，很高兴认识你

- 问题规则= [vs=*]我想到[vs=*]去旅游 回复规则= [vs=*p2]很好玩的哦 ：问题内容=五一我想到深圳去旅游，回复内容=深圳很好玩的哦

- 问题规则= [vs=*]让[vs=*]去买[vs=*] 回复规则= [vs=*p2]买到[vs=*p3]了吗？ ：问题内容=妈妈让小明去买书，回复内容=小明买到书了吗？

- 问题规则= [vs=*]队[vs=*]-[vs=*]击败了[vs=*]队 回复规则= 我就知道[vs=*p4]打不过[vs=*p1] ：问题内容=热火队108-106击败了湖人队，回复内容=我就知道湖人打不过热火

[GetRand] 生成随机数: 生成指定范围的随机数值

生效范围：
- 当前回复

示例详解：
- [vs_function]GetRand(1,100)[/vs_function] =生成1-100的随机数值(包含1和100)

- 我要[vs_function]GetRand(1,5)[/vs_function]个 =我要3个

[GetString] 截取内容: 截取匹配内容中的一部分，完整指令用法：[vs_function]GetString(string, start, length)[/vs_function]

参数列表：
- string 为必填参数，匹配到的字符串，可调用[vs=*p1]、[vs_rx=p1]和[vs=表达式] 等
- start 为必填参数，规定在字符串的第几个字符开始(0是开头第1个字符)，2=从字符串中的第三个字符处开始
- length 为必填参数，规定要返回的字符串长度，3=获取3个字符

生效范围：
- 当前回复

示例详解：
- 问题规则= 身份证号码[vs=身份证号] 回复规则= 您生出于[vs_function]GetString([vs=身份证号], 6, 4)[/vs_function]年 ：问题内容=身份证号码431002198901021513，回复内容=您生出于1989年
- 问题规则= 我叫[vs=*] 回复规则= 你应该姓[vs_function]GetString([vs=*p1], 0, 1)[/vs_function]吧 ：问题内容=我叫李明，回复内容=你应该姓李吧

[vs_role=membercard] 回复会员卡用户: 通过这个指令能判断提问的用户是否为会员卡用户，并能根据相应的身份调用不同的回复。

生效范围：
- 当前问题

示例详解：
- 问题规则= [vs_role=membercard]我是会员[vs=*] 回复规则= 是的，您是我们尊贵的会员

- 问题规则= [vs_role=membercard,0]我是会员[vs=*] 回复规则= 请通过以下方式成为我们会员:xxx

创建上述两条问答(第二个问答为可选，用于非会员回复)被匹配时，会自动判断此用户是否为会员卡用户，如果是会收到回复：是的，您是我们尊贵的会员；非会员将回复另一条：请通过以下方式成为我们会员:xxx

[app_url] 融合第三方平台接口: 有些业务或问题(比如打印图片或签到)想转发给第三方平台或自己开发的接口中来处理，通过此指令可以将用户发送的内容按微信标准接口数据提交到你指定的接口并获取回复内容(标准xml)。

备注：此指令在问答回复、应急回答、接收图片回答和接收语音回答中均能生效。

生效范围：
- 当前回复

参数列表：
- URL 为必填参数
- ToKen 为必填参数

示例详解：
- [vs_function]app_url(http://api.xxx.com, a0c3d)[/vs_function] = 将这段指令直接用到回复内容中，其中的两个参数为第三方平台获取的URL和ToKen

[vs_api_url] 第三方数据接口

通过这个指令可以实现从第三方接口(自己的业务接口)获取数据，比如当用户发送"课程表"或"积分查询"，直接调用指定的URL获取数据并回复(支持文本和xml格式)。
当然，也可以提取问题中的内容做为参数加入到URL中，下面我们会通过一些示例来详细说明。
温馨提示：使用此指令需要有数据接口以及一定的开发能力支持。

生效范围：

- 当前回复

注意事项：

- 此指令必须以 [vs_api_url 开始
- 准备好第三方接口，系统会根据指令配置把参数通过GET传值提交到指定URL
- 系统提交后，将等待接口的返回数据。如果3秒未输出返回，将自动中断并选择提示信息做为回答
- 当前接口返回数据最大长度2000字节(约670个汉字)，编码必须为utf-8
- 可以通过 [vs=pa] 指令提取问题完整内容做为参数加入到URL中
- 如果需要通过 [vs=*p] 指令提取问题匹配内容做为参数，请在问题规则中配置 [vs=*] 指令

指令配置：

- charset：第三方接口使用的编码(utf-8、gb2312或gbk)，我们将把参数转成您设置的编码
- return：第三方接口返回的数据类型支持text和xml

示例详解1(text类型)：

这是一个翻译示例，完整指令如下：
问题规则= 翻译[vs=*]
回复规则= [vs_api_url charset="utf-8" return="text"]https://www.v5kf.com/public/api_url_demo/translate?query=[vs=*p1][/vs_api_url]翻译超时，请稍候重试
- 绿色内容为指令及相关配置
- 蓝色内容为获取数据的第三方URL及相关参数
- 灰色内容为连接超时(3秒)后的提示信息

假设用户输入的问题内容=翻译hello
根据指令规则将对URL的参数赋值：
- query=hello (第1个星号匹配的内容)
- 完整URL=https://www.v5kf.com/public/api_url_demo/translate?query=hello

第三方接口URL获取到这些参数，结合数据接口编写相应的代码就能实现翻译，最终输出结果：你好

示例详解2(text类型)：

这是一个加法运算的示例，完整指令如下：
问题规则= [vs=数值]加[vs=数值]等于
回复规则= [vs_api_url charset="utf-8" return="text"]https://www.v5kf.com/public/api_url_demo/add?num1=[vs=数值p1]&num2=[vs=数值p2][/vs_api_url]获取内容超时，请稍候重试
- 绿色内容为指令及相关配置
- 蓝色内容为获取数据的第三方URL及相关参数
- 灰色内容为连接超时(3秒)后的提示信息

假设用户输入的问题内容=4加3等于
根据指令规则将对URL的参数赋值：
- num1=4 (第1个数值表达式匹配的内容)
- num2=3 (第2个数值表达式匹配的内容)
- 完整URL=https://www.v5kf.com/public/api_url_demo/add?num1=4&num2=3&formula=4加3等于

第三方接口URL获取到这些参数，编写相应的代码就能实现加法运算，最终输出结果：7

示例详解3(xml类型)：

支持公众平台官方特定的xml结构，当前可以回复文本、图文和语音。参考微信消息接口

问题规则= 点歌[vs=*]
回复规则= [vs_api_url charset="utf-8" return="xml"]https://www.v5kf.com/public/api_url_demo/music?song=[vs=*p1][/vs_api_url]获取内容超时，请稍候重试
- 绿色内容为指令及相关配置
- 蓝色内容为获取数据的第三方URL及相关参数
- 灰色内容为连接超时(3秒)后的提示信息

假设用户输入的问题内容=点歌hello
根据指令规则将对URL的参数赋值：
- query=hello (第1个星号匹配的内容)
- 完整URL=https://www.v5kf.com/public/api_url_demo/music?song=hello

第三方接口URL获取到这些参数，根据自身业务需求编写相应代码最终返回xml结构的数据：

回复音乐消息

<xml>
	 <MsgType>music</MsgType>
	 <Music>
		 <Title>音乐DEMO</Title>
		 <Description>XML音乐接口测试</Description>
		 <MusicUrl>https://static.v5kf.com/files/psd/10000/simple.mp3</MusicUrl>
		 <HQMusicUrl></HQMusicUrl>
	 </Music>
</xml>

参数	描述
MsgType	music
Title	标题
Description	描述
MusicUrl	音乐链接
HQMusicUrl	高质量音乐链接，WIFI环境优先使用该链接播放音乐

回复更多类型(文本、单/多图文和语音) 请参考微信消息接口

[vs_lbs] LBS定位: 通过这个指令可以根据微信用户发送的地理位置来自定义回复。
在编辑问答的页面点击 LBS定位 按钮即可打开地图，移动到你要设置的位置并点击确定，会生成类似这样的完整指令： [vs_lbs=114.067421,22.546159,500]。
- 114.067421=位置经度
- 22.546159=位置纬度
- 500=有效范围 (单位：米，此范围内都将被匹配)

生效范围：
- 当前问题

示例详解：
- 问题规则= [vs_lbs=114.072021,22.546159,10000] 回复规则= 好巧哦，我也在深圳市福田区哦 ：把位置设置到深圳市民中心附近，有效范围设置到10公里，几乎能覆盖深圳市福田区的每一个角落。

- 上一句问题= 吃什么 当前问题= [vs_lbs=114.061381,22.540278,200] ：假设之前已经培训了问题"吃什么"和回复"请发送您的位置"的问答，当前问答可结合上下文实现各区域位置的美食推荐。

高级培训指令

生效范围：

示例详解：

生效范围：

信息列表：

匹配示例(在问题中编辑)：

调用示例(在回复中编辑)：

生效范围：

示例详解：

生效范围：

示例详解：

通用表情(网页客服与微信平台)：

微信专用表情：

生效范围：

示例详解：

生效范围：

示例详解：

生效范围：

示例详解：

生效范围：

信息列表：

生效范围：

示例详解：

生效范围：

示例详解：

生效范围：

示例详解：

生效范围：

示例详解：

生效范围：

示例详解：

生效范围：

示例详解：

生效范围：

示例详解：

参数列表：

生效范围：

示例详解：

生效范围：

示例详解：

生效范围：

参数列表：

生效范围：

注意事项：

指令配置：

示例详解1(text类型)：

示例详解2(text类型)：

示例详解3(xml类型)：

回复音乐消息

生效范围：

示例详解：