telnyx 5.120.0 → 5.121.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a656a53fa4d6d7859952723e3f213ba6ba97617e54f963077e93c1aae0c30bb
-  data.tar.gz: de70b45c695607e3081f869b92eb07a78e4ebefd8c51d54ac2fe9e8022342542
+  metadata.gz: d2c6aecc01814246ef9af70e1255e44ed476bd4754cd2ae9ce665e7e2ea811b0
+  data.tar.gz: 7c0a9a0c7c4feac1ac2240d645b1743ac3bf5f528ce8a2d521680a88c033edb4
 SHA512:
-  metadata.gz: 53bd897ac7b5648db78ef3cdcec615d3e84604fd39abd0cf76814f6ca533ac3039eb1cb3af6070e78d114b4ae285675f7961daf7edf6e69adf81609cadaf5176
-  data.tar.gz: e49688c8d1737b05c6782ab0082eb89e0aa2da83a4615e532e19db298a9c8361001b71179b431c5894f007f2135ac5c9dba4debaaeb1564678477b7e3ecce71d
+  metadata.gz: 80b8601c1ff1179c55101943ddcbc065d58d332c201d7d2efa14be8e1ca92057f2cad3c16b18b9c9c1c2356044075e2c08d7287ab30e79a8c60e8dfcb445ca0e
+  data.tar.gz: a9364137d59377c78e95310d3447952779b5b0cbc71652e7f73d9002f20113dc76a0bc829395982afc96cd6148c43a8ccbb203e45b41300839a50661fd1f84f8

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 5.121.0 (2026-05-27)
+
+Full Changelog: [v5.120.0...v5.121.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.120.0...v5.121.0)
+
+### Features
+
+* TELAPPS-5698 document conversation relay API shape ([5593ce0](https://github.com/team-telnyx/telnyx-ruby/commit/5593ce08483bd6b4e333cc52f1f90b6fc9db3402))
+
 ## 5.120.0 (2026-05-27)
 
 Full Changelog: [v5.119.0...v5.120.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.119.0...v5.120.0)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.120.0"
+gem "telnyx", "~> 5.121.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/models/call_dial_params.rb

@@ -127,6 +127,17 @@ module Telnyx
       #   @return [Telnyx::Models::CallDialParams::ConferenceConfig, nil]
       optional :conference_config, -> { Telnyx::CallDialParams::ConferenceConfig }
 
+      # @!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::CallDialParams::ConversationRelayConfig, nil]
+      optional :conversation_relay_config, -> { Telnyx::CallDialParams::ConversationRelayConfig }
+
       # @!attribute custom_headers
       #   Custom headers to be added to the SIP INVITE.
       #
@@ -475,7 +486,7 @@ module Telnyx
       #   @return [Symbol, Telnyx::Models::CallDialParams::WebhookURLsMethod, nil]
       optional :webhook_urls_method, enum: -> { Telnyx::CallDialParams::WebhookURLsMethod }
 
-      # @!method initialize(connection_id:, from:, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, assistant: nil, audio_url: nil, billing_group_id: nil, bridge_intent: nil, bridge_on_answer: nil, client_state: nil, command_id: nil, conference_config: nil, custom_headers: nil, deepfake_detection: nil, dialogflow_config: nil, enable_dialogflow: nil, from_display_name: nil, link_to: nil, media_encryption: nil, media_name: nil, park_after_unbridge: nil, preferred_codecs: nil, prevent_double_bridge: nil, privacy: 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_digits_on_answer: nil, send_silence_when_idle: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, stream_auth_token: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_sampling_rate: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_establish_before_call_originate: nil, stream_track: nil, stream_url: nil, supervise_call_control_id: nil, supervisor_role: nil, time_limit_secs: nil, timeout_secs: 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(connection_id:, from:, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, assistant: nil, audio_url: nil, billing_group_id: nil, bridge_intent: nil, bridge_on_answer: nil, client_state: nil, command_id: nil, conference_config: nil, conversation_relay_config: nil, custom_headers: nil, deepfake_detection: nil, dialogflow_config: nil, enable_dialogflow: nil, from_display_name: nil, link_to: nil, media_encryption: nil, media_name: nil, park_after_unbridge: nil, preferred_codecs: nil, prevent_double_bridge: nil, privacy: 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_digits_on_answer: nil, send_silence_when_idle: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, stream_auth_token: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_sampling_rate: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_establish_before_call_originate: nil, stream_track: nil, stream_url: nil, supervise_call_control_id: nil, supervisor_role: nil, time_limit_secs: nil, timeout_secs: 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::CallDialParams} for more details.
       #
@@ -505,6 +516,8 @@ module Telnyx
       #
       #   @param conference_config [Telnyx::Models::CallDialParams::ConferenceConfig] Optional configuration parameters to dial new participant into a conference.
       #
+      #   @param conversation_relay_config [Telnyx::Models::CallDialParams::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.
       #
       #   @param deepfake_detection [Telnyx::Models::CallDialParams::DeepfakeDetection] Enables deepfake detection on the call. When enabled, audio from the remote part
@@ -937,6 +950,543 @@ module Telnyx
         end
       end
 
+      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::CallDialParams::ConversationRelayConfig::Interruptible, nil]
+        optional :interruptible, enum: -> { Telnyx::CallDialParams::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::CallDialParams::ConversationRelayConfig::InterruptibleGreeting, nil]
+        optional :interruptible_greeting,
+                 enum: -> { Telnyx::CallDialParams::ConversationRelayConfig::InterruptibleGreeting }
+
+        # @!attribute interruption_settings
+        #   Settings for handling caller interruptions during Conversation Relay speech.
+        #
+        #   @return [Telnyx::Models::CallDialParams::ConversationRelayConfig::InterruptionSettings, nil]
+        optional :interruption_settings,
+                 -> { Telnyx::CallDialParams::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::CallDialParams::ConversationRelayConfig::Language>, nil]
+        optional :languages,
+                 -> { Telnyx::Internal::Type::ArrayOf[Telnyx::CallDialParams::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::CallDialParams::ConversationRelayConfig::TranscriptionEngine, nil]
+        optional :transcription_engine,
+                 enum: -> { Telnyx::CallDialParams::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::CallDialParams::ConversationRelayConfig::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings, nil]
+        optional :voice_settings, union: -> { Telnyx::CallDialParams::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::CallDialParams::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::CallDialParams::ConversationRelayConfig::Interruptible] Controls when caller input can interrupt assistant speech. `any` allows speech o
+        #
+        #   @param interruptible_greeting [Symbol, Telnyx::Models::CallDialParams::ConversationRelayConfig::InterruptibleGreeting] Controls when caller input can interrupt assistant speech. `any` allows speech o
+        #
+        #   @param interruption_settings [Telnyx::Models::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::ConversationRelayConfig::InterruptionSettings::Interruptible, nil]
+          optional :interruptible,
+                   enum: -> { Telnyx::CallDialParams::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::CallDialParams::ConversationRelayConfig::InterruptionSettings::InterruptibleGreeting, nil]
+          optional :interruptible_greeting,
+                   enum: -> { Telnyx::CallDialParams::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::CallDialParams::ConversationRelayConfig::InterruptionSettings::WelcomeGreetingInterruptible, nil]
+          optional :welcome_greeting_interruptible,
+                   enum: -> { Telnyx::CallDialParams::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::CallDialParams::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::CallDialParams::ConversationRelayConfig::InterruptionSettings::Interruptible] Controls when caller input can interrupt assistant speech. `any` allows speech o
+          #
+          #   @param interruptible_greeting [Symbol, Telnyx::Models::CallDialParams::ConversationRelayConfig::InterruptionSettings::InterruptibleGreeting] Controls when caller input can interrupt assistant speech. `any` allows speech o
+          #
+          #   @param welcome_greeting_interruptible [Symbol, Telnyx::Models::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::ConversationRelayConfig::Language::TranscriptionEngine, nil]
+          optional :transcription_engine,
+                   enum: -> { Telnyx::CallDialParams::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::CallDialParams::ConversationRelayConfig::Language::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings, nil]
+          optional :voice_settings,
+                   union: -> { Telnyx::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::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::CallDialParams::ConversationRelayConfig::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings)]
+        end
+      end
+
       class DeepfakeDetection < Telnyx::Internal::Type::BaseModel
         # @!attribute enabled
         #   Whether deepfake detection is enabled.