# 客服话单管理

# 简介

客服话单管理是菊风云平台提供的一项服务。通过该服务,您的服务器可以对客服话单进行管理,从而使您能够在视频双录的基础上增加额外的业务控制。

文档描述基于您已经完成以下工作:

# 查询历史客服话单

# 基本信息

Path: /third_api/ticket/history

Method: GET

接口描述:返回历史视频客服话单相关信息,可根据会议ID,工号,访客名模糊查询,时间范围查询

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

Query

参数名称 是否必须 示例 备注
page 1
size
startTime 起始查询时间
endTime 结束查询时间
mid 会议id

Body

{
   "accountId": ""
}

# 返回数据

{
    "ret": 0,
    "msg": "ok",
    "data": {
        "total": 1,
        "page": 1,
        "current": 1,
        "list": [
            {
                "callId": "105240444207351", //话单id
                "domainId": 100645, //域id
                "mid": 105240444207351, //会议id
                "staffId": "[username:scl@100645.cloud.justalk.com]", //坐席工号
                "status": 5,
                "incomeTimestamp": 1605841740785, //呼入时间
                "ringTimestamp": 1605841742121, //振铃时间
                "answerTimestamp": 1605841796101, //应答时间
                "endTimestamp": 1605842216025, //结束时间
                "endType": 3,  //结束类型
                "waitTime": 55316, //等待时长
                "groupId": "G5",  //技能组
                "businessCode": "10095", //业务号
                "caller": "[username:qwer@100645.cloud.justalk.com]", //访客名
            }
        ]
    }
}

# 查询当前客服话单

# 基本信息

Path: /third_api/ticket

Method: GET

接口描述:返回视频客服话单相关信息,可根据会议ID,工号,访客名模糊查询,时间范围查询

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

Query

参数名称 是否必须 示例 备注
page 1
size
commonStr 通用查询字段(按照会议id,工号,访客名模糊查询)
startTime 起始查询时间
endTime 结束查询时间
status [1,2,3,6,7] (排队,振铃,通话,保持,结束保持) 可多选

Body

{
   "accountId": ""
}

# 返回数据

{
       "ret": 0,
       "msg": "ok" ,
       "data":{
            "total": 0,
            "page": 0,
            "current": 1,
            "list":[
                {
                    "callId": "-1641140631-2020011317h13m38s-491", //话单id
                    "mid": 103475237227778, //会议id
                    "staffId": "[username:yunwen1@100645.cloud.justalk.com]", //坐席工号
                    "incomeTimestamp": 1578906818071, //呼入时间
                    "ringTimestamp": 1578906820504, //振铃时间
                    "answerTimestamp": 1578906824453, //应答时间
                    "endTimestamp": 1578906840367, //结束时间
                    "status": 2, //状态
                    "waitTime": 6382, //等待时长
                    "groupId": "G2", //分组id
                    "businessCode": "10087", //业务号
                    "caller": "[username:guestyw1@100645.cloud.justalk.com]" //访客名
            }]
    }

}

# 服务状态查询

# 基本信息

**Path:**GET HTTP://ip:port/third_api/ticket/history

接口描述:返回历史视频客服话单相关信息,可根据会议id,工号,访客名模糊查询,时间范围查询

# 请求参数

Headers

参数 是否必须 说明
appKey appKey

# 返回数据

{
       "ret": 0
       "msg": "ok" 
"data":[
   {
   "onlineUserNumber": 1在线用户数
   "videoTaskNumber": 20 录像任务数量
    } 
  ]
}