Metadata API Developer Guide
jNewer Version Available
EmbeddedServiceMenuSettings
This type extends the Metadata
metadata type and inherits its fullName field.
File Suffix and Directory Location
EmbeddedServiceMenuSettings components are stored in the developer_name.EmbeddedServiceMenuSettings folder.
Version
EmbeddedServiceMenuSettings components are available in API version 47.0 and later.
Fields
| Field Name | Field Type | Description |
|---|---|---|
| branding | string | The developer name of the associated BrandingSet. |
| embeddedServiceCustomLabels | EmbeddedServiceCustomLabel[] | Represents a customized label that appears in the embedded component for a particular channel menu deployment. |
| embeddedServiceMenuItems | EmbeddedServiceMenuItem[] | Represents a channel menu item that lists a way in which customers can contact your business. |
| isEnabled | boolean | If true (default), the deployment is enabled. If false, the deployment is disabled. |
| masterLabel | string | Required. The name of the channel menu deployment. |
| site | string | Required. The name of the Salesforce Community or site connected to this channel menu deployment. |
EmbeddedServiceCustomLabel
Represents the custom labels used in your channel menu deployment.
| Field Name | Field Type | Description |
|---|---|---|
| customLabel | string | The customized label that appears in the channel menu. |
| feature | EmbeddedServiceFeature (enumeration of type string) | The feature using the custom label. For channel menu deployments, the value is ChannelMenu. |
| labelKey | EmbeddedServiceLabelKey (enumeration of type string) | The type of custom label. Channel menu label key values are as follows. The
first two values apply to custom channel menu labels, and the remaining five values
apply to menu item custom labels.
|
Represents an item in a channel menu.
| Field Name | Field Type | Description |
|---|---|---|
| channel | string | The ID of the channel type. If channelType is Phone or CustomURL, this field is null. |
| channelType | EmbeddedServiceChannelType (enumeration of type string) | The type of communication channel. Values are:
|
| customUrl | string | A custom URL that appears in the menu. The shouldOpenUrlInSameTab field determines where the URL opens. |
| displayOrder | int | The item’s order in the menu, such as 1 or 2. |
| embeddedServiceCustomLabels | EmbeddedServiceCustomLabel[] | Represents the custom labels used in your channel menu item. |
| iconUrl | string | The icon URL for the menu item. Icons can be used only for phone, SMS, custom URL, and chat menu items. |
| itemName | string | A unique custom name for the menu item, which is visible in the user interface. |
| osOptionsHideInIOS | boolean | If true, the menu item is hidden in iOS. |
| osOptionsHideInLinuxOS | boolean | If true, the menu item is hidden in Linux OS. |
| osOptionsHideInMacOS | boolean | If true, the menu item is hidden in Mac OS. |
| osOptionsHideInOtherOS | boolean | If true, the menu item is hidden in any operating system other than iOS, Linux, Mac, and Windows. |
| osOptionsHideInWindowsOS | boolean | If true, the menu item is hidden in Windows OS. |
| phoneNumber | string | The phone number for menu items whose channelType is Phone. |
| shouldOpenUrlInSameTab | boolean | If the menu item’s channelType is CustomURL, this field indicates whether the link opens in the same tab (true) or a new tab (false). |
Declarative Metadata Sample Definition
The following is an example of an EmbeddedServiceMenuSettings component.
1<?xml version="1.0" encoding="UTF-8"?>
2<EmbeddedServiceMenuSettings xmlns="http://soap.sforce.com/2006/04/metadata">
3 <embeddedServiceCustomLabels>
4 <customLabel>CM_Container_Header_Primary_Greeting_3MsRM0000004CB5_6181150</customLabel>
5 <labelKey>CM_Container_Header_Primary_Greeting</labelKey>
6 </embeddedServiceCustomLabels>
7 <embeddedServiceCustomLabels>
8 <customLabel>CM_Container_Header_Secondary_Greeting_3MsRM0000004CB5_4637097</customLabel>
9 <labelKey>CM_Container_Header_Secondary_Greeting</labelKey>
10 </embeddedServiceCustomLabels>
11 <embeddedServiceMenuItems>
12 <channel>Chat</channel>
13 <channelType>EmbeddedServiceConfig</channelType>
14 <displayOrder>1</displayOrder>
15 <embeddedServiceCustomLabels>
16 <customLabel>CM_Container_MenuItems_WebChatUnavailable_3miRM0000004CuZ_8003848</customLabel>
17 <labelKey>CM_Container_MenuItems_WebChatUnavailable</labelKey>
18 </embeddedServiceCustomLabels>
19 <embeddedServiceCustomLabels>
20 <customLabel>CM_Container_MenuItems_WebChatAvailable_3miRM0000004CuZ_5823055</customLabel>
21 <labelKey>CM_Container_MenuItems_WebChatAvailable</labelKey>
22 </embeddedServiceCustomLabels>
23 <itemName>Chat1</itemName>
24 <osOptionsHideInIOS>false</osOptionsHideInIOS>
25 <osOptionsHideInLinuxOS>true</osOptionsHideInLinuxOS>
26 <osOptionsHideInMacOS>false</osOptionsHideInMacOS>
27 <osOptionsHideInOtherOS>false</osOptionsHideInOtherOS>
28 <osOptionsHideInWindowsOS>true</osOptionsHideInWindowsOS>
29 <shouldOpenUrlInSameTab>false</shouldOpenUrlInSameTab>
30 </embeddedServiceMenuItems>
31 <embeddedServiceMenuItems>
32 <channelType>Phone</channelType>
33 <displayOrder>2</displayOrder>
34 <itemName>Phone1</itemName>
35 <osOptionsHideInIOS>true</osOptionsHideInIOS>
36 <osOptionsHideInLinuxOS>false</osOptionsHideInLinuxOS>
37 <osOptionsHideInMacOS>true</osOptionsHideInMacOS>
38 <osOptionsHideInOtherOS>false</osOptionsHideInOtherOS>
39 <osOptionsHideInWindowsOS>false</osOptionsHideInWindowsOS>
40 <phoneNumber>1234567890</phoneNumber>
41 <shouldOpenUrlInSameTab>false</shouldOpenUrlInSameTab>
42 </embeddedServiceMenuItems>
43 <embeddedServiceMenuItems>
44 <channelType>CustomURL</channelType>
45 <customUrl>https://google.com</customUrl>
46 <displayOrder>3</displayOrder>
47 <itemName>url1</itemName>
48 <osOptionsHideInIOS>false</osOptionsHideInIOS>
49 <osOptionsHideInLinuxOS>false</osOptionsHideInLinuxOS>
50 <osOptionsHideInMacOS>false</osOptionsHideInMacOS>
51 <osOptionsHideInOtherOS>false</osOptionsHideInOtherOS>
52 <osOptionsHideInWindowsOS>false</osOptionsHideInWindowsOS>
53 <shouldOpenUrlInSameTab>false</shouldOpenUrlInSameTab>
54 </embeddedServiceMenuItems>
55 <isEnabled>true</isEnabled>
56 <masterLabel>ChannelMenuSettings</masterLabel>
57 <site>SnapInCommunity</site>
58</EmbeddedServiceMenuSettings>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.