>本功能支持小程序、小游戏及云客服H5。
支持传入的参数包括:
其中来源将显示在对话框顶部:(消息来自:XXX)

其余传入的数据,包括自定义客户字段,都将显示在接待界面客户资料区内;
```
城市:city
省会:province
微信:weixin
电话:mobile 数字
年龄:age 数字
性别:sex 1或2 1是男 2是女
来源:source
备注:note
昵称:nickName
头像地址:avatarUrl
用户ID:openid 你可以通过这个id来指定唯一用户(小程序小游戏无需传入,会自动传的)
标签ID:tag_id
```
### **小程序代码:**
小游戏使用方法类似,请参考[官方文档](https://developers.weixin.qq.com/minigame/dev/api/open-api/customer-message/wx.openCustomerServiceConversation.html)
```
<button type='default' session-from='{"source":"来源","city":"重庆","province":"重庆","weixin":"微信号","mobile":"13275261763","age":"22","sex":"1","note":"备注"}' open-type="contact" >传入参数演示</button>
```
**注意:sesion-from最大字符串长度为1024,超过1024会被截取,导致json出错**
### **云客服H5代码:**
可以使用短连接传入参数,也可以使用长链接(短链接在浏览器内打开后的链接)传入参数;
假如你的长连接(就是渠道链接在浏览器中打开后的链接)为:https://xiaokefu.com.cn/api/mobileweb#/home?channel_id=78&channel_key=7810ic&wechatapp_id=14804;传参后为:
```
https://xiaokefu.com.cn/api/mobileweb#/home?channel_id=78&channel_key=7810ic&wechatapp_id=14804&city=1&province=1&weixin=1&mobile=13555555555&age=1&sex=1&source=1¬e=1&nickName=昵称&avatarUrl=xxxx&openid=XXXXX
```
短连接使用方法(不推荐):在短连接后,直接添加对应的参数;
假如你的短连接为:https://xiaokefu.com.cn/s/1012ivx,传参后为:
```
https://xiaokefu.com.cn/s/1012ivx?city=1&province=1&weixin=1&mobile=13555555555&age=1&sex=1&source=1¬e=1&openid=XXXXX
```
--------
### **自定义客户字段**
如果小客服提供的客户字段不能满足需求,可以使用自定义客户字段功能
功能位置:后台--自定义客户字段

1. 可以设置每个字段的显示隐藏
2. 可以增加、编辑、删除自定义字段;注意:自定义字段一旦增加,只能编辑名称,不能编辑类型、字段ID以及选项。
3. 可以调整显示的位置顺序;
4. 自定义字段可以传递,传递方式跟上面的方法一致。比如某自定义字段ID为:ziduan1、ziduan2;在小程序入口处的传递方式是
```
<button type='default' session-from='{"ziduan1":"字段值1","ziduan2":"字段值2"}' open-type="contact" >传入参数演示</button>
```
H5、插件的传递方式跟原本的传递方式保持一致。
<video style="width: 100%; height: 100%; object-fit: fill" controls="controls" poster="https://box.kancloud.cn/67b3e862f9930f84f9b9629c8aa1dba5_1911x1072.jpg" >
<source src="https://ossxkf.oss-cn-beijing.aliyuncs.com/zidingyiziduan.mp4" type="video/mp4" />
</video>
--------
### **查看自己传递的参数**
在传递参数后,可以进入网页端后台--客服消息界面内查看传递的参数:
步骤:从传递参数的客服入口内咨询,进入客服消息界面找到咨询者,在右侧资料区底部查看参数:

------
常见问题:
1:小程序传递过来的参数无效?
* 请确认从含有参数的入口点击了客服按钮进入;
* 请确认完全按照我们传递参数的格式,单引号双引号不能变;
* 请确认没有开启云函数的消息推送功能,其中不包含打开客服事件;
2:小程序传递过来的参数为空?
请确认传递过来的变量有值。
- 快速开始
- 微信小程序接入及使用指南
- 抖音及头条小程序接入指南
- 公众号接入及使用指南
- 小游戏接入及使用指南
- 云客服接入及使用指南
- 客服插件接入及使用指南
- 准备
- 注册芝麻小客服账号
- 小程序内添加客服按钮
- 公众号认证与关联小程序
- 接入
- 接入小程序(支持开发中小程序)
- 密码接入小程序
- 接入公众号(认证)
- 密码接入公众号
- 授权接入改密码接入
- 接入小游戏
- 使用云客服H5
- 新增接入
- 授权权限说明
- 开始
- 登录账号及找回
- 绑定推送(手机服务提醒)
- 收发客服消息
- 浏览器提醒
- 使用
- 自动回复
- 打开客服回复
- 关键词回复
- 收到消息回复
- 关注后回复
- 系统客服回复
- 智能引导语
- 智能菜单
- 客服消息群发
- 快捷回复
- 转人工客服
- 访客搜索
- 会话分类
- 客户标签及导出客户资料
- 触发会话设置(仅限公众号)
- 模板消息使用指南(仅限服务号)
- 模板消息选项内使用表情
- 模板消息注意事项(仅限服务号)
- 自定义菜单(仅限公众号)
- 渠道二维码(仅限服务号)
- 公众号素材使用和发送
- 延时推送
- 显示客服头像及昵称(仅限公众号)
- 自动打标签
- 粉丝标签管理(仅限公众号)
- 高级群发(仅限服务号)
- 访客轨迹
- 询前表单
- 强制邀请功能介绍及使用方法
- 发放券码
- 订阅功能(仅限公众号)
- 黑名单管理功能
- 客服及客服消息
- PC网页端客服消息使用介绍
- 小程序客户端使用介绍
- 会话的五种状态列表详细说明
- 添加客服
- 多客服管理
- 客服分组
- 接待人数设置
- 专属客服
- 客服接待规则
- 超时设置
- 客服满意度评价
- 客服数据统计
- 旧版客服数据统计
- 在线离线设置
- 聚合会话模式与独立会话模式的区别
- 显示客服昵称(仅支持公众号)
- 查看同事会话并协助回复
- 角色分级
- 云客服
- 创建渠道
- 渠道设置
- 添加渠道客服
- 渠道客服分配规则
- 芝麻云客服服务使用协议
- 云客服H5使用自己的域名
- 无备案域名使用注意事项
- PC网页客服
- 微信自定义推送
- API
- 客户发送小程序卡片并匹配关键词
- 查看客户咨询来源
- 显示用户的微信头像及昵称
- 指定专属客服接收消息
- 指定客服组
- 同一关键词回复不同内容
- 自动回复带参数的链接
- 带参数的收到消息回复
- 关键词回复API
- 传入客户资料
- 传入客户标签
- 带参数的打开客服回复
- 对接页面
- 开发者模式
- 密码接入获取token的接口
- 根据接口分配
- 客服在线状态接口
- 离线消息推送接口
- 客服消息提醒推送接口
- 统一登录接口
- 客户资料同步接口
- 接口返回值及错误码说明
- 特别帮助
- 客服管理人员特别帮助
- 普通客服特别帮助
- 开发人员特别帮助
- 外包开发者或工作室
- 视频帮助集合
- 购买及发票
- 版本区别及如何选择
- 对公打款
- 申请发票
- 常见问题
- 接入后消息收不到
- 自动回复回复消息收不到
- 提供的服务出现故障,请稍后重试
- 小程序卡片不跳转
- 客服收不到消息
- 后台未设置自动回复,但是客服消息却会自动回复
- 如何使用表情?
- 设置了小程序卡片/链接,没有回复
- 技巧及常见用法
- 引导用户虚拟支付,链接自动添加openid
- 使用智能菜单打造类似WPS公众号关注后效果
- 智能菜单自动匹配关键词及调整顺序
- 根据不同需求,指定不同客服
- 使用转人工客服,减少人工参与
- 给文字加链接,减少回复占用条数
- 使用关键词指定客服,对咨询进行分流
- 转人工+指定客服,实现公众号咨询分流
- 小程序使用云客服H5
- 使用云客服H5来实现多商户功能
- 公众号自定义菜单新玩法
- 服务号如何玩转小客服小卡片功能
- 案例分析:如何玩转客服
- 斗鱼直播小程序
- 小年糕+小程序
- 联动云租车小程序
- 寸心定制公众号/小程序
- 其他
- 删除及更改第三方授权
- 寻找小程序appid
- 如何重新授权或更改接入方式
- 代理帮助
- 如何从零建立一个简易客服小程序
- 服务条款
- 如何清除浏览器cookies
- 换绑管理员或停止使用
- 换绑管理员
- 删除产品
- 停止授权及取消密码接入
- 联系我们
- 程序更新日志