更新时间:2024-09-24 GMT+08:00
分享

手机接听(login)

场景描述

手机接听(离线座席),当某座席因某些原因无法在pc端的座席工作台接听客户电话时,该座席可通过设置“手机接听”来绑定座席电话,实现客户打电话能在手机端接听的功能(支持真实可用的号码,比如手机号、座机号)。

接口方法

POST

接口URI

https://域名/apiaccess/rest/cc-management/v1/offline/agent/login

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

X-APP-KEY

string

False

appKey字段,用户标识,请联系运营人员获取appKey

2

Authorization

string

True

鉴权信息,值为Bearer + tokenByAKSK接口的返回值中的AccessToken(Bearer后有空格)

表2 请求体参数

序号

名称

参数类型

是否必选

说明

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
}

相关文档