[vs_api_url]

 

解释：此指令可以调用第三方接口（或自己数据库）中的数据。

使用范围：回复

 

比如客户想查他的话费剩下多少，发送：余额，系统就会根据指令，到数据库中调取余额信息，再将获取到的数据返回给客户；

另外，还可以提取客户问题中的内容作为参数加入到 URL 中，下面我们将通过一些示例来详细解说。

 

PS：此指令的使用需要有数据接口以及一定的开发能力支持。

 

注意事项：

- 此指令必须以 [vs_api_url 开始

- 准备好第三方接口，系统会根据指令配置，把参数通过 GET 传值，提交到指定 URL

- 系统提交后，将等待接口的返回数据，若 3 秒未返回数据，将自动中断并发送提示信息

- 接口的返回数据最大长度 2000 字节（约 666 个汉字），字符编码 charset 必须为 utf-8

- 可以使用 [vs=pa] 指令，提取问题中的所有内容作为参数添加到 URL 中

- 若要使用 [vs=*p] 指令，提取问题中的部分内容作为参数，需在问答中置 [vs=*] 指令（查看[vs=*p]指令的使用详情）

 

指令配置：

- return：第三方接口返回的数据类型支持 text 和 xml

- 绿色内容为指令及相关配置 

- 蓝色内容为获取数据的第三方 URL 及相关参数 

- 灰色内容为连接超时（3 秒）后的提示信息

 

【示例 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]翻译超时，请稍候重试

 

【可匹配场景】

客户问：翻译 hello

机器人答：你好

 

根据指令规则对 URL 的参数赋值：query=hello

完整的 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]获取内容超时，请稍候重试

 

【可匹配场景】

客户问：4 加 3 等于

机器人答：7

 

根据指令规则对 URL 的参数赋值：num1=4，num2=3

完整的 URL：https://www.v5kf.com/public/api_url_demo/add?num1=4&num2=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]获取内容超时，请稍候重试

 

【可匹配场景】

客户问：点歌 hello

机器人回复音乐消息

 

根据指令规则对 URL 的参数赋值：query=hello

完整的 URL：https://www.v5kf.com/public/api_url_demo/music?song=hello

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