UpdateAgent - 更新坐席数据

根据实例ID、坐席账号名称修改悉犀客服工作台坐席信息。支持修改坐席对外显示名称、坐席所属技能组。

接口说明

  • 调用前,建议您确认 AICCS 实例 ID,请参考请求参数描述中的指引获取。
  • 更新后,您可调用 GetAgent 接口,确认更新是否符合预期。
说明 目前仅支持修改对外显示名称和所属技能组。

QPS 限制

  • 单用户调用频率:不限流。
  • API 频率:100 次/秒。
说明 如果多个用户的总调用超过 API 频率也会触发流控。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ClientTokenstring

客户请求唯一 ID。用于幂等校验,可以用 UUID 生成。

46c1341e-2648-447a-9b11-70b6a298d94d
InstanceIdstring

AICCS 实例 ID。 您可以在智能联络中心控制台左侧导航栏的实例管理中获取。

ccc_xp_pre-cn-***
AccountNamestring

坐席账号名称,即账号注册时填写的手机或邮箱。实例内唯一。

说明 不支持更新。
username@example.com
DisplayNamestring

坐席对外显示名称。

XX测试
SkillGroupIdarray

坐席所属技能组。

long

技能组。

2345****
SkillGroupIdListarray

坐席所属技能组列表。

long

技能组列表。多个技能组用半角逗号(,)分隔。

2321****,4567****

返回参数

名称类型描述示例值
object

返回数据。

HttpStatusCodelong

HTTP 状态码。

200
Codestring

状态码。返回 Success 表示调用成功。

Success
Messagestring

状态码描述。

OK
RequestIdstring

请求 ID。

EE338D98-9BD3-4413-B165
Successboolean

调用接口是否成功。取值:

  • true:成功。
  • false:失败。
true

示例

正常返回示例

JSON格式

{
  "HttpStatusCode": 200,
  "Code": "Success",
  "Message": "OK",
  "RequestId": "EE338D98-9BD3-4413-B165",
  "Success": true
}

错误码

HTTP status code错误码错误信息描述
500InvalidOperationThe operation is invalid.无效操作
500NoAgentFoundThe specified agent does not exist.没有找到指定坐席
500NoTenantFoundThe specified tenant does not exist.没有发现租户实例
500SystemErrorA system error occurred. Please contact the administrator.系统错误,请联系管理员!

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史