文档首页/云客服/API参考/监控类接口参考/接口说明/质检关系维护接口/更新座席名称
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

更新座席名称

注意：该接口仅支持CC-CMS独立部署场景

场景描述

更新座席名称

接口方法

设置成“POST”。该接口仅支持POST方法，不支持PUT、GET和DELTE等方法。

请求URL

https://ip:port/rest/cmsapp/v1/openapi/qcrelationconf/updateagentgroup

其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。

非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

2

Authorization

String

True

生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。

表2 消息体参数说明

参数名

数据类型

选取原则

说明

ccId

int

False

呼叫中心编号，值范围为1~65535

  • 独立部署环境，默认值为系统管理员登录AICC系统后，通过“配置中心 > 系统管理 > 参数配置”查看“默认呼叫中心标识”的值。

vdnId

int

True

虚拟呼叫中心编号，取值范围为1~5000。

agentId

int

True

座席工号（不允许修改VDN管理员的姓名，即不允许传VDN管理员座席工号），取值范围为0~999999。

agentName

String

True

待更改的座席名称（不允许非法字符）

响应消息

表3 消息体参数说明

参数名

数据类型

说明

message

string

描述

retcode

string

错误码。取值如下：

0：成功

1：失败

result

object

加入成功后，返回结果信息的对象。该对象的参数说明请参见表4。

表4 result对象参数说明

参数名

数据类型

说明

ccId

int

呼叫中心编号

vdnId

int

虚拟呼叫中心编号

agentId

int

更改完的座席工号

agentName

String

更改完的座席名称

样例报文

  • 请求头： 
    Content-Type: application/json;charset=UTF-8
Authorization: ******************
  • 请求参数： 
    {
    "ccId":1,
    "vdnId":4,
    "agentId":667,
    "agentName":"张三"
}
  • 响应参数： 
    {
    "result": {
        "agentId": "6667",
        "ccId": 1,
        "vdnId": 4,
        "agentName": "李四"
    },
    "message": "success",
    "retcode": "0"
}