Help Center/ Cognitive Engagement Center/ API Reference/ Call Center Configuration Interface Reference/ Agent Management/ Binding an Agent to a Skill Queue (addSkillsToAgent)
Updated on 2023-09-27 GMT+08:00
View PDF

Binding an Agent to a Skill Queue (addSkillsToAgent)

Scenario

Bind an agent to a skill queue based on the skill queue ID and agent account.

Method

POST

URI

https://Domain name/apiaccess/rest/cc-management/v1/agentAccount/addSkillsToAgent. For example, the domain name is service.besclouds.com.

Request Description

Table 1 Request header parameters

No.

Name

Type

Mandatory or Not

Description

1

x-app-key

String

No

App key field, which is the user ID. Contact the operation personnel to obtain the app key.

2

Authorization

String

Yes

Authentication field. The format is Bearer {Value of AccessToken returned by the tokenByAkSk interface}. (A space is required after Bearer.)
Table 2 Request body parameters

No.

Name

Type

Mandatory or Not

Description

1.1

userAccounts

Array

Yes

Agent account array, which is a string of a maximum of 50 characters.

1.2

skillId

Integer

Yes

Skill queue ID.

1.3

agentWeight

Integer

Yes

Agent weight. A larger weight indicates a higher priority. The minimum value is 1.

1.4

skillWeight

Integer

Yes

Skill queue weight. The minimum value is 1.

Response Description

  • Status code: 200
    Table 3 Response body parameters

    No.

    Name

    Type

    Mandatory or Not

    Description

    1.1

    resultCode

    String

    No

    If the modification is successful, 0 is returned. If the modification fails, 1 is returned, and resultMessage carries the failure cause.

    1.2

    resultMessage

    String

    No

    Request return information.
  • Status code: 400

    Incorrect request. Check the request path and parameters.

  • Status code: 401

    Unauthorized operation.

    1. Check whether you have purchased related services.

    2. Contact customer service to check the status of your account.

  • Status code: 404

    The requested content is not found. Check the request path.

  • Status code: 500

    Business failure. Check the values of parameters in the request.

Error Codes

None

Example

Request header:

x-app-key: 68b*************6ec8e4
Content-Type: application/json
Authorization: Bearer xxx

Request parameters:

{
    "userAccounts":["x1","x2"],
    "skillId":4,
		"agentWeight":1,
		"skillWeight":1
}

Response parameters:

{
  "resultCode": "0",
  "resultMessage": "success"
}

Parent topic: Agent Management