VoiceSettings

Represents an org’s Sales Dialer settings, such as call recording, conferencing, and voicemail.

In the package manifest, all organization settings metadata types are accessed using the Settings name. See Settings for details.

This type extends Metadata and inherits its fields.

VoiceSettings values are stored in the Voice.settings file in the settings directory. The .settings files are different from other named components because there’s only one settings file for each settings component.

Introduced in API version 47.0.

• Type: boolean

• Required: No

• Description: Indicates whether call disposition is enabled (true) or not (false). With call disposition, also called Call Result, sales reps can track whether a call was connected and how it went.

  Default value is false. To use this feature, enable Dialer in Lightning Experience.

• Type: boolean

• Required: No

• Description: Indicates whether the consent reminder is enabled (true) or not (false). With the consent reminder, prior to recording a call, users see a prompt reminding them not to record phone calls without consent.

  Default value is false. To use this feature, enable Dialer in Lightning Experience.

• Type: boolean

• Required: No

• Introduced: API version 54.0

• Description: Indicates whether the default recording is enabled (true) or not (false). With default recording, sales reps can record calls automatically in the Sales Dialer.

  Default value is false.

• Type: boolean

• Required: No

• Description: Indicates whether Call List is enabled (true) or not (false). Sales reps can use call list to keep a running list of the calls they want to make.

  Default value is false. To use this feature, enable Dialer in Lightning Experience.

• Type: boolean

• Required: No

• Description: Indicates whether Call Recording is enabled (true) or not (false). Sales reps can record important calls directly from the call panel in Sales Dialer.

  Default value is false. To use this feature, enable Dialer in Lightning Experience.

• Type: boolean

• Required: No

• Description: Indicates whether Call Monitoring is enabled (true) or not (false). Using the Monitor tab in the call panel, managers can listen to the calls of their sales reps for personalized coaching.

  Default value is false. To use this feature, enable Dialer in Lightning Experience.

• Type: boolean
• Required: No
• Description: Reserved for future use.

• Type: boolean

• Required: No

• Description: Indicates whether Local Presence is enabled (true) or not (false). Local Presence displays phone numbers with the same area code as the prospects your reps are calling, so more calls are answered.

  Default value is false. To use this feature, enable Dialer in Lightning Experience.

• Type: boolean

• Required: No

• Description: Indicates whether voicemail is enabled (true) or not (false). Sales reps can receive and store up to 20 personal voicemail messages in Salesforce.

  Default value is false. To use this feature, enable Dialer in Lightning Experience.

• Type: boolean

• Required: No

• Description: Indicates whether Voicemail Drop is enabled (true) or not (false). Sales reps can “drop” (or send) prerecorded messages to recipients’ voicemail boxes.

  Default value is false. To use this feature, enable Dialer in Lightning Experience.

The following is an example of the package file.

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4    </types>
5    <version>28.0</version>
6</Package>

The package file references the following Voice.settings file.

1<?xml version="1.0" encoding="UTF-8"?>
2<VoiceSettings xmlns="http://soap.sforce.com/2006/04/metadata">
3    <enableCallDisposition>true</enableCallDisposition>
4    <enableVoiceCallList>true</enableVoiceCallList>
5    <enableVoiceCallRecording>true</enableVoiceCallRecording>
6    <enableVoiceCoaching>true</enableVoiceCoaching>
7    <enableVoiceConferencing>true</enableVoiceConferencing>
8    <enableVoiceLocalPresence>true</enableVoiceLocalPresence>
9    <enableVoiceMail>true</enableVoiceMail>
10    <enableVoiceMailDrop>true</enableVoiceMailDrop>
11</VoiceSettings>

The wildcard character * (asterisk) in the package.xml manifest file doesn’t apply to metadata types for feature settings. The wildcard applies only when retrieving all settings, not for an individual setting. For details, see Settings. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.