查询通话技能组信息接口说明

1.接口简介

该接口主要用来查询该账号下所有技能组的相关信息,包括技能组中的坐席,技能组名称,技能组编号等

2.接口请求

  • HTTP请求方式:POST

  • 请求链接:{HOST}/v20160818/queue/queryQueue/{ACCOUNTID}?sig={SIG}

  • 请求时请将{HOST}换成对接数据查询中获取到的请求域名,{ACCOUNTID}替换为账户编号,{SIG}是根据鉴权规则生成的,请看鉴权文档,查看具体的生成规则

  • 鉴权方式:接口鉴权

3.接口参数如下:

请求参数:


字段 类型 是否必须 备注
password String 该账户管理员登录用户中心所使用的密码

请求体示例

{
  "password":"123456"
}

4.系统返回

字段 含义
code 响应码
message 响应信息
data 返回数据,JSON格式

data:

字段 含义
DisplayName 技能组的名称
Strategy 技能组的接听策略 rrmemory-轮流,random-随机, leastrecent-距上次接听最久
SayExten 是否启用报工号
JoinEmpty 无空闲座席立即流转 1 是 0 否
BussinessTypeId 来电弹屏对接 id,为空则弹系统默认屏
WaitTime 等待时长
Timeout 振铃时长
ToPeerTypeWhenQueueEmpty 技能组为空时转向:
system-系统节点
ivr_node_queue 技能组
account_user 坐席
ivr_node_announcement 播放语音节点
ivr_node_text_announcement 播放文本语音节点
ivr_node_ivr 按键菜单节点
ivr_node_encrypt_md5 MD5 加密节点
ivr_node_validation 采集输入节点
ivr_node_assignment 赋值节点
ivr_node_route 按变量路由节点
ivr_node_ivr_menu 转 ivr 菜单节点
ivr_node_call_url calurl 节点
ivr_node_voice_mail 留言节点
ivr_node_room 会议室节点
ivr_node_satisfaction 自定义满意度节点
ivr_node_superDialJobNum 采样工号并拨打节点
ivr_node_extension_peer 自定义节点
ToPeerWhenQueueEmpty 具体的节点操作 ID 例如 system 中 0-挂机,1 满意度调 查,2-拨工号
ToPeerTypeWhenWait 正在等待时转向:取值同 ToPeerTypeWhenQueueEmpty
ToPeerWhenWait 具体的节点操作 ID 例如 system 中 0-挂机,1 满意度调 查,2-拨工号
ToPeerTypeWhenWaitTimeout 等待超时转向:取值同 ToPeerTypeWhenQueueEmpty
ToPeerWhenWaitTimeout 具体的节点操作 ID 例如 system 中 0-挂机,1 满意度调 查,2-拨工号
ToPeerTypeWhenHanguped 通话结束后转向:取值同 ToPeerTypeWhenQueueEmpty
ToPeerWhenHanguped 具体的节点操作 ID 例如 system 中 0-挂机,1 满意度调 查,2-拨工号
Account 账户 ID 和调用接口所传 AccountId 一致
PBX PBX
Exten 技能组号
AssignMembers.agentID 已经分配的坐席 Id
AssignMembers.penalty 坐席优先级
AssignMembers.agentName 坐席名称
AssignMembers.agentExten 坐席工号
Members 分配的坐席的 ID 字串 (不用返回)
UpdateTime 技能组信息更新时间
AgentExtenPoint 是否启用报工号后的提示音
SayQueuePosition 播报排队位置时间间隔

code:

代码 含义
200 请求成功
400 请求体参数错误
403 鉴权参数错误
500 服务器错误

返回200示例:

{
"code": 200,
"message": "200 ok",
"data": [
    {
        "DisplayName": "座席",
        "Strategy": "rrmemory",
        "SayExten": false,
        "JoinEmpty": "0",
        "BussinessTypeId": "",
        "WaitTime": "120",
        "Timeout": "30",
        "ToPeerTypeWhenQueueEmpty": "system",
        "ToPeerWhenQueueEmpty": "0",
        "ToPeerTypeWhenWait": "system",
        "ToPeerWhenWait": "0",
        "ToPeerTypeWhenWaitTimeout": "system",
        "ToPeerWhenWaitTimeout": "0",
        "ToPeerTypeWhenHanguped": "system",
        "ToPeerWhenHanguped": "0",
        "Account": "N00000000103",
        "PBX": "bj.ali.7.7",
        "Exten": "10011860",
        "AssignMembers": [
            {
                "agentID": "caaa9680-5e0a-11e6-a2c4-65eaf15cb8fd",
                "penalty": "0",
                "agentExten": "4567",
                "agentName": "4567"
            }
        ],
        "Members": "caaa9680-5e0a-11e6-a2c4-65eaf15cb8fd:0",
        "UpdateTime": "2016-08-09",
        "AgentExtenPoint": false,
        "SayQueuePosition": "0"
    }
]

}

返回210示例:

{
    "code": 210,
    "message": "account or password incorrect"
}

返回400示例:

{
    "code": 400,
    "message": "Please check your parameters"
}

返回403示例:

{
    "code": 403,
    "message": "Forbidden"
}

返回500示例:

{
    "code": 500,
    "message": "Internal Server Error"
}