---
schema_version: "1"
id: 547b515d4ce518bd4a9d10c83ae2b23478f84aab19bd1bbc2459cde02291061e
title: VoiceSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_voicesettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_voicesettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 5748a9e54b0df29778c2a9859b2f60e6a6b92d91e8286c1af68c3e3188952ea7
description: Represents an org’s Sales Dialer settings, such as call recording, conferencing, and voicemail.
---
# VoiceSettings

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

This type extends the [Metadata](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/metadata.htm "The base class for all metadata types. You can’t edit this object. A component is an instance of a metadata type.") metadata type and inherits its fullName field.

In the package manifest, all organization settings metadata types are accessed using the Settings name. See [Settings](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_settings.htm "Represents the organization settings related to a feature. For example, your password policies, session settings and network access controls are all available in the SecuritySettings component type.") for details.

## File Suffix and Directory Location

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.

## Version

VoiceSettings is available in API version 47.0 and later.

## Fields

<table class="featureTable sort_table" summary="">



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d1012003e113">Field Name</th>

              <th class="featureTableHeader  " id="d1012003e116">Field Type</th>

              <th class="featureTableHeader  " id="d1012003e119">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d1012003e113" data-title="Field Name"><span class="keyword parmname">enableCallDisposition</span></td>

              <td class="entry" headers="d1012003e116" data-title="Field Type">boolean</td>

              <td class="entry" headers="d1012003e119" data-title="Description">Indicates whether call disposition is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). With call disposition, also
                called Call Result, sales reps can track whether a call was
                connected and how it went.<p class="p">Default value is <samp class="codeph nolang">false</samp>. To use this feature,
                  enable Dialer in Lightning Experience. </p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1012003e113" data-title="Field Name"><span class="keyword parmname">enableConsentReminder</span></td>

              <td class="entry" headers="d1012003e116" data-title="Field Type">boolean</td>

              <td class="entry" headers="d1012003e119" data-title="Description">Indicates whether the consent reminder is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). With the consent reminder,
                prior to recording a call, users see a prompt reminding them not to
                record phone calls without consent.<p class="p">Default value is <samp class="codeph nolang">false</samp>. To use this feature,
                  enable Dialer in Lightning Experience. </p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1012003e113" data-title="Field Name">enableDefaultRecording</td>

              <td class="entry" headers="d1012003e116" data-title="Field Type">boolean</td>

              <td class="entry" headers="d1012003e119" data-title="Description">Indicates whether the default recording is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). With default recording,
                sales reps can record calls automatically in the Sales
                Dialer.<p class="p">Default value is <samp class="codeph nolang">false</samp>. This field is available in API version 54.0
                  and later.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1012003e113" data-title="Field Name"><span class="keyword parmname">enableVoiceCallList</span></td>

              <td class="entry" headers="d1012003e116" data-title="Field Type">boolean</td>

              <td class="entry" headers="d1012003e119" data-title="Description">Indicates whether Call List is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). Sales reps can use call
                list to keep a running list of the calls they want to make.
                <p class="p">Default value is <samp class="codeph nolang">false</samp>.
                  To use this feature, enable Dialer in Lightning Experience.
                </p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1012003e113" data-title="Field Name"><span class="keyword parmname">enableVoiceCallRecording</span></td>

              <td class="entry" headers="d1012003e116" data-title="Field Type">boolean</td>

              <td class="entry" headers="d1012003e119" data-title="Description">Indicates whether Call Recording is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). Sales reps can record
                important calls directly from the call panel in Sales Dialer.
                <p class="p">Default value is <samp class="codeph nolang">false</samp>.
                  To use this feature, enable Dialer in Lightning Experience.
                </p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1012003e113" data-title="Field Name"><span class="keyword parmname">enableVoiceCoaching</span></td>

              <td class="entry" headers="d1012003e116" data-title="Field Type">boolean</td>

              <td class="entry" headers="d1012003e119" data-title="Description">Indicates whether Call Monitoring is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). Using the Monitor tab in
                the call panel, managers can listen to the calls of their sales reps
                for personalized coaching.<p class="p">Default value is <samp class="codeph nolang">false</samp>. To use this feature,
                  enable Dialer in Lightning Experience. </p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1012003e113" data-title="Field Name"><span class="keyword parmname">enableVoiceConferencing</span></td>

              <td class="entry" headers="d1012003e116" data-title="Field Type">boolean</td>

              <td class="entry" headers="d1012003e119" data-title="Description">Reserved for future use. </td>

            </tr>

            <tr>
              <td class="entry" headers="d1012003e113" data-title="Field Name"><span class="keyword parmname">enableVoiceLocalPresence</span></td>

              <td class="entry" headers="d1012003e116" data-title="Field Type">boolean</td>

              <td class="entry" headers="d1012003e119" data-title="Description">Indicates whether Local Presence is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). Local Presence displays
                phone numbers with the same area code as the prospects your reps are
                calling, so more calls are answered.<p class="p">Default value is <samp class="codeph nolang">false</samp>. To use this feature,
                  enable Dialer in Lightning Experience. </p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1012003e113" data-title="Field Name"><span class="keyword parmname">enableVoiceMail</span></td>

              <td class="entry" headers="d1012003e116" data-title="Field Type">boolean</td>

              <td class="entry" headers="d1012003e119" data-title="Description">Indicates whether voicemail is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). Sales reps can receive and
                store up to 20 personal voicemail messages in Salesforce. <p class="p">Default
                  value is <samp class="codeph nolang">false</samp>. To use this
                  feature, enable Dialer in Lightning Experience. </p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1012003e113" data-title="Field Name"><span class="keyword parmname">enableVoiceMailDrop</span></td>

              <td class="entry" headers="d1012003e116" data-title="Field Type">boolean</td>

              <td class="entry" headers="d1012003e119" data-title="Description">Indicates whether Voicemail Drop is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). Sales reps can “drop” (or
                send) prerecorded messages to recipients’ voicemail boxes.
                <p class="p">Default value is <samp class="codeph nolang">false</samp>.
                  To use this feature, enable Dialer in Lightning Experience.
                </p>
              </td>

            </tr>

          </tbody>

        </table>

## Declarative Metadata Sample Definition

The following is an example of the package file.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types\>
    </types\>
    <version\>28.0</version\>
</Package\>

The package file references the following Voice.settings file.

<?xml version="1.0" encoding="UTF-8"?>
<VoiceSettings xmlns="http://soap.sforce.com/2006/04/metadata">
    <enableCallDisposition\>true</enableCallDisposition\>
    <enableVoiceCallList\>true</enableVoiceCallList\>
    <enableVoiceCallRecording\>true</enableVoiceCallRecording\>
    <enableVoiceCoaching\>true</enableVoiceCoaching\>
    <enableVoiceConferencing\>true</enableVoiceConferencing\>
    <enableVoiceLocalPresence\>true</enableVoiceLocalPresence\>
    <enableVoiceMail\>true</enableVoiceMail\>
    <enableVoiceMailDrop\>true</enableVoiceMailDrop\>
</VoiceSettings\>

## Wildcard Support in the Manifest File

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](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/meta_settings.htm). For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).