ListAgentBySkillGroupId - 获取技能组下坐席信息_智能联络中心(AICCS)-阿里云帮助中心

根据AICCS实例ID、技能组ID查询悉犀客服工作台坐席列表。

接口说明

调用此接口前，请您确认 AICCS 的实例信息及技能组信息，请参考请求参数描述中的指引获取。
若坐席没有设置所属的技能组，可调用 GetAgent 查询坐席信息。

QPS 限制

单用户调用频率：不限流。
API 频率：100 次/秒。

说明如果多个用户的总调用超过 API 频率也会触发流控。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	客户请求唯一 ID。用于幂等校验，可以用 UUID 生成。	46c1341e-2648-447a-9b11-70b6a298d94d
InstanceId	string	是	AICCS 实例 ID。您可以在智能联络中心控制台左侧导航栏的实例管理中获取。	ccc_xp_pre-cn-***
SkillGroupId	long	是	技能组 ID。可调用 QuerySkillGroups 接口，查看返回参数的 SkillGroupId，即技能组 ID。	666666

返回参数

名称	类型	描述	示例值
	object	result
Message	string	状态码描述。	successful
RequestId	string	请求 ID。	EE338D98-9BD3-4413-B165
Data	object []	坐席信息。
Status	integer	坐席状态。只有正常的状态，才可进行业务活动。取值： 0：正常 1：冻结 2：删除	0
DisplayName	string	坐席对外显示名称。	刘测试
AgentId	long	坐席 ID。	666666
AccountName	string	坐席账号名称，即账号注册时填写的手机或邮箱。实例内唯一。	username@example.com
TenantId	long	坐席所属的租户 ID。与入参中的实例 ID 对应。	0
Code	string	状态码。返回 Success 表示请求成功。	Success
Success	boolean	调用接口是否成功。取值： true：成功。 false：失败。	true

示例

正常返回示例

JSON格式

{
  "Message": "successful",
  "RequestId": "EE338D98-9BD3-4413-B165",
  "Data": [
    {
      "Status": 0,
      "DisplayName": "刘测试",
      "AgentId": 666666,
      "AccountName": "username@example.com",
      "TenantId": 0
    }
  ],
  "Code": "Success",
  "Success": true
}

错误码

HTTP status code	错误码	错误信息	描述
500	NoTenantFound	The specified tenant does not exist.	没有发现租户实例
500	SystemError	A system error occurred. Please contact the administrator.	系统错误，请联系管理员！

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