Metadata API Developer Guide
jNewer Version Available
PresenceUserConfig
File Suffix and Directory Location
PresenceUserConfig components have the suffix .presenceUserConfig and are stored in the presenceUserConfigs folder.
Version
PresenceUserConfig components are available in API version 44.0 and later.
Special Access Rules
This type is available only if Omni-Channel is enabled in your org.
Fields
| Field Name | Field Type | Description |
|---|---|---|
| assignments | PresenceConfigAssignments | Specifies how presence configurations are assigned to Omni-Channel users. Presence configurations can be assigned to sets of users or to sets of profiles. |
| capacity | int | Required. The maximum number of work assignments that can be pushed to an agent at a time. |
| declineReasons | string | Specifies the list of decline reasons that an agent can select when they decline a work. |
| enableAutoAccept | boolean | Indicates whether work items that are routed to agents are automatically accepted (true) or not (false). Available only if enableDecline is set to false. |
| enableDecline | boolean | Indicates whether agents can decline work items that are routed to them (true) or not (false). Available only if enableAutoAccept is set to false. |
| enableDeclineReason | boolean | Indicates whether agents can select a reason for declining work requests (true) or not (false). This can be selected only if decline reasons are enabled. |
| enableDisconnectSound | boolean | Indicates whether a sound is played when agents are disconnected from Omni-Channel (true) or not (false). |
| enableRequestSound | boolean | Indicates whether a sound plays with incoming work requests (true) or not (false). Set to true by default. |
| label | string | The label of the presence configuration. |
| presenceStatusOnDecline | string | The presence status that’s automatically assigned to the agent when the agent declines a work item. Available only if enableDecline is set to true. |
| presenceStatusOnPushTimeout | string | The presence status that’s automatically assigned to the agent when the agent doesn’t respond to a work item before push timeout occurs. |
PresenceConfigAssignments
Represents the assignments of an org’s profiles and users to a Presence configuration.
| Field Name | Field Type | Description |
|---|---|---|
| profiles | PresenceConfigProfileAssignments | Specifies the profiles that are associated with a specific presence configuration. |
| users | PresenceConfigUserAssignments | Specifies the users that are associated with a specific presence configuration. |
PresenceConfigProfileAssignments
Represents the profiles associated with a specific presence configuration.
| Field Name | Field Type | Description |
|---|---|---|
| profile | string | Specifies the name of the profile associated with a specific presence configuration. |
PresenceConfigUserAssignments
Represents the users associated with a specific presence configuration.
| Field Name | Field Type | Description |
|---|---|---|
| user | string | Specifies the username of the user associated with a specific presence configuration. |
Declarative Metadata Sample Definition
The following is an example of a PresenceUserConfig component.
The following is an example package.xml that references the previous definition.
Wildcard Support in the Manifest File
This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.