手机接听(login)
场景描述
手机接听(离线座席),当某座席因某些原因无法在pc端的座席工作台接听客户电话时,该座席可通过设置“手机接听”来绑定座席电话,实现客户打电话能在手机端接听的功能(支持真实可用的号码,比如手机号、座机号)。
接口方法
POST
接口URI
https://域名/apiaccess/rest/cc-management/v1/offline/agent/login
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
X-APP-KEY |
string |
False |
appKey字段,用户标识,请联系运营人员获取appKey |
2 |
Authorization |
string |
True |
鉴权信息,值为Bearer + tokenByAKSK接口的返回值中的AccessToken(Bearer后有空格) |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1.1 |
phone |
string |
True |
进行接听的号码(真实可用的号码,比如手机号、座机号) |
1.2 |
workNo |
number |
True |
座席工号 |
响应说明
- 响应状态码: 200
表3 响应体参数 序号
名称
参数类型
是否必选
说明
1.1
returnCode
string
True
操作结果。0:成功,非0为失败
1.2
description
string
False
提示信息
1.3
restTime
string
False
休息时长,单位秒
1.4
agentType
string
False
座席类型(4:音频座席,5:多媒体座席,11:视频座席,99:全能型座席)
1.5
forceLogin
boolean
False
是否强制签入(true:是,false:否)
1.6
isAutoAnswer
string
False
是否自动应答(true:是,false:否)
1.7
videoMode
number
False
视频应用模式(0:SFU视频,1:MCU视频,2:SFU+MCU视频)
1.8
workNo
number
False
座席工号
1.9
isMultiChannelSupport
boolean
False
是否多渠道签入(true:是,false:否)
1.10
skills
array[object]
False
技能队列列表
1.10.1
skillId
number
False
技能队列ID
1.10.2
mediaTypeId
string
False
媒体类型(5:语音;53:多媒体;19:视频;2:语音点击通话;18:视频点击通话)
- 响应状态码: 401
鉴权失败
- 响应状态码: 404
请求资源不存在
- 响应状态码: 500
服务器内部异常
错误码
无。
报文样例
请求头:
Content-Type:application/json X-APP-KEY:********************* Authorization:Bearer *********************
请求参数:
{"phone":"13800000000","workNo":107}
响应参数:
{ "restTime": "", "agentType": "4", "forceLogin": true, "isAutoAnswer": "true", "description": "success", "videoMode": 0, "workNo": 107, "skills": [ { "skillId": 4, "mediaTypeId": "5" } ], "returnCode": "0", "isMultiChannelSupport": false }