请求说明
```language
{
type : ping(心跳), msg(消息), login(登录), s_readed(客服发送来的已读信号) api(查询操作)
}
login
{
from : user,
old_token : 第三方token,
from_tag : 第三方来源, // 0. 1.网站 2.二手车 3.管家
uuid : 用户唯一标识,
mobile : 1, // 1.是手机端 0.pc端
agent : '', //浏览器标识
fromurl : '', // 来源网址
}
msg
{
token : "", // 用户认证标识
msg : '', // 发送的消息
sendto :'back', // back.用户发送给客户 front.客服发送给客人
group_id : '客服组id',
file_type : 0, // 0.文字 1.图片 2.语音 3.商品 4.订单 5.视频 6.文件
msg_key : '', // 前端判断验证是否发送成功 秒数加随机数
}
api {
controller : 'index' || 'admin'
method : 'getGuestChatList'// 获取用户的聊天列表
{
}
method : 'getGuestChatRecord'// 获取用户与客服的聊天内容
{
group_id : 1, // 客服组id,
page_index : 1, // 页数
page_size : 1, // 页数大小
}
method : 'updateRead'// 刷新已读消息
{
group_id: 1, // 客服组id,
}
method : 'rating'// 服务评价
{
group_id: 1, // 客服组id,
score: 1, // 服务星数,
msg: 1, // 服务建议,
}
}
--------------------common start---------------------
param
{
call_type : 1, // 0.心跳 1.用户连接 3.管理连接 暂时做管理员
}
response code
-9999 // 需要重新登录
--------------------common end---------------------
--------------------登录接口 start---------------------
param
{
api_key : 11000,
call_type :1,
chat_token :'用户登录token', //
uuid : '', // 用户唯一标识 游客必须使用
is_mobile : '', // 0.pc 1.手机
agent : '', // 游览器标识
}
// 响应接口
response
{
api_key : 11000,
data : {
'is_refresh' : 1, // 是否刷新token
'refresh_token' : '', //刷新的token
},
code : 200, // >0成功//
message: '',
status : 'Success',
}
code
-11010 解析token失败
-11011 验证token失败
-11012 数据错误,请重新获取token
-11013 数据错误,请重新获取token
-11014 用户不存在
-11001 添加游客失败,请重新发起
·11002 缺少登录必要参数
--------------------登录接口 end----------------------
```
响应说明
```language
login
{
x : '6',
a : '8',
code : '200' , // >0成功
uuid : '', //用户唯一标识
fn : '用户名称', // 未登录的情况下获取随机名称
chat_list : '聊天列表'
token : '用户登录标识'
------------------------------------------------------------
x : '10', // token验证失败
a : '1',
code : '200' , // >0成功
message : 'token验证失败,重新登录',
}
msg
{
x : '5',
a : '2',
i : 'w', // 聊天信息,
gid : '', // 用户id
msg_key : '验证',
is_admin : 1, // == 1 客服发送给用户的消息
}
api
{
x : 20,
a : 1, // 获取聊天列表
code : 200, // > 0 成功
message : '',
status : '',
chat_list : {
data: [
{
"mid": 19,
"type": 0,
"grid": 1,
"fromid": 4,
"fromname": "客人4",
"toid": 1,
"toname": "管理员",
"msg": "123123213",
"filetype": 0,
"time": 1594957716,
"is_read": 0,
// 客服组信息
"group_info": {
"id": 1,
"from_id": 0,
"belong_uid": 0,
"sort": 1,
"activated": 1,
"groupname": "平台客服组",
"groupname_en": "Default Support Team",
"description": "这是一个默认的客服组",
"is_platform": 1,
"group_img": "" // 客服组图片
},
// 用户信息
"guest_info": {
"gid": 4,
"aid": 1,
"grid": 1,
"oid": 0,
"upload": 0,
"lang": 1,
"kickouts": 0,
"logins": 6,
"last": 1595044836,
"lastip": "127.0.0.1",
"ipzone": "未知",
"browser": "Chrome 78.0.3904.108",
"mobile": 0,
"fromurl": "http://chat.da.com/",
"grade": 0,
"fullname": "哈哈哈",
"address": "",
"phone": "",
"email": "",
"remark": "",
"session": "",
"user_id": 0,
"from_id": 0,
"user_info": []
},
"unread_count": 116, // 未读消息
// 最后一条消息
"last_msg": {
"mid": 193,
"type": 1,
"grid": 1,
"fromid": 4,
"fromname": "管理员",
"toid": 6,
"toname": "",
"msg": "123123", // 消息内容
"filetype": 0,
"time": 1595064320,
"is_read": 0
}
}
],
"total_count": 1,
"page_count": 1,
"count_unread": 116
} // 聊天列表
--------------------------------------------------------------------------------------
x : 20,
a : 2, // 获取聊天内容
code : 200, // > 0 成功
message : '',
status : '',
chat_list : "data": [
{
"mid": 175,
"type": 1, // 0.用户发送 1.客服发送
"grid": 1,
"fromid": 1, // 发送id
"fromname": "管理员", // 发送名
"toid": 4,
"toname": "哈哈哈",
"msg": "123123",
"filetype": 0,
"time": 1595062322,
"is_read": 0,
"group_info": {
"id": 1,
"from_id": 0,
"belong_uid": 0,
"sort": 1,
"activated": 1,
"groupname": "平台客服组", // 客服组名称
"groupname_en": "Default Support Team",
"description": "这是一个默认的客服组",
"is_platform": 1,
"group_img": "" // 客服组头像
}, // 客服组信息
"guest_info": {
"gid": 1,
"aid": 1,
"grid": 1,
"oid": 0,
"upload": 0,
"lang": 1,
"kickouts": 0,
"logins": 6,
"last": 1592288667,
"lastip": "127.0.0.1",
"ipzone": "本机地址",
"browser": "iPhone 15 (safari 11.0)",
"mobile": 1,
"fromurl": "http://loaction.welive.cn/",
"grade": 0,
"fullname": "121",
"address": "",
"phone": "",
"email": "",
"remark": "",
"session": "f6a62f0f3765550e362c34fb8bc97eba",
"user_id": 0,
"from_id": 0,
"user_info": []
}
}
],
"total_count": 164,
"page_count": 164
},// 聊天列表
--------------------------------------------------------------------------------------
x : 20,
a : 3, // 刷新未读消息
code : 200, // > 0 成功
message : '',
status : '',
data : {
group_id : 1,
gid : 1
},
--------------------------------------------------------------------------------------
x : 20,
a : 4, // 服务评价
code : 200, // > 0 成功
message : '',
status : '',
data : {
s : 1
},
}
```