QuerySkillGroups

Updated at:

Queries the skill group list of the Cloud Customer Service System by instance ID.

Operation description

This operation queries information about skill groups, such as the display name, description, channel type, and ID. For more information, see Response elements.

QPS limit

  • Single-user call frequency: not throttled.

  • API frequency: 1,000 calls per second.

Note

If the total calls from multiple users exceed the API frequency, throttling is triggered.

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 ID of the AICCS instance. You can obtain the instance ID from Instance Management in the left-side navigation pane of the Artificial Intelligence Cloud Call Service console.

ccc_xp_pre-cn-***

PageNo

integer

Yes

The page number. The value must be greater than 0. Default value: 1.

1

PageSize

integer

Yes

The number of entries per page. The value must be greater than 0. Default value: 20.

20

ClientToken

string

No

The unique ID of the client request. Used for idempotence verification. You can use a UUID to generate this ID.

46c1341e-2648-447a-****-70b6a298d94d

ChannelType

integer

No

The channel type of the skill group. Valid values:

  • 0: All skill groups are returned.

  • 1: Hotline skill group.

  • 2: Online skill group.

  • 3: Online + hotline skill group.

  • 4: Ticket skill group.

  • 5: Hotline + ticket skill group.

  • 6: Online + ticket skill group.

  • 7: Online + hotline + ticket skill group.

Valid values:

  • 1 :

    Hotline skill group.

  • 2 :

    Online skill group.

  • 4 :

    Ticket skill group.

2

DepartmentId

integer

No

The department ID.

1023****

Response elements

Element

Type

Description

Example

object

The response parameters.

OnePageSize

integer

The number of entries per page.

20

TotalPage

integer

The total number of pages.

4

RequestId

string

The request ID.

EE338D98-9BD3-4413-B165

CurrentPage

integer

The current page number.

1

TotalResults

integer

The total number of records.

76

Data

array<object>

The data.

object

The data information.

Description

string

The description of the skill group.

Automation skill group

SkillGroupName

string

The name of the skill group.

Automation skill group

DisplayName

string

The display name of the skill group.

Automation skill group

SkillGroupId

integer

The ID of the skill group.

123456

ChannelType

integer

The channel type of the skill group.

2

Examples

Success response

JSON format

{
  "OnePageSize": 20,
  "TotalPage": 4,
  "RequestId": "EE338D98-9BD3-4413-B165",
  "CurrentPage": 1,
  "TotalResults": 76,
  "Data": [
    {
      "Description": "自动化技能组",
      "SkillGroupName": "自动化技能组",
      "DisplayName": "自动化技能组",
      "SkillGroupId": 123456,
      "ChannelType": 2
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidInstanceId The specified instance is unavailable or does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.