Skip to main content

技能组管理

添加技能组接口

接口地址

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

接口参数

字段类型是否必填示例值说明
que_nameString是专家组技能组名称
que_numString否101技能组编号
que_lengthInteger否10最大排队数
que_timeInteger否120排队时长
ring_timeInteger否30坐席振铃时长
next_waitInteger否5分配等待时长
b_announceInteger否0是否报工号
noans_timesInteger否3坐席无应答次数
noans_waitInteger否10坐席无应答时长
wait_audioString否技能组等待音
noans_actionString否1坐席无应答操作
que_strategyInteger否1技能组分配策略（1、最长等待时间 2、技能组高优先 9、轮询分配）
que_priorityInteger是0技能组优先级，数字越小优先级越高，最大255，最小0
auto_evaluateInteger否1自动转满意度（0、否 1、是，默认 1）

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403技能组名称为空
404技能组已经存在
405技能组号已经存在
406重载失败
407技能组数量达到上限
408技能组优先级的值为0-255之间数字
409添加技能组失败
411技能组分配策略错误
412自动转满意度评价错误
200ok

结果示例

{
    "code": 200,
    "message": "ok",
    "data": {
        "que_id": "249432"
    }
}

修改技能组接口

接口地址

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

接口参数

字段类型是否必填示例值说明
que_idInteger是123技能组id
que_nameString是专家组技能组名称
que_numString否101技能组编号
que_lengthInteger否10最大排队数
que_timeInteger否120排队时长
ring_timeInteger否30坐席振铃时长
next_waitInteger否5分配等待时长
b_announceInteger否0是否报工号
noans_timesInteger否3坐席无应答次数
noans_waitInteger否10坐席无应答时长
wait_audioString否技能组等待音
noans_actionString否1坐席无应答操作：0-不处理；1-示忙
que_strategyInteger否1技能组分配策略（1、最长等待时间 2、技能组高优先 9、轮询分配）
que_priorityInteger是0技能组优先级，数字越小优先级越高，最大255，最小0
auto_evaluateInteger否1自动转满意度（0、否 1、是）

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403技能组名称为空
404技能组不属于该企业
405技能组已经存在
406编辑技能组失败
407重载失败
408技能组优先级的值为0-255之间数字
409技能组号已经存在
411技能组分配策略错误
412自动转满意度评价错误
200ok

结果示例

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

删除技能组接口

接口地址

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

接口参数

字段类型是否必填示例值说明
que_idInteger是123技能组id
flagInteger否1验证技能组下是否有坐席(1：不验证是否有坐席，0：验证是否有坐席，默认 0)

结果编码说明

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

接口参数

字段类型是否必填示例值说明
infoString否{ "filter":{"que_id":2,"keyword":"呼入组"} }筛选条件

info 参数说明

字段类型是否必填示例值说明
que_idInteger否123技能组ID
keywordString否呼入组关键字

出参

字段类型必填说明
codeint是200 为成功，其它为失败
messagestring是
totalstring是总条数
totalPageint是总页数
data.que_namestring是技能组名称
data.que_tagstring是固定值：0，已废弃，无实际意义
data.que_typestring是技能组类型：0-呼入,呼出；1-呼入；2-呼出
data.que_lengthstring是最大排队数
data.que_timestring是排队时长
data.ring_timestring是坐席振铃时长
data.next_waitstring是事后处理时长
data.b_announcestring是是否报工号：0-否；1-是
data.noans_timesstring是无应答次数
data.noans_waitstring是无应答等待时间
data.idstring是技能组id
data.que_strategystring是分配策略：1-最长等待时间；2-技能高优先
data.noans_actionstring是无应答操作：0-不处理；1-示忙
data.wait_audiostring是队列等待音：语音id
data.sound_namestring是队列等待音：语音名称
data.brecordstring是固定值：0，已废弃，无实际意义
data.que_numstring是技能组号
data.que_prioritystring是技能组优先级
data.auto_evaluatestring是自动转满意度（0、否 1、是）

code结果编码说明

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

结果示例

{
    "code": 200,
    "message": "ok",
    "total": "80",
    "totalPage": 1,
    "data": [
        {
            "que_name": "默认技能组",
            "que_tag": "0",
            "que_type": "0",
            "que_length": "15",
            "que_time": "120",
            "ring_time": "30",
            "next_wait": "5",
            "b_announce": "1",
            "noans_times": "4",
            "noans_wait": "10",
            "id": "2141",
            "que_strategy": "1",
            "noans_action": "0",
            "wait_audio": "0",
            "sound_name": null,
            "brecord": "0",
            "que_num": "",
            "que_priority": "100",
            "auto_evaluate": "1"
        }
    ]
}

技能组分配坐席

接口地址

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

接口参数

字段类型是否必填示例值说明
que_idInteger是123技能组ID
agentsString是[{"ag_id":坐席ID,"skill":技能水平}]分配的坐席ID集合 json数组

结果编码说明

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

结果示例

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

取消已分配的技能组坐席

接口地址

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

接口参数

字段类型是否必填示例值说明
que_idInteger是123技能组ID
agentsString是[100031,100032]分配的坐席ID集合 json数组

结果编码说明

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

结果示例

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

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

接口地址

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

接口参数

字段类型是否必填示例值说明
que_idInteger是123技能组ID
is_transactionInteger否1如果是1 agents里面只要有一个不符合条件就统一修改失败,0的话就跳过不符合条件的，会在errMessage中体现不符合的数据
agentsString是[{"ag_id":坐席ID,"skill":技能水平}]分配的坐席ID集合 json数组

结果编码说明

code说明
200ok
401企业代码为空
402企业代码不存在
403技能组不属于该企业
404技能组ID为空
405agents非JSON格式
406ag_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_idsString是123,124技能组ID(多个逗号分隔)

结果编码说明

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

结果示例


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"
            }
        ]
    }
}