EmbeddedServiceConfig | Metadata API Developer Guide

File Suffix and Directory Location

EmbeddedServiceConfig components are stored in the developer_name.EmbeddedServiceConfig file in the EmbeddedServiceConfig folder.

Version

EmbeddedServiceConfig is available in API version 37.0 and later.

Fields

Field Name	Field Type	Description
areGuestUsersAllowed	boolean	Specifies whether a user must be logged in to access a Snap-in. Available in API version 45.0 and later.
authMethod	EmbeddedServiceAuthMethod (enumeration of type string)	Type of login method selected for this Snap-ins deployment. One of the following values: `CommunitiesLogin`–Customers log in using Communities. `CustomLogin`–Customers log in using your own custom authentication. Available in API version 43.0 and later.
customMinimizedComponent	string	The custom Lightning component that’s used for the minimized snap-in in this Snap-ins deployment. Available in API version 43.0 and later.
embeddedServiceCustomComponents	EmbeddedServiceCustomComponent[]	The custom components used in this Snap-ins deployment. Available in API version 44.0 and later.
embeddedServiceCustomLabels	EmbeddedServiceCustomLabel[]	The custom labels used in this Snap-ins deployment. Available in API version 44.0 and later.
embeddedServiceFlowConfig	EmbeddedServiceFlowConfig	Represents a setup node for creating a Flow Snap-in. Available in API version 45.0 and later.
embeddedServiceFlows	EmbeddedServiceFlow[]	All of the flows used by this Snap-ins deployment. Available in API version 45.0 and later.
masterLabel	string	Required. The name of the Embedded Service configuration node. Available in API version 37.0 and later.
shouldHideAuthDialog	boolean	Specifies whether the prompt that the customer login again during a flow is hidden (`true`) or not (`false`). When it’s hidden, the customer is taken directly to your login page. This field is set to `false` by default. Available in API version 43.0 and later.
site	string	Required. The name of the Salesforce Community or site connected to this Snap-ins deployment. Available in API version 37.0 and later.

EmbeddedServiceCustomComponent

Returns a custom component that’s associated with an EmbeddedServiceConfig setup.

Field Name	Field Type	Description
customComponent	string	The name of the custom component.
customComponentType	EmbeddedServiceCustomComponent (enumeration of type string)	The type of custom component. One of the following values: `LA_Prechat` (component for pre-chat in Snap-ins Chat) `LA_Minimized` (component for the minimized chat Snap-in) `LA_PlainTextChatMessage` (component for the text area of the Snap-in)

EmbeddedServiceCustomLabel

Returns a custom label that’s associated with an EmbeddedServiceConfig setup.

Field Name	Field Type	Description
customLabel	string	The customized label that appears in the Snap-in.
feature	EmbeddedServiceFeature (enumeration of type string)	The feature that this Snap-in uses. One of the following values: `Base` `FieldService` `Flows` `LiveAgent` `NotInUse`
labelKey	EmbeddedServiceLabelKey (enumeration of type string)	The type of label for this Snap-in. The value corresponds to the label within a label group (substate of chat state or page type).

EmbeddedServiceFlow

Returns an embedded flow that’s associated with an EmbeddedServiceConfig setup.

Field Name	Field Type	Description
flow	string	The developer name of the flow.
flowType	EmbeddedServiceFlowType(enumeration of type string)	The type of flow. One of the following values: `FS_Flow` `FS_NewAppointment` `FS_ModifyAppointment` `FS_CancelAppointment`
isAuthenticationRequired	boolean	Indicates whether users are required to log in to access the Snap-in. The value cannot be `true` for the `FS_Flow` value and must be `true` for all other values.

EmbeddedServiceFlowConfig

Returns the EmbeddedServiceFlowConfig type.

Field Name	Field Type	Description
enabled	boolean	Indicates whether the Flow Snap-in is enabled.

Declarative Metadata Sample Definition

The following is an example of an EmbeddedServiceConfig file.

1This is an example of an EmbeddedServiceConfig file.
2<?xml version="1.0" encoding="UTF-8"?>
3<EmbeddedServiceConfig xmlns="http://soap.sforce.com/2006/04/metadata">
4    <authMethod>CommunitiesLogin</authMethod>
5    <customMinimizedComponent>customMinimized</customMinimizedComponent>
6    <masterLabel>EswFS</masterLabel>
7    <shouldHideAuthDialog>false</shouldHideAuthDialog>
8    <site>SiteName</site>
9</EmbeddedServiceConfig>

Wildcard Support in the Manifest File

This metadata type doesn’t support 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.