技能组管理 · 中通天鸿开发者平台

添加技能组接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/queue/add

接口参数

参数	说明	备注
que_name	技能组名称	`必须`
que_num	技能组编号	可选
que_tag	队列描述	可选
que_type	技能组类型（1、呼入 2、呼出 3、呼入呼出）	默认1
que_length	最大排队数	可选
que_time	排队时长	可选
ring_time	坐席振铃时长	可选
next_wait	分配等待时长	可选
b_announce	是否报工号	可选
noans_times	坐席无应答次数	可选
noans_wait	坐席无应答时长	可选
wait_audio	技能组等待音	可选
noans_action	坐席无应答操作	默认1
que_strategy	技能组分配策略（1、最长等待时间 2、技能组高优先）	默认1
que_priority	技能组优先级，数字越小优先级越高，最大255，最小0	`必须`

结果编码说明

code	说明
401	企业代码为空
402	企业代码不存在
403	技能组名称为空
404	技能组已经存在
405	技能组号已经存在
406	重载失败
407	技能组数量达到上限
408	技能组优先级的值为0-255之间数字
409	添加技能组失败
200	ok

结果示例

{'code':200,'msg':'ok'}

修改技能组接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/queue/update

接口参数

参数	说明	备注
que_id	技能组id	`必须`
que_name	技能组名称	`必须`
que_num	技能组编号	可选
que_tag	队列描述	可选
que_type	技能组类型（1、呼入 2、呼出 3、呼入呼出）	默认1
que_length	最大排队数	默认10
que_time	排队时长	默认120
ring_time	坐席振铃时长	默认30
next_wait	分配等待时长	默认5
b_announce	是否报工号	可选
noans_times	坐席无应答次数	默认3
noans_wait	坐席无应答时长	默认10
wait_audio	技能组等待音	可选
noans_action	坐席无应答操作	默认1
que_strategy	技能组分配策略（1、最长等待时间 2、技能组高优先）	默认1
que_priority	技能组优先级，数字越小优先级越高，最大255，最小0	`必须`	0

结果编码说明

code	说明
401	企业代码为空
402	企业代码不存在
403	技能组名称为空
404	技能组不属于该企业
405	技能组已经存在
406	编辑技能组失败
407	重载失败
408	技能组优先级的值为0-255之间数字
409	技能组号已经存在
200	ok

结果示例

{'code':200,'msg':'ok'}

删除技能组接口

接口地址

GET http://m.icsoc.net/v2/wintelapi/queue/delete

接口参数

参数	说明	备注
que_id	技能组ID	`必须`
flag	`验证技能组下是否有坐席	`必须`

结果编码说明

code	说明
401	企业代码为空
402	企业代码不存在
403	技能组不属于该企业
404	技能组下面有坐席
405	删除技能组失败
406	重载失败
407	技能组id为空
410	技能组下面有坐席登陆
500	总结果

结果示例

{'code':500,'message':'总结果','data':[{'code':410,'message':'技能组下面有坐席登陆','que_id':'呼入呼出组'}]}

获取技能组数据接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/queue/list

接口参数

参数	说明	备注
info	筛选条件：{"filter":{"que_id":2,"keyword":"呼入组"}}	可选

结果编码说明

code	说明
401	企业代码为空
402	企业代码不存在
403	技能组不属于该企业
404	info格式非json
200	ok

结果示例

{"code":200}

技能组分配坐席

接口地址

POST http://m.icsoc.net/v2/wintelapi/queue/assign

接口参数

参数说明	备注
que_id	技能组ID	`必须`
agents	分配的坐席ID集合 json数组 [{"ag_id":坐席ID,"skill":技能水平}]	`必须`

结果编码说明

code	说明
401	企业代码为空
402	企业代码不存在
403	技能组不属于该企业
404	技能组ID为空
405	agents非JSON格式
406	ag_id 不属于该企业
407	坐席已经分配技能组
408	分配失败
409	agents参数为空
500	总结果

结果示例

{"code":409,"message":"agents参数为空"}

取消已分配的技能组坐席

接口地址

POST http://m.icsoc.net/v2/wintelapi/queue/cancel_assign

接口参数

参数	说明	备注
que_id	技能组ID	`必须`
agents	分配的坐席ID集合 [100031,100032]	`必须`

结果编码说明

code	说明
401	企业代码为空
402	企业代码不存在
403	技能组不属于该企业
404	技能组ID为空
405	agents参数为空
406	agents非JSON格式
200	ok

结果示例

{"code":403,"message":"技能组不属于该企业"}

修改技能组底下坐席得技能水平

接口地址

POST http://m.icsoc.net/v2/wintelapi/queue/update/skill

接口参数

参数	说明	备注
que_id	技能组ID	`必须`
is_transaction	如果是1 agents里面只要有一个不符合条件就统一修改失败,0的话就跳过不符合条件的，会在errMessage中体现不符合的数据	`否，默认是1`
agents	分配的坐席ID集合 [{"ag_id":坐席ID,"skill":技能水平}] or [{"ag_num":坐席工号,"skill":技能水平}]	`必须`

结果编码说明

code	说明
200	ok
401	企业代码为空
402	企业代码不存在
403	技能组不属于该企业
404	技能组ID为空
405	agents非JSON格式
406	ag_id 不属于该企业
407	技能组下没有该坐席
500	系统异常

结果示例


curl -X POST \
  http://m.icsoc.net/v2/wintelapi/queue/update/skill \
  -H 'Authorization: Bearer 295b77aeac733875236e12630a9570xxadv' \
  -H 'Postman-Token: 768b5d7e-a360-4679-a72f-cc50d8a649c2' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -F que_id=962 \
  -F 'agents=[{"ag_id":1024841,"skill":101},{"ag_id":1024842,"skill":100}]'
  
{"code":200,"message":"ok"}

有不符合条件的
{
    "code": 200,
    "message": "ok",
    "errMessage": [
        {
            "ag_id": 12,
            "skill": 100,
            "message": "坐席不属于该企业"
        }
    ]
}

获取技能组底下坐席

接口地址

GET http://m.icsoc.net/v2/wintelapi/queue/get/agents

接口参数

参数	说明	备注
que_ids	技能组ID 多个id用","逗号隔开	`必须`

结果编码说明

code	说明
401	企业代码为空
402	企业代码不存在
405	que_ids格式不正确
200	ok

结果示例


curl -X GET \
  'http://m-test.icsoc.net/v2/wintelapi/queue/get/agents?que_ids=206,266' \
  -H 'Authorization: Bearer 5bd0c32980134759f6aed75c269468b0eb353bde' \


{
    "code": 200,
    "message": "ok",
    "data": {
        "206": [ #技能组ID
            {
                "ag_id": "1024465",#坐席ID
                "skill": "0", #技能水平
                "ag_num": "1327" #坐席工号
            },
            {
                "ag_id": "1024422",
                "skill": "0",
                "ag_num": "3636"
            }          
        ],
        "266": [
            {
                "ag_id": "1024422",
                "skill": "0",
                "ag_num": "3636"
            },
            {
                "ag_id": "1024504",
                "skill": "0",
                "ag_num": "456792"
            }
        ]
    }
}