telnyx 5.120.0 → 5.121.0

data/lib/telnyx/models/calls/action_answer_params.rb

@@ -42,6 +42,17 @@ module Telnyx
         #   @return [String, nil]
         optional :command_id, String
 
+        # @!attribute conversation_relay_config
+        #   Starts a Conversation Relay session automatically when the answered/dialed call
+        #   is answered. This embedded shape is supported on `answer` and `dial`. It uses
+        #   public field names (`url`, `dtmf_detection`, `greeting`, `voice`, `language`,
+        #   etc.) and maps them to the underlying Conversation Relay action. `client_state`,
+        #   `tts_language`, and `transcription_language` inside this object are ignored; use
+        #   the parent command's `client_state` and `command_id` fields instead.
+        #
+        #   @return [Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig, nil]
+        optional :conversation_relay_config, -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig }
+
         # @!attribute custom_headers
         #   Custom headers to be added to the SIP INVITE response.
         #
@@ -227,7 +238,7 @@ module Telnyx
         #   @return [Symbol, Telnyx::Models::Calls::ActionAnswerParams::WebhookURLsMethod, nil]
         optional :webhook_urls_method, enum: -> { Telnyx::Calls::ActionAnswerParams::WebhookURLsMethod }
 
-        # @!method initialize(call_control_id:, assistant: nil, billing_group_id: nil, client_state: nil, command_id: nil, custom_headers: nil, deepfake_detection: nil, preferred_codecs: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, send_silence_when_idle: nil, sip_headers: nil, sound_modifications: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_track: nil, stream_url: nil, transcription: nil, transcription_config: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
+        # @!method initialize(call_control_id:, assistant: nil, billing_group_id: nil, client_state: nil, command_id: nil, conversation_relay_config: nil, custom_headers: nil, deepfake_detection: nil, preferred_codecs: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, send_silence_when_idle: nil, sip_headers: nil, sound_modifications: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_track: nil, stream_url: nil, transcription: nil, transcription_config: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::Calls::ActionAnswerParams} for more details.
         #
@@ -241,6 +252,8 @@ module Telnyx
         #
         #   @param command_id [String] Use this field to avoid duplicate commands. Telnyx will ignore any command with
         #
+        #   @param conversation_relay_config [Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig] Starts a Conversation Relay session automatically when the answered/dialed call
+        #
         #   @param custom_headers [Array<Telnyx::Models::CustomSipHeader>] Custom headers to be added to the SIP INVITE response.
         #
         #   @param deepfake_detection [Telnyx::Models::Calls::ActionAnswerParams::DeepfakeDetection] Enables deepfake detection on the call. When enabled, audio from the remote part
@@ -298,6 +311,548 @@ module Telnyx
         #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
+        class ConversationRelayConfig < Telnyx::Internal::Type::BaseModel
+          # @!attribute url
+          #   WebSocket URL for your Conversation Relay server. Must start with `ws://` or
+          #   `wss://`.
+          #
+          #   @return [String]
+          required :url, String
+
+          # @!attribute custom_parameters
+          #   Custom key-value parameters forwarded to the relay session as assistant dynamic
+          #   variables.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :custom_parameters, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute dtmf_detection
+          #   Enable DTMF detection for the relay session.
+          #
+          #   @return [Boolean, nil]
+          optional :dtmf_detection, Telnyx::Internal::Type::Boolean
+
+          # @!attribute greeting
+          #   Text played when the relay session starts.
+          #
+          #   @return [String, nil]
+          optional :greeting, String
+
+          # @!attribute interruptible
+          #   Controls when caller input can interrupt assistant speech. `any` allows speech
+          #   or DTMF interruptions; `none` disables interruptions; `speech` allows speech
+          #   only; `dtmf` allows DTMF only.
+          #
+          #   @return [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Interruptible, nil]
+          optional :interruptible,
+                   enum: -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::Interruptible }
+
+          # @!attribute interruptible_greeting
+          #   Controls when caller input can interrupt assistant speech. `any` allows speech
+          #   or DTMF interruptions; `none` disables interruptions; `speech` allows speech
+          #   only; `dtmf` allows DTMF only.
+          #
+          #   @return [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptibleGreeting, nil]
+          optional :interruptible_greeting,
+                   enum: -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptibleGreeting }
+
+          # @!attribute interruption_settings
+          #   Settings for handling caller interruptions during Conversation Relay speech.
+          #
+          #   @return [Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings, nil]
+          optional :interruption_settings,
+                   -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings }
+
+          # @!attribute language
+          #   Default language for both text-to-speech and speech recognition.
+          #
+          #   @return [String, nil]
+          optional :language, String
+
+          # @!attribute languages
+          #   Per-language TTS and transcription settings.
+          #
+          #   @return [Array<Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Language>, nil]
+          optional :languages,
+                   -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::Language] }
+
+          # @!attribute provider
+          #   Structured voice provider. Must be supplied together with `structured_provider`.
+          #
+          #   @return [String, nil]
+          optional :provider, String
+
+          # @!attribute structured_provider
+          #   Provider-specific structured voice settings. Must be supplied together with
+          #   `provider`; Telnyx sends the value as the nested provider configuration for
+          #   Conversation Relay.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :structured_provider, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute transcription_engine
+          #   Engine to use for speech recognition. Legacy values `A` - `Google`, `B` -
+          #   `Telnyx` are supported for backward compatibility. For Conversation Relay, use
+          #   this field with `transcription_engine_config`; the `transcription` object is not
+          #   supported.
+          #
+          #   @return [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::TranscriptionEngine, nil]
+          optional :transcription_engine,
+                   enum: -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::TranscriptionEngine }
+
+          # @!attribute transcription_engine_config
+          #   Engine-specific transcription settings for Conversation Relay. This accepts the
+          #   same provider-specific options used by the Call Transcription Start command,
+          #   such as `transcription_model`, without requiring the engine discriminator to be
+          #   repeated inside this object.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :transcription_engine_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute tts_provider
+          #   Text-to-speech provider. If omitted, Telnyx derives it from `voice` or
+          #   `provider`.
+          #
+          #   @return [String, nil]
+          optional :tts_provider, String
+
+          # @!attribute voice
+          #   The voice to be used by the voice assistant. Currently we support ElevenLabs,
+          #   Telnyx and AWS voices.
+          #
+          #   **Supported Providers:**
+          #
+          #   - **AWS:** Use `AWS.Polly.<VoiceId>` (e.g., `AWS.Polly.Joanna`). For neural
+          #     voices, which provide more realistic, human-like speech, append `-Neural` to
+          #     the `VoiceId` (e.g., `AWS.Polly.Joanna-Neural`). Check the
+          #     [available voices](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html)
+          #     for compatibility.
+          #   - **Azure:** Use `Azure.<VoiceId>. (e.g. Azure.en-CA-ClaraNeural,
+          #     Azure.en-CA-LiamNeural, Azure.en-US-BrianMultilingualNeural,
+          #     Azure.en-US-Ava:DragonHDLatestNeural. For a complete list of voices, go to
+          #     [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).)
+          #   - **ElevenLabs:** Use `ElevenLabs.<ModelId>.<VoiceId>` (e.g.,
+          #     `ElevenLabs.BaseModel.John`). The `ModelId` part is optional. To use
+          #     ElevenLabs, you must provide your ElevenLabs API key as an integration secret
+          #     under `"voice_settings": {"api_key_ref": "<secret_id>"}`. See
+          #     [integration secrets documentation](https://developers.telnyx.com/api/secrets-manager/integration-secrets/create-integration-secret)
+          #     for details. Check
+          #     [available voices](https://elevenlabs.io/docs/api-reference/get-voices).
+          #   - **Telnyx:** Use `Telnyx.<model_id>.<voice_id>`
+          #   - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
+          #     `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+          #   - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+          #     `ara`, `rex`, `sal`, `leo`.
+          #
+          #   @return [String, nil]
+          optional :voice, String
+
+          # @!attribute voice_settings
+          #   The settings associated with the voice selected
+          #
+          #   @return [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings, nil]
+          optional :voice_settings,
+                   union: -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::VoiceSettings }
+
+          # @!method initialize(url:, custom_parameters: nil, dtmf_detection: nil, greeting: nil, interruptible: nil, interruptible_greeting: nil, interruption_settings: nil, language: nil, languages: nil, provider: nil, structured_provider: nil, transcription_engine: nil, transcription_engine_config: nil, tts_provider: nil, voice: nil, voice_settings: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig} for more
+          #   details.
+          #
+          #   Starts a Conversation Relay session automatically when the answered/dialed call
+          #   is answered. This embedded shape is supported on `answer` and `dial`. It uses
+          #   public field names (`url`, `dtmf_detection`, `greeting`, `voice`, `language`,
+          #   etc.) and maps them to the underlying Conversation Relay action. `client_state`,
+          #   `tts_language`, and `transcription_language` inside this object are ignored; use
+          #   the parent command's `client_state` and `command_id` fields instead.
+          #
+          #   @param url [String] WebSocket URL for your Conversation Relay server. Must start with `ws://` or `ws
+          #
+          #   @param custom_parameters [Hash{Symbol=>Object}] Custom key-value parameters forwarded to the relay session as assistant dynamic
+          #
+          #   @param dtmf_detection [Boolean] Enable DTMF detection for the relay session.
+          #
+          #   @param greeting [String] Text played when the relay session starts.
+          #
+          #   @param interruptible [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Interruptible] Controls when caller input can interrupt assistant speech. `any` allows speech o
+          #
+          #   @param interruptible_greeting [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptibleGreeting] Controls when caller input can interrupt assistant speech. `any` allows speech o
+          #
+          #   @param interruption_settings [Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings] Settings for handling caller interruptions during Conversation Relay speech.
+          #
+          #   @param language [String] Default language for both text-to-speech and speech recognition.
+          #
+          #   @param languages [Array<Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Language>] Per-language TTS and transcription settings.
+          #
+          #   @param provider [String] Structured voice provider. Must be supplied together with `structured_provider`.
+          #
+          #   @param structured_provider [Hash{Symbol=>Object}] Provider-specific structured voice settings. Must be supplied together with `pro
+          #
+          #   @param transcription_engine [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::TranscriptionEngine] Engine to use for speech recognition. Legacy values `A` - `Google`, `B` - `Telny
+          #
+          #   @param transcription_engine_config [Hash{Symbol=>Object}] Engine-specific transcription settings for Conversation Relay. This accepts the
+          #
+          #   @param tts_provider [String] Text-to-speech provider. If omitted, Telnyx derives it from `voice` or `provider
+          #
+          #   @param voice [String] The voice to be used by the voice assistant. Currently we support ElevenLabs, Te
+          #
+          #   @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+
+          # Controls when caller input can interrupt assistant speech. `any` allows speech
+          # or DTMF interruptions; `none` disables interruptions; `speech` allows speech
+          # only; `dtmf` allows DTMF only.
+          #
+          # @see Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig#interruptible
+          module Interruptible
+            extend Telnyx::Internal::Type::Enum
+
+            NONE = :none
+            ANY = :any
+            SPEECH = :speech
+            DTMF = :dtmf
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Controls when caller input can interrupt assistant speech. `any` allows speech
+          # or DTMF interruptions; `none` disables interruptions; `speech` allows speech
+          # only; `dtmf` allows DTMF only.
+          #
+          # @see Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig#interruptible_greeting
+          module InterruptibleGreeting
+            extend Telnyx::Internal::Type::Enum
+
+            NONE = :none
+            ANY = :any
+            SPEECH = :speech
+            DTMF = :dtmf
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig#interruption_settings
+          class InterruptionSettings < Telnyx::Internal::Type::BaseModel
+            # @!attribute enable
+            #   Legacy boolean form. `true` is equivalent to `interruptible=any`; `false` is
+            #   equivalent to `interruptible=none`.
+            #
+            #   @return [Boolean, nil]
+            optional :enable, Telnyx::Internal::Type::Boolean
+
+            # @!attribute interruptible
+            #   Controls when caller input can interrupt assistant speech. `any` allows speech
+            #   or DTMF interruptions; `none` disables interruptions; `speech` allows speech
+            #   only; `dtmf` allows DTMF only.
+            #
+            #   @return [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings::Interruptible, nil]
+            optional :interruptible,
+                     enum: -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings::Interruptible }
+
+            # @!attribute interruptible_greeting
+            #   Controls when caller input can interrupt assistant speech. `any` allows speech
+            #   or DTMF interruptions; `none` disables interruptions; `speech` allows speech
+            #   only; `dtmf` allows DTMF only.
+            #
+            #   @return [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings::InterruptibleGreeting, nil]
+            optional :interruptible_greeting,
+                     enum: -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings::InterruptibleGreeting }
+
+            # @!attribute welcome_greeting_interruptible
+            #   Controls when caller input can interrupt assistant speech. `any` allows speech
+            #   or DTMF interruptions; `none` disables interruptions; `speech` allows speech
+            #   only; `dtmf` allows DTMF only.
+            #
+            #   @return [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings::WelcomeGreetingInterruptible, nil]
+            optional :welcome_greeting_interruptible,
+                     enum: -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings::WelcomeGreetingInterruptible }
+
+            # @!method initialize(enable: nil, interruptible: nil, interruptible_greeting: nil, welcome_greeting_interruptible: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings}
+            #   for more details.
+            #
+            #   Settings for handling caller interruptions during Conversation Relay speech.
+            #
+            #   @param enable [Boolean] Legacy boolean form. `true` is equivalent to `interruptible=any`; `false` is equ
+            #
+            #   @param interruptible [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings::Interruptible] Controls when caller input can interrupt assistant speech. `any` allows speech o
+            #
+            #   @param interruptible_greeting [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings::InterruptibleGreeting] Controls when caller input can interrupt assistant speech. `any` allows speech o
+            #
+            #   @param welcome_greeting_interruptible [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings::WelcomeGreetingInterruptible] Controls when caller input can interrupt assistant speech. `any` allows speech o
+
+            # Controls when caller input can interrupt assistant speech. `any` allows speech
+            # or DTMF interruptions; `none` disables interruptions; `speech` allows speech
+            # only; `dtmf` allows DTMF only.
+            #
+            # @see Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings#interruptible
+            module Interruptible
+              extend Telnyx::Internal::Type::Enum
+
+              NONE = :none
+              ANY = :any
+              SPEECH = :speech
+              DTMF = :dtmf
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Controls when caller input can interrupt assistant speech. `any` allows speech
+            # or DTMF interruptions; `none` disables interruptions; `speech` allows speech
+            # only; `dtmf` allows DTMF only.
+            #
+            # @see Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings#interruptible_greeting
+            module InterruptibleGreeting
+              extend Telnyx::Internal::Type::Enum
+
+              NONE = :none
+              ANY = :any
+              SPEECH = :speech
+              DTMF = :dtmf
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Controls when caller input can interrupt assistant speech. `any` allows speech
+            # or DTMF interruptions; `none` disables interruptions; `speech` allows speech
+            # only; `dtmf` allows DTMF only.
+            #
+            # @see Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::InterruptionSettings#welcome_greeting_interruptible
+            module WelcomeGreetingInterruptible
+              extend Telnyx::Internal::Type::Enum
+
+              NONE = :none
+              ANY = :any
+              SPEECH = :speech
+              DTMF = :dtmf
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          class Language < Telnyx::Internal::Type::BaseModel
+            # @!attribute language
+            #   BCP 47 language tag for this language configuration.
+            #
+            #   @return [String]
+            required :language, String
+
+            # @!attribute speech_model
+            #   Conversation Relay speech model. Prefer
+            #   `transcription_engine_config.transcription_model` when configuring
+            #   speech-to-text.
+            #
+            #   @return [String, nil]
+            optional :speech_model, String
+
+            # @!attribute transcription_engine
+            #   Engine to use for speech recognition. Legacy values `A` - `Google`, `B` -
+            #   `Telnyx` are supported for backward compatibility. When provided in a
+            #   Conversation Relay language entry, Telnyx derives `transcription_provider` and
+            #   `speech_model` for that language.
+            #
+            #   @return [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Language::TranscriptionEngine, nil]
+            optional :transcription_engine,
+                     enum: -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::Language::TranscriptionEngine }
+
+            # @!attribute transcription_engine_config
+            #   Engine-specific transcription settings for Conversation Relay. This accepts the
+            #   same provider-specific options used by the Call Transcription Start command,
+            #   such as `transcription_model`, without requiring the engine discriminator to be
+            #   repeated inside this object.
+            #
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional :transcription_engine_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+            # @!attribute transcription_provider
+            #   Conversation Relay transcription provider name. Prefer `transcription_engine`
+            #   when configuring speech-to-text.
+            #
+            #   @return [String, nil]
+            optional :transcription_provider, String
+
+            # @!attribute tts_provider
+            #   Text-to-speech provider for this language. If omitted and `voice` is provided,
+            #   Telnyx derives the provider from the voice identifier.
+            #
+            #   @return [String, nil]
+            optional :tts_provider, String
+
+            # @!attribute voice
+            #   Voice identifier for this language.
+            #
+            #   @return [String, nil]
+            optional :voice, String
+
+            # @!attribute voice_settings
+            #   The settings associated with the voice selected
+            #
+            #   @return [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Language::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings, nil]
+            optional :voice_settings,
+                     union: -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::Language::VoiceSettings }
+
+            # @!method initialize(language:, speech_model: nil, transcription_engine: nil, transcription_engine_config: nil, transcription_provider: nil, tts_provider: nil, voice: nil, voice_settings: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Language}
+            #   for more details.
+            #
+            #   Language-specific TTS and transcription settings for Conversation Relay.
+            #
+            #   @param language [String] BCP 47 language tag for this language configuration.
+            #
+            #   @param speech_model [String] Conversation Relay speech model. Prefer `transcription_engine_config.transcripti
+            #
+            #   @param transcription_engine [Symbol, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Language::TranscriptionEngine] Engine to use for speech recognition. Legacy values `A` - `Google`, `B` - `Telny
+            #
+            #   @param transcription_engine_config [Hash{Symbol=>Object}] Engine-specific transcription settings for Conversation Relay. This accepts the
+            #
+            #   @param transcription_provider [String] Conversation Relay transcription provider name. Prefer `transcription_engine` wh
+            #
+            #   @param tts_provider [String] Text-to-speech provider for this language. If omitted and `voice` is provided, T
+            #
+            #   @param voice [String] Voice identifier for this language.
+            #
+            #   @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Language::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+
+            # Engine to use for speech recognition. Legacy values `A` - `Google`, `B` -
+            # `Telnyx` are supported for backward compatibility. When provided in a
+            # Conversation Relay language entry, Telnyx derives `transcription_provider` and
+            # `speech_model` for that language.
+            #
+            # @see Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Language#transcription_engine
+            module TranscriptionEngine
+              extend Telnyx::Internal::Type::Enum
+
+              GOOGLE = :Google
+              TELNYX = :Telnyx
+              DEEPGRAM = :Deepgram
+              AZURE = :Azure
+              X_AI = :xAI
+              ASSEMBLY_AI = :AssemblyAI
+              SPEECHMATICS = :Speechmatics
+              SONIOX = :Soniox
+              A = :A
+              B = :B
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # The settings associated with the voice selected
+            #
+            # @see Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Language#voice_settings
+            module VoiceSettings
+              extend Telnyx::Internal::Type::Union
+
+              discriminator :type
+
+              variant :elevenlabs, -> { Telnyx::Calls::ElevenLabsVoiceSettings }
+
+              variant :telnyx, -> { Telnyx::Calls::TelnyxVoiceSettings }
+
+              variant :aws, -> { Telnyx::Calls::AwsVoiceSettings }
+
+              variant :minimax, -> { Telnyx::MinimaxVoiceSettings }
+
+              variant :azure, -> { Telnyx::AzureVoiceSettings }
+
+              variant :rime, -> { Telnyx::RimeVoiceSettings }
+
+              variant :resemble, -> { Telnyx::ResembleVoiceSettings }
+
+              variant :inworld,
+                      -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::Language::VoiceSettings::Inworld }
+
+              variant :xai, -> { Telnyx::XaiVoiceSettings }
+
+              class Inworld < Telnyx::Internal::Type::BaseModel
+                # @!attribute type
+                #   Voice settings provider type
+                #
+                #   @return [Symbol, :inworld]
+                required :type, const: :inworld
+
+                # @!method initialize(type: :inworld)
+                #   @param type [Symbol, :inworld] Voice settings provider type
+              end
+
+              # @!method self.variants
+              #   @return [Array(Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::Language::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings)]
+            end
+          end
+
+          # Engine to use for speech recognition. Legacy values `A` - `Google`, `B` -
+          # `Telnyx` are supported for backward compatibility. For Conversation Relay, use
+          # this field with `transcription_engine_config`; the `transcription` object is not
+          # supported.
+          #
+          # @see Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig#transcription_engine
+          module TranscriptionEngine
+            extend Telnyx::Internal::Type::Enum
+
+            GOOGLE = :Google
+            TELNYX = :Telnyx
+            DEEPGRAM = :Deepgram
+            AZURE = :Azure
+            X_AI = :xAI
+            ASSEMBLY_AI = :AssemblyAI
+            SPEECHMATICS = :Speechmatics
+            SONIOX = :Soniox
+            A = :A
+            B = :B
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The settings associated with the voice selected
+          #
+          # @see Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig#voice_settings
+          module VoiceSettings
+            extend Telnyx::Internal::Type::Union
+
+            discriminator :type
+
+            variant :elevenlabs, -> { Telnyx::Calls::ElevenLabsVoiceSettings }
+
+            variant :telnyx, -> { Telnyx::Calls::TelnyxVoiceSettings }
+
+            variant :aws, -> { Telnyx::Calls::AwsVoiceSettings }
+
+            variant :minimax, -> { Telnyx::MinimaxVoiceSettings }
+
+            variant :azure, -> { Telnyx::AzureVoiceSettings }
+
+            variant :rime, -> { Telnyx::RimeVoiceSettings }
+
+            variant :resemble, -> { Telnyx::ResembleVoiceSettings }
+
+            variant :inworld,
+                    -> { Telnyx::Calls::ActionAnswerParams::ConversationRelayConfig::VoiceSettings::Inworld }
+
+            variant :xai, -> { Telnyx::XaiVoiceSettings }
+
+            class Inworld < Telnyx::Internal::Type::BaseModel
+              # @!attribute type
+              #   Voice settings provider type
+              #
+              #   @return [Symbol, :inworld]
+              required :type, const: :inworld
+
+              # @!method initialize(type: :inworld)
+              #   @param type [Symbol, :inworld] Voice settings provider type
+            end
+
+            # @!method self.variants
+            #   @return [Array(Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionAnswerParams::ConversationRelayConfig::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings)]
+          end
+        end
+
         class DeepfakeDetection < Telnyx::Internal::Type::BaseModel
           # @!attribute enabled
           #   Whether deepfake detection is enabled.