开发者平台

坐席管理

静态坐席签入

静态坐席批量签入接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/agent/login

接口参数

参数说明备注
data详细数据，[{"ag_num":"8001","phone":"13811112222"},{"ag_num":"8002","phone":"13811112223"}]必须

结果编码说明

code说明
200ok
401企业代码为空
402企业代码不存在
405号码为空
406号码格式不对，要求为多个号码逗号分隔的字符串
407中继号码为空
408号码中包含非数字字符
409添加白名单失败
410中继号码不存在

结果示例

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

静态坐席签出

静态坐席批量注销接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/agent/logout

接口参数

参数说明备注
data注销的坐席工号，示例：[{"ag_num":"1001"},{"ag_num":"1002"}]必须

结果编码说明

code说明
401企业代码为空
402企业代码不存在
404参数中详细数据data为空
405参数中详细数据data格式不对，要求为数组
406参数中详细数据data数组格式不对，必须包含工号ag_num
407坐席不存在或坐席没有签入
408不是静态坐席
409坐席已从页面登录
410格式错误
411签出失败
415参数data不能为空
417data格式非json
200ok
500错误

结果示例

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

删除静态坐席

批量删除静态坐席接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/agent/delete

接口参数

参数说明备注
ag_ids删除的坐席ID集合必须

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403坐席ag_ids为空
404坐席ID包含非数字字符
405删除失败
406坐席在登陆状态
500结果

结果示例

{
    "code": 500,
    "message": "结果",
    "data": [{
        "code": 404,
        "message": "坐席ID包含非数字字符",
        "ag_id": 2
    }, {
        "code": 406,
        "message": "坐席在登陆状态",
        "ag_id": 5
    }]
}

编辑坐席

编辑坐席基础信息

接口地址

POST http://m.icsoc.net/v2/wintelapi/agent/edit

接口参数

参数说明备注
ag_id坐席ID必须
ag_name坐席名称可选
ag_password坐席密码可选
ag_nickname坐席昵称可选
ag_role坐席类型(-1 =>非坐席，0=>普通坐席,1=>班长坐席)可选
user_role坐席角色可选

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403企业ID不存在或坐席ID为空
404坐席ID包含非数字字符
406坐席类型不正确
407角色不属于该企业
409坐席数量已经超标
200ok

结果示例

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

添加坐席

接口地址

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

接口参数

参数说明备注
que_id技能组ID可选
ag_num坐席工号必须
ag_name坐席名称必须
ag_nickname坐席昵称可选
ag_password坐席密码必须
ag_role坐席前台类型(-1 =>非坐席，0=>普通坐席,1=>班长坐席)可选
user_role坐席角色必须
belong_queues所属技能组(格式为数组json[]eg:[技能组id,技能组id2])必须

结果编码说明

code说明
401企业代码为空
402企业代码不存在或企业ID包含非数字字符
403企业ID不存在
405技能组ID包含非数字字符
406技能组ID不存在
407坐席工号为空
409坐席工号已经存在
411坐席密码为空
412坐席类型不正确
413角色不属于该企业
414添加坐席失败
415坐席已经数量达到极限
416belong_queues非json格式
200ok

结果示例

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

获取坐席列表数据

接口地址

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

接口参数

参数说明备注
que_id技能组ID可选
ag_id坐席ID可选
info筛选条件，json串，例如： { "filter":{"keyword":"1001,8001,小王", //关键字可包含（坐席工号、分机号、坐席名称） "id":12,//筛选坐席id "user_role":"2",//坐席角色ID "notid":"11,14,15,23"//不包含坐席ID集合 } }可选

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403坐席ID包含非数字字符
404info格式非json
200ok

结果示例

{
    "code": 200,
    "message": "ok",
    "total": "1",
    "page": 1,
    "totalPage": 1,
    "data": [{
        "ag_id": "200503",
        "vcc_id": "2000005",
        "ag_num": "1004",
        "ag_name": "\u8f9b\u5efa\u534e",
        "ag_nickname": "",
        "ag_password": "e10adc3949ba59abbe56e057f20f883e",
        "ag_role": "1",
        "group_id": "0",
        "user_type": "0",
        "crm_datarole": "1",
        "user_role": "8",
        "role_name": "\u5750\u5e2d",
        "ag_type": "1",
        "pho_num": ""
    }]
}

结果字段说明

字段说明
ag_id坐席ID
vcc_id企业id和企业代码一一对应
ag_num坐席工号
ag_name坐席名称
ag_nickname坐席昵称
ag_password坐席密码
ag_role坐席种类（-1 =>非坐席，0=>普通坐席,1=>班长坐席）
group_id业务组ID
user_type数据权限(0:不限, 1:技能组, 2:坐席, 3:业务组)
crm_dataroleCRM角色
user_role坐席角色
role_name坐席角色名称
ag_type坐席类型（1主管 2坐席）
pho_num分机号

修改坐席密码

接口地址

POST http://m.icsoc.net/v2/wintelapi/agent/password/update

接口参数

参数说明备注
ag_id坐席ID必须
old_password旧密码必须
new_password新密码必须

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403坐席ID为空
404坐席ID包含非数字字符
405旧密码为空
406旧密码错误
407新密码为空
408修改失败
409新密码和原始密码一样，无需修改
200ok

结果示例

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

坐席登录

坐席无分机进行登录验证

接口地址

POST http://m.icsoc.net/v2/wintelapi/agent/signin

接口参数

参数说明备注
ag_num坐席工号必须
password坐席密码必须

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403坐席工号为空
404密码为空
405验证失败,没有匹配到相应数据
200ok

结果示例

{
    "code": 200,
    "message": "ok",
    "data": {
        "ag_id": "200500",
        "vcc_id": "2000005",
        "db_main_ip": "",
        "db_slave_ip": "",
        "db_name": null,
        "db_user": null,
        "db_password": null,
        "role_action": null
    }
}

结果字段说明

字段说明
ag_id坐席ID
vcc_id企业id和企业代码一一对应
db_main_ip主服务器IP
db_slave_ip从服务器IP
db_name数据库名
db_user数据库登录用户
db_password数据库登录密码
role_action权限列表

获取空闲坐席

获取空闲坐席列表数据

接口地址

GET http://m.icsoc.net/v2/wintelapi/agent/free

接口参数

参数说明备注
jsonpcallback设置jsonp调用的回调的方法名可选

结果编码说明

code说明
401企业代码为空
402企业代码不存在
200ok

结果示例

//若jsonpcallback为空，返回json串如下：

{"code":200,"message":"ok","data":[{"ag_id":"200500","pho_num":"8001","ag_name":"\u738b\u6210","ag_num":"1001"}]}

//若jsonpcallback不为空且等于callback，返回json串如下：

callback({"code":200,"message":"ok","data":[{"ag_id":"200500","pho_num":"8001","ag_name":"\u738b\u6210","ag_num":"1001"}]})

结果字段说明

字段说明
ag_id坐席ID
pho_num分机号
ag_name坐席名称
ag_num坐席工号

设置坐席转接电话

设置转电话功能

接口地址

POST http://m.icsoc.net/v2/wintelapi/agent/agextphone

接口参数

参数说明备注
ag_id坐席ID `必须
phone电话号码必须
state坐席状态（0空闲、1忙碌）必须

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403坐席ID为空
404坐席ID包含非数字字符
405手机号为空
406手机号码含非数字字符
407手机号码不是11位
408状态值不是0或1
409对应的坐席不存在
410设置失败
200ok

结果示例

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

设置坐席电话呼入呼出权限

接口地址

POST http://m.icsoc.net/v2/wintelapi/agent/set/callstatus

接口参数

参数说明备注
ag_id坐席ID必须
call_status呼叫状态（0既不呼出又不呼入1呼入2呼出3呼入呼出）必须

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403呼叫状态的值不在允许的范围[0,1,2,3]内
404更新失败
405坐席ID为空或非数字
200ok

结果示例

{"code":200,"message":"ok"}
← 白名单管理分机管理 →