|  开放平台
1
新页面聊天框效果

客户在新的网页上与客服进行沟通,如下图所示:

新页面版在线客服页面
2
为企业网站添加在线客服功能

注册平安客服云后会自动为企业生成唯一的网页IM地址,企业只需要将改地址复制到企业网站即可。

复制链接地址 > 粘贴至企业网站 > 完成

为企业网站添加在线客服功能

如要将在线客服的入口放在网站的如下图位置,只需把复制的链接地址粘贴至网站的相应代码中。

为企业网站添加在线客服功能
3
自定义参数

如企业想要在链接中传入业务参数,需按照以下标准开发,在网页IM的链接中传递相关参数。

默认参数:

参数名 描述
eid 企业id
channel 渠道号
authorizerAppid 业务id

自定义参数(非加密版):

参数名 描述 是否必填
cid 企业识别客户的唯一id
headimgurl 头像
nickname 昵称
sex 性别(F/M)
mail 邮箱
tel 电话
msgInfo 首次打开IM发给坐席的inbound消息
productInfo 商品信息,示例:{"url":"商品链接","image":"商品图片链接","title":"商品标题","description":"商品描述"}
entryData 用户标签,小安机器人可以根据此标签同一问题返回不同答案
customerGrade 客户等级只能传A、B、C、D、E大写字母,支持最多五个等级

默认参数为自动生成的url中自带的参数,不可更改或删除。自定义参数为企业选传的参数,不带自定义参数时为匿名客户。自定义参数中cid为必 传项,为该客户在企业系统中的唯一ID,不传该参数将无法识别此客户。

传参示例:

http://ci-ziker.yun.pingan.com:5000/webim/?msgInfo=nihao&channel=WEBIM&authorizerAppid=webimDmiO4AjVGz7KEA3&eid=6581c81b0d14945da049db5e474d3fbb&theme=07c5ba&cid=100419&headimgurl=http://wx.qlogo.cn/logo.jpg&nickname=weixin008&sex=M&mail=dahuanfu896@pingan.com&tel=1561&entryData=vip&customerGrade=A&productInfo={"url": "http://kefu.pingan.com/index.html","image": "http://kefu.pingan.com/images/product_04.jpg","title": "平安客服云-在线客服","description": "¥1899.00元/坐席/年"}

自定义参数(加密版):

参数名 描述 是否必填
productInfo 商品信息,示例:{"url":"商品链接","image":"商品图片链接","title":"商品标题","description":"商品描述"}
entryData 用户标签,小安机器人可以根据此标签同一问题返回不同答案
encryptData 对cid,headimgurl,nickname,sex,mail,tel,msgInfo等字段进行加密
customerGrade 客户等级只能传A、B、C、D、E大写字母,支持最多五个等级

加密示例:

node版加密写法:
import crypto from 'crypto';
var data = "cid=10049&nickname=111";
var encipher = crypto.createCipheriv('aes-128-cbc', (secretKey||__secretKey__), __iv__);
var encryptData = encipher.update(data, 'utf8', tp) + encipher.final(tp).toLowerCase();
secretKey为企业管理端中企业中心的secretKey密钥,data包含cid,headimgurl,nickname,sex,mail,tel,msgInfo等参数,利用加密算法得到的encryptData即为加密参数。

传参示例:

http://ci-ziker.yun.pingan.com:5000/chatboard/im.min.js?channel=WEBIM&authorizerAppid=webimteVGMOZtmato3O2&eid=6581c81b0d14945da049db5e474d3fbb&theme=07c5ba&style=PLUS&language=EN&guide=1&encryptData=b29302832a0ec841f2d427fa16505974951836438101cffb9b2df3e902bf2130&entryData=vip&customerGrade=A&productInfo={"url": "http://kefu.pingan.com/index.html","image": "http://kefu.pingan.com/images/product_04.jpg","title": "平安客服云-在线客服","description": "¥1899.00元/坐席/年"}

坐席工作台上相应看到的内容如下图:

客服看到在线客户信息页面展示