PC端接入道道客服

1、PC网站接入客服

页面接入需要两步:
第一步 引入 js脚本
第二步 绑定dom元素

示例:
<html>
<head></head>
<body>

<ul class="layui-fixBlock">
    <li class="chat_btn" accountid="${(loginAccount.id)!}" company="<#if (loginAccount.company)??>#{loginAccount.company}</#if>" style="background-color:#9F9F9F"><img style="width:49px;height:49px;" src="${request.contextPath}/img/chat.png" /></li>
</ul>

</body>
<script src="http://workbench.daokf.cn/kf/customer/daodao_kf" type="text/javascript"></script>
</html>

备注: 绑定class名必须为: chat_btn

自定义标签 company 为必传项 。需传入道道客服绑定的账户标识,可在客服管理系统 > 第三方接入 接口设置里获取。

自定义标签 accountid 为业务网站登录用户的id,非必传,若要同步登录用户信息至客服系统,此项必传。

网站登录的用户信息及订单信息可按照以下接口要求接入:(开发好的接口需 在客服管理模块 > 第三方接入的接口设置里 进行url配置,方能生效。)

2.客户信息接口

2.1 提供客户信息

url:${contextPath}/user_info

method:GET

说明:${contextPath}部分由实现方提供给客服系统。

参数:

参数 类型 是否必须 说明
accountId String 业务系统中客户的唯一性标识。
openId String 对应业务微信公众号中的openid。accountId 、openId必有一个存在。

返回值(UserInfo对象的Json字符串):

UserInfo对象:

属性 类型 说明
name String 客户名。
accountId String 业务系统中客户的唯一性标识。
openId String 对应业务微信公众号中的openid。
gender int 性别,0:男, 1:女, 2:其他。
avatar String 头像地址。
tags String 标签,字符串数组的JSON字符串。

例如:

{

"name": "Monet",

"accountId": "35",

"openId": "Gh717288njsx_ss901",

"gender": 0,

"avatar": " http://www.ooqiu.com/uploads/allimg/170516/1494924547857209.jpg",

"tags": "[\"vip\", \"new\"]"

}

2.2 提供客户订单信息

url:${contextPath}/user_orders

method: GET

说明:${contextPath}部分由实现方提供给客服系统。

参数:

参数 类型 是否必须 说明
accountId String 业务系统中客户的唯一性标识。

返回值(Order对象列表的Json字符串):

Order对象:

属性 类型 说明
orderNo String 业务系统中订单的唯一性标识。
accountId String 业务系统中客户的唯一性标识。
price String 订单总价。
createTime String 订单创建时间。
payTime String 订单支付时间。
status String 订单状态。
items List<Item> 订单商品信息项列表。

Item对象:

属性 类型 说明
name String 商品名称。
price String 商品单价。
count String 购买的数量。
img String 商品图片。
url String 商品链接。
subtotal String 小计。

例如:

[

{

"orderNo": "201707310918920001",

"price": "6600 金币",

"status": "信使正在运送",

"createTime": "2017-07-31 09:18", "payTime": "2017-07-31 09:18", "accountId": "35",

"count": "2",

"items": [

{

"name": "绿鞋",

"price": "3250 金币",

"count": "2",

"subtotal": "6500 金币",

"img": "http://img4.cache.netease.com/photo/0031/2015-09-11/B37P8IJL49310031.jpg"

},

{

"name": "瓶子",

"price": "100 金币",

"count": "1",

"subtotal": "100 金币",

"img": "http://i0.hdslb.com/video/97/97ce529d855820b2c39b49172cfade1b.jpg"

}

]

}

]

2.3 更新客户信息

url:${contextPath}/update_user

method: POST

说明:${contextPath}部分由实现方提供给客服系统。

参数:

参数 类型 是否必须 说明
accountId String 业务系统中客户的唯一性标识。
data String 需要更新的属性名-值Map的JSON字符串,如:data={"tags":"[\"t1\",\"t2\","t3\"]"}表示将客户的tags设置为t1, t2, t3。

data数据举例:

{

“tags”: “[\”player\”, \”mvp\”]”

}

返回值:返回Result对象的JSON字符串。

Result对象:

属性 类型 说明
code int 0表示陈功,其他为错误代码。
msg String 错误信息。

例如:

{

"code": 0,

"msg": ""

}

Copyright © Sodo Tech 2014-2018 all right reserved,powered by Gitbook最后更新: 2021-04-21 10:49

results matching ""

    No results matching ""