更新时间:2023-12-19 GMT+08:00

更新座席名称

注意:该接口仅支持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~99999。

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"
    }