1. References
  2. Management API
  3. Skills
Rate this page:

Skills

Methods

AddSkill

Copy URL

Adds a new operator's skill. Works only for ACDv1. For SmartQueue/ACDv2, use this reference.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
User manager
AddSkill example
Copy

AddSkill example

Add a new skill.

Parameters

  • skill_name:

    string

    The ACD operator skill name. The length must be less than 512

Returns

  • result:

    number

    1

  • skill_id:

    number

    The skill ID

DelSkill

Copy URL

Deletes an operator's skill. Works only for ACDv1. For SmartQueue/ACDv2, use this reference.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
User manager
DelSkill example
Copy

DelSkill example

Delete the skill 1.

Parameters

  • skill_id:

    number

    The skill ID

  • skill_name:

    string

    The skill name that can be used instead of skill_id

Returns

  • result:

    number

    1

SetSkillInfo

Copy URL

Edits an operator's skill. Works only for ACDv1. For SmartQueue/ACDv2, use this reference.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
User manager
SetSkillInfo example
Copy

SetSkillInfo example

Change the skill name.

Parameters

  • skill_id:

    number

    The skill ID

  • skill_name:

    string

    The skill name that can be used instead of skill_id

  • new_skill_name:

    string

    The new skill name. The length must be less than 512

Returns

  • result:

    number

    1

GetSkills

Copy URL

Gets the skills of an operator. Works only for ACDv1. For SmartQueue/ACDv2, use this reference.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
Supervisor
User manager
GetSkills example
Copy

GetSkills example

Get two skills, but skip the first one.

Parameters

  • skill_id:

    number

    Optional

    The skill ID to filter

  • skill_name:

    string

    Optional

    The skill name part to filter

  • count:

    number

    Optional
    Defaults on:  20

    The max returning record count

  • offset:

    number

    Optional
    Defaults on:  0

    The first N records will be skipped in the output

Returns

  • result:

    [SkillInfoType]

  • total_count:

    number

    The total found skill count

  • count:

    number

    The returned skill count

BindSkill

Copy URL

Binds the specified skills to the users (ACD operators) and/or the ACD queues. Works only for ACDv1. For SmartQueue/ACDv2, use this reference.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
User manager
BindSkill example
Copy

BindSkill example

Bind the skills 1, 5 to the users 5, 6, 10.

Parameters

  • skill_id:

    intlist

    The skill ID list separated by semicolon (;). Use the 'all' value to select all skills

  • skill_name:

    stringlist

    The skill name list separated by semicolon (;). Can be used instead of skill_id

  • user_id:

    intlist

    The user ID list separated by semicolon (;). Use the 'all' value to select all users

  • user_name:

    stringlist

    The user name list separated by semicolon (;). user_name can be used instead of user_id

  • acd_queue_id:

    intlist

    The ACD queue ID list separated by semicolon (;). Use the 'all' value to select all ACD queues

  • acd_queue_name:

    stringlist

    The ACD queue name that can be used instead of acd_queue_id. The ACD queue name list separated by semicolon (;)

  • application_id:

    number

    Optional

    The application ID. It is required if the user_name is specified

  • application_name:

    string

    Optional

    The application name that can be used instead of application_id

  • bind:

    boolean

    Optional
    Defaults on:  true

    Bind or unbind (set true or false respectively)

Returns

  • result:

    number

    1