ListBriefSkillGroups-阿里云帮助中心

You can invoke ListBriefSkillGroups to obtain the list of skill group summary information under a specified instance.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	The instance ID.	ccc-test
SearchPattern	string	No	Perform fuzzy matching based on the skill group name or display name. This parameter is optional and defaults to empty, which means no filtering is applied.	skillgroup
PageNumber	integer	Yes	The page number for paging, ranging from 1 to 100.	1
PageSize	integer	Yes	The page size for paging, ranging from 1 to 100.	10
MediaType	string	No	The media type. The default value is AUDIO. Other valid values include CHAT and VIDEO.	CHAT

Response elements

Element	Type	Description	Example
	object
Code	string	The response code.	OK
HttpStatusCode	integer	HTTP status code.	200
Message	string	Response message.	无
RequestId	string	Request ID.	3969FC68-CEC2-4398-B76A-60D2F7EDEBAF
Data	object	Data.
PageNumber	integer	Page number, ranging from 1 to 100.	1
PageSize	integer	Page size, ranging from 1 to 100.	10
TotalCount	integer	Total count.	10
List	array<object>	List of skill group summary information.
	object	Skill group
DisplayName	string	The display name of the skill group.	测试技能组
Description	string	Description of the skill group.	云联络中心的测试技能组。
PhoneNumberCount	integer	Quantity of phone numbers associated with the skill group.	1
SkillGroupId	string	The skill group ID.	skillgroup@ccc-test
SkillGroupName	string	Name of the skill group.	skillgroup
UserCount	integer	The number of agents associated with the skill group.	10
InstanceId	string	Instance ID.	ccc-test
MediaType	string	The media type. The default value is AUDIO. Other valid values include CHAT and VIDEO.	VIDEO

Examples

Success response

JSON format

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "3969FC68-CEC2-4398-B76A-60D2F7EDEBAF",
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 10,
    "List": [
      {
        "DisplayName": "测试技能组",
        "Description": "云联络中心的测试技能组。",
        "PhoneNumberCount": 1,
        "SkillGroupId": "skillgroup@ccc-test",
        "SkillGroupName": "skillgroup",
        "UserCount": 10,
        "InstanceId": "ccc-test",
        "MediaType": "VIDEO"
      }
    ]
  }
}

Error codes

HTTP status code	Error code	Error message
400	Parameter.Minimum	The parameter %s must be greater than or equal to %s.
400	Parameter.Blank	The parameter %s may not be null or blank.
400	Parameter.Null	The parameter %s may not be null.
404	NotExists.InstanceId	The specified instance %s does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.