# 业务号管理

# 简介

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

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

# 业务号修改

# 基本信息

Path: /third_api/tel

Method: PUT

接口描述:修改业务号相关信息

# 请求参数

Headers

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

Body

{
    "id" : 1,
    "telNum": "10066", // 业务号
    "description": "12", // 描述
    "logoUrl": "",
    "waitTime": 12, //等待时长
    "increasePower": 12, // 权重增量
    "telPower": 12, // 基础权重
    "secondCallPower": 12, //二次呼叫权重
    "groupList": [ // 关联技能组id, 为空时删除所有关联技能组
        12
    ]
}

# 返回数据

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

# 业务号删除

# 基本信息

Path: /third_api/tel

Method: DELETE

接口描述:删除业务号

# 请求参数

Headers

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

Query

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

Body

{
    "id" : 1,
    "telNum": "10066", // 业务号
    "description": "12", // 描述
    "logoUrl": "",
    "waitTime": 12, //等待时长
    "increasePower": 12, // 权重增量
    "telPower": 12, // 基础权重
    "secondCallPower": 12, //二次呼叫权重
    "groupList": [ // 关联技能组id, 为空时删除所有关联技能组
        12
    ]
}

# 返回数据

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

# 业务号查询

# 基本信息

Path: /third_api/tel

Method: GET

接口描述:返回配置过的业务号信息,可根据业务号模糊查询

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
appKey appKey 05c97ce0d0a84d2592334093

Query

参数名称 是否必须 示例 备注
page 1 页码
size 10 每页记录数
commonStr 10086 通用查询字段(目前按照业务号)

# 返回数据

{
    "ret": 0,
    "msg": "ok",
    "data": {
        "total": 40, // 总数量
        "page": 4,  // 总页数
        "current": 1, // 当前页
        "list": [
            {
                "id": 11,
                "telNum": 10086, // 业务号
                "description": "开户业务", // 描述
                "logoUrl": "", // log地址
                "telPower": 50, // 基础权重
                "waitTime": 0, // 等待时长(秒)
                "increasePower": 0, // 权重增量
                "secondCallPower": 0, //二次呼叫权重
                "groupList": [ // 关联技能组
                    {
                        "id": 12,
                        "groupName": "G1",  // 技能组
                        "description": "接话数量均衡调度" // 技能组描述
                    }
                ]
            }
        ]
    }
}

# 业务号添加

# 基本信息

Path: /third_api/tel

Method: POST

接口描述:新增业务号信息

# 请求参数

Headers

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

Body

{
    "telNum": "10066", // 业务号(必须)
    "description": "12", // 描述(必须)
    "logoUrl": "",
    "waitTime": 12, //等待时长
    "increasePower": 12, // 权重增量
    "telPower": 12, // 基础权重
    "secondCallPower": 12, //二次呼叫权重
    "groupList": [ // 关联技能组id
        12
    ]
}

# 返回数据

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

# 根据ID查询业务号详情

# 基本信息

Path: /third_api/tel/one

Method: GET

接口描述:根据ID精确查询

# 请求参数

Headers

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

Query

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

Body

{
    "id" : 1,
    "telNum": "10066", // 业务号
    "description": "12", // 描述
    "logoUrl": "",
    "waitTime": 12, //等待时长
    "increasePower": 12, // 权重增量
    "telPower": 12, // 基础权重
    "secondCallPower": 12, //二次呼叫权重
    "groupList": [ // 关联技能组id, 为空时删除所有关联技能组
        12
    ]
}

# 返回数据

{
  "ret": 0,
  "msg": "ok",
  "data":{
            "id": 11,
            "telNum": 10086, // 业务号
            "description": "开户业务", // 描述
            "logoUrl": "", // log地址
            "telPower": 50, // 基础权重
            "waitTime": 0, // 等待时长(秒)
            "increasePower": 0, // 权重增量
            "secondCallPower": 0, //二次呼叫权重
            "groupList": [ // 关联技能组
                {
                    "id": 12,
                    "groupName": "G1",  // 技能组
                    "description": "接话数量均衡调度" // 技能组描述
                }
            ]
        }
}