服务端
服务端API文档

呼叫入队

更新时间: 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"
  }
}

错误码

此文档是否对你有帮助?
有帮助
去反馈
  • 呼叫入队
  • URL
  • 请求参数
  • 返回参数
  • 示例
  • 请求示例
  • 正常返回示例
  • 错误码