Web/App接入
通过参数传入，将访客的个人信息带入，记录并展示给客服人员和机器人进行进一步交互
1 注册和创建渠道
2 URL格式参考
http://cvd.xiaoduoai.com/c/index.html?src={企业id}&channel_id={渠道id}&key={渠道的key}&nick={昵称}&fromurl={接入网页地址}&tid={用户唯一的id}&faceurl={用户头像地址}&price={商品价格}&title={商品标题}&productimg={商品图片}&thirdpart_params=${encodeURIComponent(JSON.stringify([{key: '顾客信息自定义名称', label: '顾客信息自定义值'}]))}&phone_3rd={电话}&wp_nick_3rd={微信昵称}&sex_3rd={性别}&age_3rd={年龄}
3 参数说明
参数说明
| 参数 | 说明 | 是否必填 |
|---|---|---|
| src | 企业id | 是 |
| channel_id | 渠道id | 是 |
| key | 渠道的key | 是 |
| tid | 用户唯一的id | 否 |
| nick | 用户昵称 | 否 |
| faceurl | 用户头像地址 | 否 |
| phone_3rd | 访客电话 | 否 |
| wp_nick_3rd | 访客微信昵称 | 否 |
| sex_3rd | 访客性别， -1表示女性， 1表示男性 | 否 |
| age_3rd | 访客年龄 | 否 |
| fromurl | 接入网页地址 | 否 |
| title | 商品标题 | 否 |
| price | 商品价格 | 否 |
| productimg | 商品图片 | 否 |
| thirdpart_params | 客服工作台顾客信息区域展示的自定义字段。比如订单号，会员等级等，都可以放在里面。 结构如下： type KVStruct struct { Key string `bson:"key" json:"key"` Label string `bson:"label" json:"label"` } KVStruct 构建一个数组，然后json编码放在这个字段中。 举个例子： thirdpart_params=[{"key":"测试名","label":"测试值"}, {"key":"测试名2","label":"测试值2"}] 只有一个参数. thirdpart_params=[{"key":"测试名","label":"测试值"}] 会员等级的Key: vip_level |
否 |
| removeTopBar | 当 removeTopBar=true 时，不显示顶栏 | 否 |
| refer | 来源页 | 否 |
| chatFrom | 咨询页 | 否 |
| immediatelySendMsg | 进入聊天页面后立即用访客身份发送的文本消息 | 否 |
| user_token | 用户登录的token，用于一次性验证 | 否 |
| mdLinkCard | 点击查看linkCard详细说明, 美的c的链接使用mdLinkCard类型，即mdLinkCard= | 否 |
| ctype | c端类型，比如美的，就填"md" | 否 |
| cotid | 合伙人账号 | 否 |
| isCoTid | 是否是合伙人账号，true或者false | 否 |
注意: 上面这些参数需要urlencode后传递
4 完整URL
http://cvd.xiaoduoai.com/c/index.html?src=15&channel_id=12&key=1e3916388152882324dab168cddd44ee0153f89d8080ab5f73962122cb16caa6&nick=%E6%9D%8E%E5%B0%8F%E8%90%8C&fromurl=http%3a%2f%2fwww.xiaoduotech.com%2f&tid=5465437&faceurl=http%3a%2f%2fcvd-10054209.file.myqcloud.com%2fface%2fface_167387d37d69e9f5.jpeg&price=888.00&title=%E5%B0%8F%E5%A4%9A%E5%AE%A2%E6%9C%8D&productimg=http%3a%2f%2fwww.xiaoduotech.com%2fassets%2fimg%2fhome%2fbanner.png&&thirdpart_params=%5B%7B"key"%3A"测试名"%2C"label"%3A"测试值"%7D%5D&phone_3rd=18215593244&wp_nick_3rd=colourhu&age_3rd=24&sex_3rd=-1
5 接入到App、小程序或其它环境
在App或其它(如小程序等)支持Web View的环境下，都可以通过以上Web网站接入的相同方式接入，在Web View里打开适配移动端的会话界面。
以上参数在App或其它环境下均可生效。
注意：因为App往往需要自带顶栏，请在URL中添加不显示顶栏的参数，即：removeTopBar=true。