EmbeddedServiceLiveAgent

Represents a setup node for creating a Snap-ins Chat Live Agent deployment. Available in Tooling API version 38.0 and later.

Supported Calls

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

Supported REST HTTP Methods

GET, POST, PATCH, DELETE

Fields

Field	Details
AvatarImg	Type url Properties Filter, Group, Nillable, Sort Description URL of the image used as the agent avatar image. Available in API version 43.0 and later.
CustomPrechatComponentId	Type ID Properties Filter, Group, Nillable, Sort Description The ID of the custom Lightning Component that’s used for the pre-chat page in this Snap-ins Chat deployment.
DeveloperName	Type string Properties Filter, Group, Sort Description Unique name for the Snap-ins Chat configuration setup node.
EmbeddedServiceConfigId	Type reference Properties Filter, Group, Sort Description Unique name for the Snap-ins Chat deployment ID.
Enabled	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether this Snap-ins Chat Live Agent deployment is enabled (`true`). Available in API version 43.0 and later.
FontSize	Type picklist Properties Filter, Group, Restricted picklist, Sort Description Font size for the snap-in. Available in API version 43.0 and later. Possible values are: `Small` `Medium` `Large` Available in API version 43.0 and later.
FullName	Type string Properties Create, Group, Nillable Description The unique name used for this Snap-ins deployment. The fullName can contain only underscores and alphanumeric characters. It must be unique, begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.
HeaderBackgroundImg	Type url Properties Filter, Group, Nillable, Sort Description URL of the image used for the header background in Snap-ins Chat. Available in API version 43.0 and later.
IsOfflineCaseEnabled	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Specifies whether offline support is enabled for this Snap-ins deployment (`true`) or not (`false`). Available in API version 43.0 and later.
IsQueuePositionEnabled	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Specifies whether queue position (displaying the customer’s place in line while they wait for an agent) is enabled for this Snap-ins Chat deployment (`true`) or not (`false`). Available in API version 43.0 and later.
Language	Type picklist Properties Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort Description Languages supported in the Snap-ins Chat Live Agent deployment. Chinese (Simplified): `zh_CN` Chinese (Traditional): `zh_TW` Danish: `da` Dutch: `nl_NL` English: `en_US` Finnish: `fi` French: `fr` German: `de` Italian: `it` Japanese: `ja` Korean: `ko` Norwegian: `no` Portuguese (Brazil): `pt_BR` Russian: `ru` Spanish: `es` Spanish (Mexico): `es_MX` Swedish: `sv` Thai: `th`
LiveAgentChatUrl	Type url Properties Filter, Group, Nillable, Sort Description The REST endpoint for Live Agent chats. Available in API version 43.0 and later.
LiveAgentContentUrl	Type url Properties Filter, Group, Nillable, Sort Description The REST endpoint for Live Agent content. Available in API version 43.0 and later.
LiveChatButtonId	Type reference Properties Create, Filter, Nillable, Sort, Update Description Reference to a chat button created in the Live Agent setup.
LiveChatDeploymentId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Reference to a deployment created in the Live Agent setup.
ManageableState	Type ManageableState enumerated list Properties Filter, Group, Nillable, Restricted picklist, Sort Description Indicates the manageable state of the specified component that is contained in a package: `beta` `deleted` `deprecated` `installed` `released` `unmanaged` For more information about states of manageability for components in Salesforce AppExchange packages, see “Planning the Release of Managed Packages” in the Salesforce online help. Available in API version 43.0 and later.
MasterLabel	Type string Properties Filter, Group, Sort Description Name of the Snap-ins Chat Live Agent deployment.
Metadata	Type `mns:`EmbeddedServiceLiveAgent Properties Create, Nillable, Update Description The Snap-ins Chat metadata. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.
NamespacePrefix	Type string Properties Filter, Group, Nillable, Sort Description The namespace prefix associated with this object. Each Developer Edition organization that creates a managed package has a unique namespace prefix. Limit: 15 characters. You can refer to a component in a managed package by using the `namespacePrefix__componentName` notation. The namespace prefix can have one of the following values: In Developer Edition organizations, the namespace prefix is set to the namespace prefix of the organization for all objects that support it. There is an exception if an object is in an installed managed package. In that case, the object has the namespace prefix of the installed managed package. This field’s value is the namespace prefix of the Developer Edition organization of the package developer. In organizations that are not Developer Edition organizations, NamespacePrefix is only set for objects that are part of an installed managed package. There is no namespace prefix for all other objects. Available in API version 43.0 and later.
OfflineCaseBackgroundImg	Type string Properties Filter, Group, Nillable, Sort Description URL of the image used for the background for the offline support case form in Snap-ins Chat. Available in API version 43.0 and later.
PrechatBackgroundImg	Type string Properties Filter, Group, Nillable, Sort Description URL of the image used for the background for the pre-chat form in Snap-ins Chat. Available in API version 43.0 and later.
PreChatEnabled	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether the Snap-ins pre-chat form is enabled for this chat deployment.
PrechatJson	Type string Properties Nillable Description JSON object of all the fields of the selected pre-chat form in Live Agent setup. Available in API version 43.0 and later.
Scenario	Type picklist Properties Filter, Group, Restricted picklist, Sort Description The type of use case that is selected for the Snap-ins pre-chat form. Valid values are: `Basic` `Sales` `Service`
SmallCompanyLogoImg	Type url Properties Filter, Group, Nillable, Sort Description URL of the logo image used with Snap-ins Chat. Available in API version 43.0 and later.
WaitingStateBackgroundImg	Type url Properties Filter, Group, Nillable, Sort Description URL of the image used for the background image in Snap-ins Chat while the customer waits to be connected with a support agent. Available in API version 43.0 and later.

Usage

EmbeddedServiceLiveAgent represents a Live Agent configuration that is added to your web page. The EmbeddedServiceLiveAgent record contains a unique combination of a Live Agent chat button and the Live Agent deployment that the administrator selects during setup.

To create an EmbeddedServiceLiveAgent record, create a Live Agent Deployment, a Live Agent Chat Button, and an EmbeddedServiceConfig record. Then, set the fields for these records as references on the EmbeddedServiceLiveAgent record.