<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> ``` 效果：  文字回复： ``` <button open-type='contact' session-from='{"type": "text", "title": "您好，欢迎光临"}'>自动回复标题</button> ``` 效果：  网址回复： ``` <button open-type='contact' session-from='{"type": "url", "title": "点击进入官网", "url": "http://xiaokefu.hotapp.cn"}'>自动回复打开网址</button> ``` 效果：  ### **二、带参的打开客服自动回复** 带参数的客服回复，需要使用的小程序客服消息参数：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的带参数的回复；  你可以添加多个带参回复：  ## 打开客服回复部分关闭部分开启 小客服后台可以关闭所有客服按钮的打开客服回复功能，也可以只关闭部分按钮的打开客服回复功能。一般情况下，通过小客服后台关闭后，所有的按钮均关闭打开客服回复。但也可以自定义在客服消息带参按钮session-from属性中添加open\_reply参数实现部分按钮关闭打开客服回复。 ## 全部关闭 查看所有类型的回复，取消选择后保存；  ## 部分关闭 部分按钮关闭打开客服回复：先在小客服后台-开启打开客服回复，再通过在客服消息带参按钮设置session-from属性参数"open\_reply":"off"关闭 ### 使用步骤： 1.在小客服后台-打开客服回复开启  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.效果： 小客服后台开启了打开客服回复，但能在不同按钮上关闭或打开客服回复。  效果图：9：21分为关闭了打开客服自动回复的效果，9：47分为开启了打开客服自动回复的效果；  注意：一旦传递了参数，如果再从没有传递参数的入口进去，还会是默认的原参数，如果需要某些入口触发默认回复，请传递空参数（空session-from）。 </h> </h> <br> <br> <br> <br><br> [**点此进入芝麻小客服官网**](https://xiaokefu.com.cn/?source=kanyun_b_mia ) 您有问题需要咨询的话，可以扫描下方二维码： </h>  </h> </h>