Skip to main content

坐席管理

静态坐席签入

静态坐席批量签入接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/agent/login
实例
Methodpost
Content-Typeapplication/x-www-form-urlencoded

接口参数

字段类型是否必填示例值说明
dataString是[{"ag_num":"8001","phone":"13811112222"},{"ag_num":"8002","phone":"13811112223"}]详细数据

返回结果外层编码说明

code说明
200ok
500错误

返回结果内层编码说明

code说明
401企业代码为空
402企业代码不存在
405号码为空
406号码格式不对，要求为多个号码逗号分隔的字符串
407坐席已经初始化
408号码中包含非数字字符
409坐席工号或分机号不存在

结果示例

{"code":200,"message":"ok"}
{
    "code": 500,
    "message": "错误",
    "errors": [
        {
            "code": 409,
            "message": "分机号不存在",
            "data": {
                "ag_num": "10011",
                "phone": "15623828691"
            }
        }
    ]
}

静态坐席签出

静态坐席批量注销接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/agent/logout
实例
Methodpost
Content-Typeapplication/x-www-form-urlencoded

接口参数

字段类型是否必填示例值说明
dataString是[{"ag_num":"1001"},{"ag_num":"1002"}]注销的坐席工号

结果外层错误编码说明

code说明
401企业代码为空
402企业代码不存在
404参数中详细数据data为空
415参数data不能为空
417data格式非json
200ok
500错误

结果内层错误编码说明

code说明
405参数中详细数据data格式不对，要求为数组
406参数中详细数据data数组格式不对，必须包含工号ag_num
407坐席不存在或坐席没有签入
408不是静态坐席
409坐席已从页面登录
410格式错误
411签出失败

结果示例

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

删除坐席

批量删除坐席接口

接口地址

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

接口参数

字段类型是否必填示例值说明
ag_idsString是[1001, 1002]删除的坐席ID集合（JSON字符串）
ag_numsString是["n9001", "n9002"]删除的坐席工号集合（JSON字符串）

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403坐席ag_ids为空、坐席ag_ids或ag_nums至少有一个不能为空
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_idInteger否1001坐席ID
ag_numString否1111坐席工号
ag_nameString是刘慧坐席名称
ag_passwordString否zd*23kd593坐席密码
ag_nicknameString否小刘坐席昵称
ag_roleString否0坐席类型(-1 =>非坐席，0=>普通坐席,1=>班长坐席)
user_roleString否坐席角色

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403企业ID不存在或坐席ID和工号不能都为空
404坐席ID包含非数字字符
405坐席名称为空
406坐席类型不正确
407角色不属于该企业
409坐席数量已经超标
410更新坐席失败
200ok

结果示例

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

添加坐席

接口地址

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

接口参数

字段类型是否必填示例值说明
ag_numString是1001坐席工号
ag_nameString是刘慧坐席名称
ag_nicknameString否小刘坐席昵称
ag_passwordString是zd*302ksdf23坐席密码
ag_roleInteger否0坐席前台类型(-1 =>非坐席，0=>普通坐席,1=>班长坐席)
user_roleInteger是123坐席角色
belong_queuesString是[1001, 1002]所属技能组(格式为数组json[]eg:[技能组id,技能组id2])

结果编码说明

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

结果示例

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

获取坐席列表数据

接口地址

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

接口参数

字段类型是否必填示例值说明
que_idInteger否123技能组ID
ag_idInteger否123坐席ID
infoInteger否{"pagination": {"rows": 1000, "page": 1}, "filter":{"keyword":"1001,8001,小王", //关键字可包含（坐席工号、坐席名称） "id":12,//筛选坐席id "user_role":"2",//坐席角色ID "notid":"11,14,15,23"//不包含坐席ID集合 } }筛选条件（json串）

参数filter中字段说明

字段类型是否必填示例值说明
keywordString否刘坐席工号or坐席名称(两个字段or的模糊搜索) 如果想一次搜多个就用逗号隔开
idInteger否123坐席id和上面的ag_id参数一样的意思
user_roleInteger否123坐席角色id
notidString否123,1001,2002不包含坐席ID集合

参数 pagination 中字段说明

字段类型是否必填示例值说明
rowsInteger否100每页数据量
pageInteger否1页码

结果编码说明

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": "",
        "belong_queues_info": {
                "828": "技能组名称"
            }
    }]
}

结果字段说明

字段说明
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分机号
belong_queues_info坐席所属技能组({技能组1id:技能组1名称,技能组2id:技能组2名称})

修改坐席密码

接口地址

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

接口参数

字段类型是否必填示例值说明
ag_idInteger是100每页数据量
old_passwordString是zd*23sldf3旧密码
new_passwordString是sdfsldf3新密码

结果编码说明

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_numString是1001坐席工号
passwordString是kd*32342坐席密码

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403坐席工号为空
404密码为空
405工号不存在
408坐席工号或密码错误
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

接口参数

字段类型是否必填示例值说明
jsonpcallbackString否callbackFunc设置jsonp调用的回调的方法名

结果编码说明

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

结果示例

{
  "code": 200,
  "message": "ok",
  "data": [
    {
      "ag_id": "200500",
      "pho_num": "8001",
      "ag_name": "\u738b\u6210",
      "ag_num": "1001"
    }
  ]
}
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_idString是1001坐席ID
phoneString是15088432656电话号码
stateString是0坐席状态（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_idString是1001坐席ID
call_statusString是0呼叫状态（0既不呼出又不呼入1呼入2呼出3呼入呼出）

结果编码说明

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

结果示例

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

设置坐席外呼主叫号码

接口地址

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

接口参数

{
"ag_ids":[1019540,1019535], // 需要设置坐席id  必须
"outbound_caller":1,  // 是否开启外呼号码设置,1 开启 0 关闭  必须
"outbound_caller_auto":1,  // 是否开启auto, 1是 0否  非必须
"outbound_caller_relay":["01057624342"], // 外呼中继号 非必须
"outbound_caller_phoneGroup":["test1"]  // 外呼号码组 非必须
}

结果编码说明

code说明
0ok
-1失败

curl实例

curl -X POST \
  http://m.icsoc.net/v2/wintelapi/agent/set/outcaller \
  -H 'Authorization: Bearer 655845024d086fxxxxx9b007ce815fc4f48a1dd' \
  -d '{
"ag_ids":[1019540,1019535],
"outbound_caller":1,
"outbound_caller_auto":1,
"outbound_caller_relay":["01057624342"],
"outbound_caller_phoneGroup":["test1"]
}'

结果示例

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