微信函数命令

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

生效范围：
- 上一句问题
- 上一句回复
- 当前问题
[vs=表达式] 匹配表达式
这个指令跟[vs=*]功能很相似，但它能按指定类型、规则的内容去精确匹配，如：邮箱地址和手机号码等。

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

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

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

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

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

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


调用示例(在回复中编辑)：
- 问题规则= [vs=电邮地址] 回复规则= 我们将尽快把方案发送到[vs=电邮地址] ：问题内容=test@https://www.sodocs.net/doc/c82988538.html,，回复内容=我们将尽快把方案发送到test@https://www.sodocs.net/doc/c82988538.html,

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

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

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

备注：除了坐标位置，其他表达式都可以填写多个，并结合 p+序号（如：[vs=手机号码p1]、[vs=手机号码p2]） 调用相应位置的内容
[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链接(比如：https://www.sodocs.net/doc/c82988538.html,/web/help.html)是不太友好的体验，可以用此指令实现文字链接(比如：查看帮助)。

生效范围：
- 当前回复

示例详解：
- [URL="https://www.sodocs.net/doc/c82988538.html,"]点击这里[/URL]：点击这里

[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=mn] 对话开场白
大家都在打听，微信开场白只能在粉丝关注时发送，能不能每次打开对话再发送一次呢？恭喜你，现在可以通过指令[vs=mn]来实现。
同一个用户如果在半小时内没有发送消息，下一条消息(无论用户发送什么内容)就会打开新对话从而触发[vs=mn]。

生效范围：
- 当前问题

示例详解：
- 问题规则= [vs=mn] 回复规则= 欢迎回来 ：问题

内容=好忙啊，回复内容=欢迎回来

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


[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击败了湖人队，回复内容=我就知道湖人打不过热火



[vs_api_url] 第三方数据接口
通过这个指令可以实现从第三方接口获取数据，比如当用户发送“课程表”，直接调用指定的URL获取数据并回复。
当然，也可以提取问题中的内容做为参数加入到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或json)，当前仅支持text

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

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

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

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

假设用户输入的问题内容=4加3等于





[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] ：假设之前已经培训了问题"吃什么"和回复"请发送您的位置"的问答，当前问答可结合上下文实现各区域位置的美食推荐




[vs_function] 函数调用
在回复内容中，配置这类指令可以调用到系统的内置函数，如：天气、笑话、淘宝客 等。

1. GetWeather([城市名]) - 天气
- 城市名 为选填参数

示例详解：
- [vs_function]GetWeather()[/vs_function] = 网页客服系统直接回复天气，微信公众号将询问查哪个地方的天气

- [vs_function]GetWeather(深圳)[/vs_function

] = 直接回复该城市最近三天的天气


2. GetJoke([分类名, 个数]) - 笑话
- 分类名 为选填参数
- 个数 为选填参数(1-10)

示例详解：
- [vs_function]GetJoke()[/vs_function] = 直接回复一个随机笑话

- [vs_function]GetJoke(,5)[/vs_function] = 分类名可以留空，随机回复5个笑话

- [vs_function]GetJoke(冷笑话, 3)[/vs_function] = 随机回复3个"冷笑话"


3. TaoBaoKe(商品名, [排序]) - 淘宝客
- 商品名 为必填参数
- 排序 为选填参数(0-11)

排序列表：
- 0 = 默认排序
- 1 = 价格从高到低
- 2 = 价格从低到高
- 3 = 信用等级从高到低
- 4 = 佣金比率从高到低
- 5 = 佣金比率从低到高
- 6 = 成交量成高到低
- 7 = 成交量从低到高
- 8 = 总支出佣金从高到低
- 9 = 总支出佣金从低到高
- 10 = 商品下架时间从高到低
- 11 = 商品下架时间从低到高

示例详解：
- [vs_function]TaoBaoKe(牛仔裤)[/vs_function] = 获取"牛仔裤"商品列表

- [vs_function]TaoBaoKe(ipad, 2)[/vs_function] = 获取"ipad"商品列表，并按价格从低到高显示

- [vs_function]TaoBaoKe([vs=*p1])[/vs_function] = [vs=*p1]对应问题中第1个星号的内容，比如："我要买[vs=*]" 你懂的

相关配置：
配置淘宝客信息并获取佣金

4. NoteStart(信息...) - 留言
- 信息... 为必填配置参数(1-N个)

信息列表：
- 姓名
- 性别
- 手机/电话
- Email
- QQ
- 详细地址
- 留言内容

示例详解：
- [vs_function]NoteStart(姓名,Email,手机/电话,留言内容)[/vs_function] = 按顺序提示用户依次输入相关信息

- 欢迎进入留言功能[vs_function]NoteStart(QQ,留言内容)[/vs_function] = 指令前面的文字将作为留言触发时的提示



微信淘函数
设置店铺信息并添加了商品及分类，就可以在回复内容中调用微信淘的专用函数，如：生成链接、图文展示商品 等。

1. TbLink(链接文字, 跳转模块, [编号]) - 生成微信淘网页链接
- 链接文字 为必填参数，如：点击进入微信淘
- 跳转模块 为必填参数：首页、分类
- 编号 为选填参数，分类编号(此编号请到商品分类中获取)

示例详解：
- [vs_function]TbLink(点击进入微信淘首页, 首页)[/vs_function] = 生成首页链接，点击可进入

- [vs_function]TbLink(点击进入最新商品, 分类, 2)[/vs_function] = 生成链接，点击进入分类编号2的商品列表

根据指令规则将对URL的参数赋值：
- num1=4 (第1个数值表达式匹配的内容)
- num2=3 (第2个数值表达式匹配的内容)
- 完整URL=https://www.sodocs.net/doc/c82988538.html,/public/api_url_demo/add?num1=4&num2=3&formula=4加3等于

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

示例详解3：
个别朋友希望用小黄鸡来替换V5官方的问

答，当自己站点培训的问答匹配不上时，调用小黄鸡的回复，完整指令如下：
问题规则= [vs=*]
回复规则= [vs_api_url charset="utf-8" return="text"]https://www.sodocs.net/doc/c82988538.html,/public/api_url_demo/simsimi?query=[vs=pa][/vs_api_url]获取回复超时，请稍候重试

备注：此接口仅做为演示，不排除小黄鸡封IP或V5官方主动撤消