# 坐席管理

# 简介

坐席管理是菊风云平台提供的一项服务。通过该服务,您的服务器可以对坐席进行管理,从而使您能够在视频双录的基础上增加额外的业务控制。

文档描述基于您已经完成以下工作:

# 坐席修改

# 基本信息

Path: /third_api/staff/add_1606457365382

Method: POST

接口描述:修改技能组相关信息

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

Query

参数名称 是否必须 示例 备注
page
size
commonStr 通用查询字段(按照坐席名或坐席电话号码模糊查询)

Body

 { 
    "id":"1", // 必须
    "accountId":"agent2", // 坐席账号
    "password":"xxx", //密码
    "staffName":"agent2", //坐席名
    "staffTel":"189898989898", //坐席电话
    "staffRole":1,  //坐席角色
    "groupNameList":["G1","G10"]  //技能组名称
  } 

# 返回数据

{
    "ret": 0,
    "msg": "ok",
}

# 坐席删除

# 基本信息

Path: /third_api/staff

Method: DELETE

接口描述:删除业务号

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded

Query

参数名称 是否必须 示例 备注
id 1

Body

 { 
    "id":"1", // 必须
    "accountId":"agent2", // 坐席账号
    "password":"xxx", //密码
    "staffName":"agent2", //坐席名
    "staffTel":"189898989898", //坐席电话
    "staffRole":1,  //坐席角色
    "groupNameList":["G1","G10"]  //技能组名称
  } 

# 返回数据

{
    "ret": 0,
    "msg": "ok",
}

# 坐席删除根据Account ID

# 基本信息

Path: /third_api/staff/rm

Method: POST

接口描述

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

Query

参数名称 是否必须 示例 备注
id 1

Body

{
   "accountId": ""
}

# 返回数据

{
    "ret": 0,
    "msg": "ok",
}

# 坐席查询

# 基本信息

Path: /third_api/staff

Method: GET

接口描述:返回坐席相关信息,可根据分组名模糊查询

# 请求参数

Headers

参数 是否必须 说明
appKey appKey

Query

参数名称 是否必须 示例 备注
page
size
commonStr 通用查询字段(按照坐席名或坐席电话号码模糊查询)

# 返回数据

{
    "ret": 0,
    "msg": "ok",
    "data": {
        "total": 1,
        "page": 1,
        "current": 1,
        "list": [
            {
                "id": 35,
                "staffId": "[username:agent2@100645.cloud.justalk.com]", // cloud平台账号id
                "staffName": "英文开户坐席", // 坐席名
                "accountId": "agent2", // 坐席id
                "staffTel": "18888888888", // 手机号
                "staffRole": 4, // 坐席角色id 0 初级操作 1 中级操作员 2专家操作员 3 主管 4 管理员
                "groupList": [ // 关联技能组
                    {
                        "id": 12,
                        "groupName": "G1", //技能组名
                        "description": "接话数量均衡调度" //描述
                    }
                ],
                "businessList": [ // 关联业务组
                    {
                        "id": 11,
                        "telNum": 10086, // 业务号
                        "description": "开户业务",
                        "logoUrl": "",
                        "telPower": 50,// 基础权重
                        "waitTime": 0,// 等待时长
                        "increasePower": 0,//权重增量
                        "secondCallPower": 0 //二次呼叫权重
                    }
                ]
            }
        ]
    }
}

# 坐席添加1

# 基本信息

Path: /third_api/staff

Method: POST

接口描述:新增坐席信息

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

Query

参数名称 是否必须 示例 备注
page
size
commonStr 通用查询字段(按照坐席名或坐席电话号码模糊查询)

Body

 { 
    "password":"xxx", //密码(必须)
    "staffName":"agent2", //坐席名(必须)
    "staffTel":"189898989898", //坐席电话(必须)
    "staffRole":1,  //坐席角色(非必须)0 初级操作 1 中级操作员 2专家操作员 3 主管 4 管理员
    "accountId":"agent2", //坐席账号(限制不可重复,必须)
    "groupList":[1,2]  //技能组id(非必须)
  } 

# 返回数据

{
    "ret": 0,
    "msg": "ok",
}

# 坐席添加2

# 基本信息

Path: /third_api/staff/add

Method: POST

接口描述:新增坐席信息

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

Query

参数名称 是否必须 示例 备注
page
size
commonStr 通用查询字段(按照坐席名或坐席电话号码模糊查询)

Body

 { 
    "password":"xxx", //密码(必须)
    "staffName":"agent2", //坐席名(必须)
    "staffTel":"189898989898", //坐席电话(必须)
    "staffRole":1,  //坐席角色(非必须)0 初级操作 1 中级操作员 2专家操作员 3 主管 4 管理员
    "accountId":"agent2", //坐席账号(限制不可重复,必须)
    "groupNameList":["G1","G10"]  //技能组名称(非必须)
  } 

# 返回数据

{
    "ret": 0,
    "msg": "ok",
}

# 根据ID查询技能组详情

# 基本信息

**Path:**GET HTTP://ip:port/third_api/staff/one

接口描述:返回坐席相关信息

# 请求参数

Headers

参数 是否必须 说明
appKey appKey

Query:

参数 是否必须 说明
id 数据id

# 返回数据

{

  "ret": 0,
  "msg": "ok",
  "data": {
     "total": 22,
     "page": 2,
     "current": 1,
     "list": [{
        "id": 81,
        "createTime": 1578621264000,// 创建时间
        "staffId": "[username:yunwen1@100645.cloud.justalk.com]", //坐席工号
        "staffName": "云问1",// 坐席名
        "accountId": "yunwen1", //坐席账号
           "staffTel": "13625486957", //坐席电话
        "staffRole": 4, //坐席角色id
        "groupList": [{
            "id": 2,
            "groupName": "G2", //技能组名
            "description": "增值电信业务组" //描述
        }]
     }]
  }
  }