<br> [**点此进入芝麻小客服官网**](https://xiaokefu.com.cn/?source=kanyun_t_mia ) <br>>本功能仅支持小游戏及小程序。 注意:**由于打开客服回复触发条件苛刻,不建议再使用。** ### **一、打开客服自动回复API** > ***提醒:打开客服回复,因小程序官方规则的更改,需用户主动发过消息,再次打开客服时自动回复功能才会生效,如果你希望第一次进入就触发,请使用带参数的收到消息回复。*** 通过客服API可以自由灵活的设置客服回复的内容和类型,目前主要有下面三种打开客服自动回复类型: 相关参考文档:[进入会话消息;客服会话按钮](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/customer-message/receive.html)(注意:sesion-from最大字符串长度为1024,超过1024会被截取,导致json出错) > **注意:sesion-from最大字符串长度为1024,超过1024会被截取,导致json出错** 图文回复: ``` <button open-type='contact' session-from='{"type": "image", "title": "点此进入", "url": "mp.weixin.qq.com ", "desc": "关注【芝麻小客服】获取更多粉丝福利", "img": "http://qq.com/test-not-found-img.png"}'> 图文消息,关注我们</button> ``` 效果: ![](https://box.kancloud.cn/9a01bae71a7747029ca7a0263cdbf838_300x180.png) 文字回复: ``` <button open-type='contact' session-from='{"type": "text", "title": "您好,欢迎光临"}'>自动回复标题</button> ``` 效果: ![](https://box.kancloud.cn/f00b78e6ca0236646bb77744f818a131_300x180.png) 网址回复: ``` <button open-type='contact' session-from='{"type": "url", "title": "点击进入官网", "url": "http://xiaokefu.hotapp.cn"}'>自动回复打开网址</button> ``` 效果: ![](https://box.kancloud.cn/e612cf6b35f13efc0c4e7caf8f5f84de_300x180.png) ### **二、带参的打开客服自动回复** 带参数的客服回复,需要使用的小程序客服消息参数:SessionFrom,即开发者在客服会话按钮设置的session-from属性; 开发者可以根据不同的客服入口,设置不同的session-from。应用场景如:售前客服/售后客服;进入不同的店铺,可联系到不同的客服人员,方便运营管理,促进销售转化。 带参客服适合运营人员根据工程师的设置的客服按钮参,配置自动回复内容; **使用步骤** **1、在客服按钮上加参数名** > **注意:sesion-from最大字符串长度为1024,超过1024会被截取,导致json出错** open_param 对应的就是参数名,可以设置昵称和头像参数,如下图,设置为11,然后可以设定对应的回复内容 ``` <button type='default' session-from='{"nickName":"test","avatarUrl":"http://t-1.tuzhan.com/bccb9e3e60c5/p-2/l/2013/10/28/17/bd83f0fa80744eb9bf9cf68cf04997aa.jpg","open_param":"11"}' open-type="contact" >客服带参回复(固定头像)</button> ``` 以下代码 只能在设置为自动回复类型为网址的时候使用("params":"a=1&b=2") ``` <button type='default' session-from='{"nickName":"{{userInfo.nickName}}","avatarUrl":"{{userInfo.avatarUrl}}","open_param":"11","params":"a=1&b=2"}' open-type="contact" >客服带参回复(带头像)</button> ``` **2、填入参数名和其他对应内容即可** 比如上面对应的参数名是11,则新建一个参数名为11的带参数的回复; ![](https://box.kancloud.cn/94366f3a92d9468211da10d5e3607c54_638x414.png) 你可以添加多个带参回复: ![](https://box.kancloud.cn/a3824480a89b0bc31529ea05a610e1b2_680x298.png) ## 打开客服回复部分关闭部分开启 小客服后台可以关闭所有客服按钮的打开客服回复功能,也可以只关闭部分按钮的打开客服回复功能。一般情况下,通过小客服后台关闭后,所有的按钮均关闭打开客服回复。但也可以自定义在客服消息带参按钮session-from属性中添加open\_reply参数实现部分按钮关闭打开客服回复。 ## 全部关闭 查看所有类型的回复,取消选择后保存; ![](https://box.kancloud.cn/5965816684dcf46b5b9a8d60c90de411_866x426.png) ## 部分关闭 部分按钮关闭打开客服回复:先在小客服后台-开启打开客服回复,再通过在客服消息带参按钮设置session-from属性参数"open\_reply":"off"关闭 ### 使用步骤: 1.在小客服后台-打开客服回复开启 ![](https://box.kancloud.cn/114e6db347b50518b8c2a8dfa1c5c35b_872x418.png) 2.在客服消息带参按钮设置session-from属性添加参数"open_reply":"off"。如果需要开启,修改值为on,或使用默认不添加此参数即可; 比如: 开启的代码: ``` <button type='default' session-from='{"nickName":"{{userInfo.nickName}}","avatarUrl":"{{userInfo.avatarUrl}}","open_reply":"on"}' open-type="contact" >打开客服回复按钮</button> ``` 关闭的代码: ``` <button type='default' session-from='{"nickName":"{{userInfo.nickName}}","avatarUrl":"{{userInfo.avatarUrl}}","open_reply":"off"}' open-type="contact" >关闭打开客服回复按钮</button> ``` 3.效果: 小客服后台开启了打开客服回复,但能在不同按钮上关闭或打开客服回复。 ![](https://box.kancloud.cn/ab0e7d6632ced7b2f5d4e7270631e8a8_238x103.png) 效果图:9:21分为关闭了打开客服自动回复的效果,9:47分为开启了打开客服自动回复的效果; ![](https://box.kancloud.cn/6b0098a2964ecb30d9f8789bf4db59a8_389x210.png) 注意:一旦传递了参数,如果再从没有传递参数的入口进去,还会是默认的原参数,如果需要某些入口触发默认回复,请传递空参数(空session-from)。 </h> </h> <br> <br> <br> <br><br> [**点此进入芝麻小客服官网**](https://xiaokefu.com.cn/?source=kanyun_b_mia ) 您有问题需要咨询的话,可以扫描下方二维码: </h> ![](https://img.kancloud.cn/04/a1/04a1fd65b5f5cfbc32ad431a32fabd2a_200x199.png) </h> </h>