呼叫入队
更新时间: 2022/08/19 09:06:38
呼叫入队
- 呼叫的请求,可以放入队列中,如果队列中有空闲的坐席,会直接使用空闲坐席进行接听,如果没有空闲坐席,当有空闲坐席的时候,会直接接起入队的呼叫请求,坐席登陆的时候可以填写坐席的入队id
URL
- 请求方法:POST
- URL:
http://voip-host/api/v1/voip/cti/app/acd/queues/callin
请求参数
参数名称 | 类型 | 是否必选 | 示例 | 描述 |
appId | String | 必填 | eca23f68c66d4acfceee77c200200359 | 应用ID。 |
callId | String | 必填 | eca23f68c66d4acfceee77c200200359 | 会话ID。 |
queueServiceId | String | 必填 | 8888 | 队列ID。 |
seatIds | string | 选填 | 100 | 业务方的坐席id,多个坐席使用“,”进行连接,传入坐席id,判断是否能直接转坐席,如果全都不行,才入队。 |
score | int | 选填 | 5 | 权重,0-20,默认为0。 |
timeOutSeconds | int | 选填 | 5 | 超时秒数,取值范围为0-86400,默认为30,最大为一小时。 |
data | string | 选填 | 2 | 透传数据。 |
ignoreSeatStatus | boolean | 选填 | 2 | 是否忽视坐席状态,默认false。 |
queueUpSizeSwitch | boolean | 选填 | 2 | 排队人数是否播报开关,默认false。 |
loopsCount | int | 选填 | 4 | 最大排队次数,默认为3。 |
返回参数
参数名称 | 类型 | 示例 | 描述 |
code | int | 0 | 状态码。 |
message | string | OK | 请求成功或者失败描述信息。 |
data | string | {"tenant":"cleverdj", . . . } | 查询到的数据信息,json格式返回。 |
type | string | 1 | 1:使用了优先客服, 2:使用了队列中的客服,这种场景是发现有空闲坐席所以没入队,3:入队等待。 |
sipAccount | string | 266080000000001 | 当前坐席SIP帐号。 |
sipOfflineSeatIds | string | 8888,777 | 离线坐席列表,多个坐席已“,”隔开。 |
staffId | string | 8888 | 当前选取坐席。 |
示例
请求示例
{
"appId": "appid:eca23f68c66d4acfceee77c200200359",
"callId": "appid:eca23f68c66d4acfceee77c200200322",
"ignoreSeatStatus": false,
"loopsCount": 3,
"queueServiceId": 9999,
"queueUpSizeSwitch": false,
"score": 3,
"seatIds": "8888,7777",
"timeOutSeconds": 100
}
正常返回示例
{
"code": 0,
"message": "OK",
"data": {
"type": 1,
"sipAccount": "266080000000001",
"sipOfflineSeatIds":" 88888,3333",
"staffId":"7777"
}
}
错误码
-
header 中的状态码:
状态码列表请参考 header 中的 HTTP 状态码。 )
-
body 中的错误码(code)
该接口在 HTTP Body 中返回错误码(code),错误码列表请参考业务错误码。
此文档是否对你有帮助?