Newer Version Available

This content describes an older version of this product. View Latest

Skill

Represents the settings for a skill used for field service or to route chats to agents in Live Agent, such as the name of the skill and which agents the skills are assigned to. This type extends the Metadata metadata type and inherits its fullName field.

File Suffix and Directory Location

Skill values are stored in the <developer_name>.skill file in the skills directory.

Version

Skill is available in API version 28.0 and later.

Fields

Field Name Field Type Description
assignments SkillAssignments Specifies how skills are assigned to Live Agent users. Skills can be assigned to sets of users or sets of profiles.
description string Specifies the description of the skill. This field is available in API version 38.0 and later.
label string Specifies the name of the skill.

SkillAssignments

Represents which users and user profiles to whom specific skills are assigned.

Fields

Field Name Field Type Description
profiles SkillProfileAssignments Specifies the profiles that are associated with a specific skill.
users SkillUserAssignments Specifies the users that are associated with a specific skill.

SkillProfileAssignments

Represents the profiles that are associated with a specific skill.

Fields

Field Name Field Type Description
profile string Specifies the custom name of the profile associated with a specific skill.

SkillUserAssignments

Represents the users that are associated with a specific skill.

Fields

Field Name Field Type Description
user string Specifies the username of the user associated with a specific skill.

Declarative Metadata Sample Definition

This is a sample of a skill file.

1<?xml version="1.0" encoding="UTF-8"?>
2<Skill xmlns="http://soap.sforce.com/2006/04/metadata">
3    <label>My Skill 1</label>
4    <assignments>
5        <profiles>
6            <profile>LiveAgentOperator</profile>
7            <profile>LiveAgentSupervisor</profile>
8        </profiles>
9        <users>
10            <user>jdoe@acme.com</user>
11        </users>
12    </assignments>
13</Skill>