--- schema_version: "1" id: e9d0f95b823991e42a7013df7ca08f6fdf402c70b7c413188dd015c68ba344c7 title: AiPlannerVoiceDef collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_aiplannervoicedef.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_aiplannervoicedef.htm source_site: developer.salesforce.com content_type: documentation content_hash: 3938db7cf4eab24f4d1759f603f73c1181159fe12af4daf808da97dbf75287a6 description: Represents a voice definition for an Agentforce voice agent. It stores the speech-to-text and text-to-speech configuration settings used during voice interactions, including model selection, voice persona, and audio synthesis parameters. --- # AiPlannerVoiceDef Represents a voice definition for an Agentforce voice agent. It stores the speech-to-text and text-to-speech configuration settings used during voice interactions, including model selection, voice persona, and audio synthesis parameters. ## Parent Type 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. ## File Suffix and Directory Location AiPlannerVoiceDef components have the suffix .aiPlannerVoiceDef and are stored in the aiPlannerVoiceDef folder. ## Version AiPlannerVoiceDef components are available in API version 63.0 and later. ## Special Access Rules AiPlannerVoiceDef is available only if Agents and Agentforce Voice are enabled in your org. ## Fields | Field Name | Description | | --- | --- | | additionalConfigs | Field Type string Description A JSON string for extensible configuration settings not covered by explicit fields. Allows additional voice parameters to be stored without requiring schema changes. | | developerName | Field Type string Description Required. Represents the API name of the voice definition. This name must be unique across all voice definitions. Can contain only underscores and alphanumeric characters and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. | | inboundFillerWordsBool | Field Type boolean Description Specifies whether filler words (such as "um" or "uh") are included when processing inbound audio. When true, filler words are preserved in the transcription output. When false, they are stripped. | | inboundKeywords | Field Type string Description A JSON object of keywords or phrases with optional boost weights that improve speech recognition accuracy for inbound audio. Positive values increase recognition priority; negative values suppress. Example: {"keywords": {"Salesforce": 5, "Agentforce": 5, "cancel": -10}}. | | inboundModel | Field Type string Description The speech-to-text model used to transcribe inbound audio. References a deployed model record in MktMLAIModel (e.g., sfdc\_ai\_\_Default\_Nova\_2\_PhoneCall). | | label | Field Type string Description The user-facing label for this AiPlannerVoiceDef component as it appears in the Salesforce UI. | | languageCode | Field Type string Description The BCP 47 language code specifying the language used for voice processing, for example en-US for American English or ja-JP for Japanese. | | outboundFillerSentences | Field Type string Description A JSON object of filler sentences the voice agent speaks while processing a response, organized by category. Helps maintain natural conversational flow during pauses. Example: {"fillerSentences": {"waiting": \["Let me look into that...", "Just a moment..."\], "confirmation": \["Got it, let me confirm that."\], "fallback": \["Sorry, could you repeat that?"\]}}. | | outboundModel | Field Type string Description The text-to-speech model used to synthesize outbound audio. References a deployed model record in MktMLAIModel (e.g., sfdc\_ai\_\_Default\_Eleven\_Flash\_V2). | | outboundSimilarity | Field Type double Description A value between 0 and 1 that controls how closely the synthesized voice matches the selected voice profile. Higher values produce a more faithful reproduction; lower values allow more natural variation. Default is typically 0.75. | | outboundSpeedNum | Field Type double Description A multiplier that controls the speaking rate of the outbound voice. A value of 1.0 represents normal speed. Typical range is 0.7 (slower) to 1.2 (faster), depending on the voice persona's configured bounds. | | outboundStability | Field Type double Description A value between 0 and 1 that controls the consistency of the outbound voice tone and delivery. Higher values produce a more stable, predictable output; lower values introduce more expressive variation. Default is typically 0.65. | | outboundStyleExaggeration | Field Type double Description A value between 0 and 1 that amplifies the speaking style of the selected voice. Higher values increase expressiveness and emotional range in the synthesized speech. A value of 0 produces neutral delivery. | | outboundVoice | Field Type string Description The name of the voice persona used for text-to-speech synthesis in outbound audio (e.g., elevenlabs-Mark-en\_US). Maps to a voice configuration defined in the voice metadata layer. | | pronunciationDict | Field Type string Description A custom pronunciation dictionary that defines phonetic overrides for how specific words or phrases are pronounced by the text-to-speech engine. Useful for brand names, technical terms, or unusual proper nouns. | | voiceIdentifier | Field Type string Description A unique identifier for the voice configuration, typically the pre-computed hash ID from the voice metadata layer (e.g., f64af13e6fb0). Used to reference or distinguish this voice setup across planner configurations. | ## Declarative Metadata Sample Definition The following is an example of an AiPlannerVoiceDef component. This agent is either testing you, or you're testing it. My Test Agent AiCopilot\_\_ReAct dev2Automation false key2 sfdc\_ai\_\_DefaultOpenAIGPT35Turbo label2 test2 sfdc\_ai\_\_DefaultOpenAIGPT35Turbo 0.8 1.2 0.5 1.8 test2 The following is an example package.xml that references the previous definition. \* GenAiPlannerBundle 63.0