Newer Version Available

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

LiveChatUserConfig

Represents a setting that controls the console settings for Live Agent users. This object is available in API version 24.0 and later.

Supported Calls

create(), delete(), query(), retrieve(), update(), upsert()

Fields

Field Name Details
AutoGreeting
Type
textarea
Properties
Create, Nillable, Update
Description
The text that is automatically sent from an agent to a visitor when a chat session starts.
Capacity
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Limits the number of active chat session an agent can engage in.
CriticalWaitTime
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The amount of time before a chat flashes to alert an agent to answer it.
CustomAgentName
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The custom name of the agent associated with the Life Agent configuration.
DeveloperName
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The unique name of the object in the API. This name can contain only underscores and alphanumeric characters, and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. In managed packages, this field prevents naming conflicts on package installations. With this field, a developer can change the object’s name in a managed package and the changes are reflected in a subscriber’s organization.

When creating large sets of data, always specify a unique DeveloperName for each record. If no DeveloperName is specified, performance may slow while Salesforce generates one for each record.

Note

HasLogoutSound
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether a sound plays when an agent logs out of the console.
HasNotifications
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether desktop notifications are enabled for the configuration. Available in API version 25.0 and later.
HasRequestSound
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether a sound plays when a chat request comes in.
HasSneakPeek
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether an agent sees a real-time preview of the messages a visitor types.
IsAutoAwayOnDecline
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether agents’ status is automatically changed to Away when they decline a chat request. Available in API version 26.0 and later.
Language
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
The language of the configuration.
MasterLabel
Type
string
Properties
Create, Filter, Group, Sort, Update
Description
The name of the configuration.
OptionsHasAgentFileTransfer
Type
boolean
Properties
Create, Filter, Update
Description
Determines whether agents can initiate a file transfer from a chat customer. Available in API version 31.0 and later.
OptionsHasAgentSneakPeek
Type
boolean
Properties
Create, Filter, Update
Description
Determines whether Sneak Peek is enabled for agents. Available in API version 29.0 and later.
OptionsHasAssistanceFlag
Type
boolean
Properties
Create, Filter, Update
Description
Determines whether assistance flags are enabled for agents. Available in API version 29.0 and later.
OptionsHasChatConferencing
Type
boolean
Properties
Create, Filter, Update
Description
Determines whether agents can invite other agents into a customer chat. Available in API version 34.0 and later.
OptionsHasChatMonitoring
Type
boolean
Properties
Create, Filter, Update
Description
Determines whether supervisors can view agents’ ongoing chats. Available in API version 29.0 and later.
OptionsHasChatTransferToAgent
Type
boolean
Properties
Create, Filter, Update
Description
Specifies whether an agent can transfer a chat directly to another agent. Available in API version 36.0 and later.
OptionsHasChatTransferToButton
Type
boolean
Properties
Create, Filter, Update
Description
Specifies whether an agent can transfer a chat to an agent assigned to a particular chat button. Available in API version 36.0 and later.
OptionsHasChatTransferToSkill
Type
boolean
Properties
Create, Filter, Update
Description
Specifies whether an agent can transfer a chat to agents assigned to a particular skill. Available in API version 36.0 and later.
OptionsHasVisitorBlocking
Type
boolean
Properties
Create, Filter, Update
Description
Determines whether an agent has the ability to block troublesome visitors by IP address. Available in API version 34.0 and later.
OptionsHasWhisperMessage
Type
boolean
Properties
Create, Filter, Update
Description
Determines whether supervisors can send private messages to agents within an agent’s chat with a customer. Available in API version 29.0 and later.
OptionsIsAutoAwayOnPushTimeout
Type
boolean
Properties
Create, Filter, Update
Description
Determines whether an agent’s status automatically changes to Away if the agent doesn’t respond to a chat request within the specified push time-out limit. Available in API version 34.0 and later.
SupervisorDefaultAgentStatus
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
The default agent status by which to filter agents in the Agent Status list in the supervisor panel.
SupervisorDefaultButtonId
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
The default button ID by which to filter agents in the Agent Status list in the supervisor panel.
SupervisorDefaultSkillId
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
The default skill ID by which to filter agents in the Agent Status list in the supervisor panel.

Usage

Use this object to query and manage agent configurations in Live Agent.