telnyx 5.169.0 → 5.171.0

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

@@ -74,6 +74,16 @@ module Telnyx
         #   @return [Hash{Symbol=>Object}, nil]
         optional :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
 
+        # @!attribute min_postal_code_length
+        #   Minimum number of digits the caller must enter when collecting a credit-card
+        #   billing postal code. Applies only when `postal_code` is `true` or `"true"` and
+        #   no `payment_token` is supplied. The default is 1. The maximum number of digits
+        #   collected is the greater of 10 and this value. This does not validate the length
+        #   of a postal code supplied directly in `postal_code`.
+        #
+        #   @return [Integer, nil]
+        optional :min_postal_code_length, Integer
+
         # @!attribute parameters
         #   Additional parameters forwarded to the Pay connector.
         #
@@ -92,6 +102,19 @@ module Telnyx
         #   @return [String, nil]
         optional :payment_token, String
 
+        # @!attribute postal_code
+        #   Controls billing postal code collection for credit-card payments when no
+        #   `payment_token` is supplied. Set to `true` or the string `"true"` (the default)
+        #   to prompt the caller for a postal code. Set to `false` or the string `"false"`
+        #   to skip the postal code prompt without supplying a postal code to the payment
+        #   connector. Supply any other non-empty string, such as `"90210"`, to use that
+        #   postal code without prompting. Empty or whitespace-only strings are rejected.
+        #   This option does not affect ACH debit payments or payments using an existing
+        #   token.
+        #
+        #   @return [String, Boolean, nil]
+        optional :postal_code, union: -> { Telnyx::Calls::ActionPayParams::PostalCode }
+
         # @!attribute prompts
         #   Custom text-to-speech prompts keyed by payment collection step.
         #
@@ -136,7 +159,7 @@ module Telnyx
         #   @return [String, nil]
         optional :voice, String
 
-        # @!method initialize(call_control_id:, amount: nil, client_state: nil, command_id: nil, connector_name: nil, currency: nil, description: nil, inter_digit_timeout_millis: nil, language: nil, max_attempts: nil, metadata: nil, parameters: nil, payment_method: nil, payment_token: nil, prompts: nil, service_level: nil, timeout_millis: nil, transaction_type: nil, valid_card_types: nil, voice: nil, request_options: {})
+        # @!method initialize(call_control_id:, amount: nil, client_state: nil, command_id: nil, connector_name: nil, currency: nil, description: nil, inter_digit_timeout_millis: nil, language: nil, max_attempts: nil, metadata: nil, min_postal_code_length: nil, parameters: nil, payment_method: nil, payment_token: nil, postal_code: nil, prompts: nil, service_level: nil, timeout_millis: nil, transaction_type: nil, valid_card_types: nil, voice: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::Calls::ActionPayParams} for more details.
         #
@@ -162,12 +185,16 @@ module Telnyx
         #
         #   @param metadata [Hash{Symbol=>Object}] Metadata forwarded to the Pay connector.
         #
+        #   @param min_postal_code_length [Integer] Minimum number of digits the caller must enter when collecting a credit-card bil
+        #
         #   @param parameters [Hash{Symbol=>Object}] Additional parameters forwarded to the Pay connector.
         #
         #   @param payment_method [Symbol, Telnyx::Models::Calls::ActionPayParams::PaymentMethod] Payment method to collect.
         #
         #   @param payment_token [String] Existing payment token. When supplied, payment-detail collection is skipped.
         #
+        #   @param postal_code [String, Boolean] Controls billing postal code collection for credit-card payments when no `paymen
+        #
         #   @param prompts [Telnyx::Models::Calls::ActionPayParams::Prompts] Custom text-to-speech prompts keyed by payment collection step.
         #
         #   @param service_level [String] Speech synthesis service level used for payment prompts. Pay defaults to `premiu
@@ -204,6 +231,25 @@ module Telnyx
           #   @return [Array<Symbol>]
         end
 
+        # Controls billing postal code collection for credit-card payments when no
+        # `payment_token` is supplied. Set to `true` or the string `"true"` (the default)
+        # to prompt the caller for a postal code. Set to `false` or the string `"false"`
+        # to skip the postal code prompt without supplying a postal code to the payment
+        # connector. Supply any other non-empty string, such as `"90210"`, to use that
+        # postal code without prompting. Empty or whitespace-only strings are rejected.
+        # This option does not affect ACH debit payments or payments using an existing
+        # token.
+        module PostalCode
+          extend Telnyx::Internal::Type::Union
+
+          variant String
+
+          variant Telnyx::Internal::Type::Boolean
+
+          # @!method self.variants
+          #   @return [Array(String, Boolean)]
+        end
+
         class Prompts < Telnyx::Internal::Type::BaseModel
           # @!attribute bank_account_number
           #   A default prompt string or an ordered list of qualified prompts.

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

@@ -14,7 +14,10 @@ module Telnyx
         required :call_control_id, String
 
         # @!attribute cause
-        #   Cause for call rejection.
+        #   Cause for call rejection. The cause sets the SIP response the caller receives:
+        #   `USER_BUSY` sends 486 User Busy, `CALL_REJECTED` sends 603 Decline, `NOT_FOUND`
+        #   sends 404 Not Found, and `TEMPORARILY_UNAVAILABLE` sends 480 Temporarily
+        #   Unavailable.
         #
         #   @return [Symbol, Telnyx::Models::Calls::ActionRejectParams::Cause]
         required :cause, enum: -> { Telnyx::Calls::ActionRejectParams::Cause }
@@ -39,7 +42,7 @@ module Telnyx
         #
         #   @param call_control_id [String]
         #
-        #   @param cause [Symbol, Telnyx::Models::Calls::ActionRejectParams::Cause] Cause for call rejection.
+        #   @param cause [Symbol, Telnyx::Models::Calls::ActionRejectParams::Cause] Cause for call rejection. The cause sets the SIP response the caller receives: `
         #
         #   @param client_state [String] Use this field to add state to every subsequent webhook. It must be a valid Base
         #
@@ -47,11 +50,16 @@ module Telnyx
         #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
-        # Cause for call rejection.
+        # Cause for call rejection. The cause sets the SIP response the caller receives:
+        # `USER_BUSY` sends 486 User Busy, `CALL_REJECTED` sends 603 Decline, `NOT_FOUND`
+        # sends 404 Not Found, and `TEMPORARILY_UNAVAILABLE` sends 480 Temporarily
+        # Unavailable.
         module Cause
           extend Telnyx::Internal::Type::Enum
 
           CALL_REJECTED = :CALL_REJECTED
+          NOT_FOUND = :NOT_FOUND
+          TEMPORARILY_UNAVAILABLE = :TEMPORARILY_UNAVAILABLE
           USER_BUSY = :USER_BUSY
 
           # @!method self.values

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

@@ -64,6 +64,12 @@ module Telnyx
         #   - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
         #     `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
         #     `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+        #   - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+        #     Supported model: `tts-rt-v2`. Browse the catalog via the
+        #     [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+        #     Every voice speaks all supported languages; set `language` to the two-letter
+        #     ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+        #     `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
         #   - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
         #     `ara`, `rex`, `sal`, `leo`.
         #   - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -137,7 +143,7 @@ module Telnyx
         # @!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::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, nil]
+        #   @return [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings, nil]
         optional :voice_settings, union: -> { Telnyx::Calls::ActionSpeakParams::VoiceSettings }
 
         # @!method initialize(call_control_id:, payload:, voice:, client_state: nil, command_id: nil, language: nil, loop_: nil, payload_type: nil, service_level: nil, stop: nil, target_legs: nil, voice_settings: nil, request_options: {})
@@ -166,7 +172,7 @@ module Telnyx
         #
         #   @param target_legs [Symbol, Telnyx::Models::Calls::ActionSpeakParams::TargetLegs] Specifies which legs of the call should receive the spoken audio.
         #
-        #   @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        #   @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
@@ -267,8 +273,10 @@ module Telnyx
 
           variant :xai, -> { Telnyx::XaiVoiceSettings }
 
+          variant :soniox, -> { Telnyx::Calls::SonioxVoiceSettings }
+
           # @!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::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings)]
+          #   @return [Array(Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings)]
         end
       end
     end

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

@@ -14,9 +14,11 @@ module Telnyx
         required :call_control_id, String
 
         # @!attribute assistant
-        #   AI Assistant configuration. All fields except `id` are optional — the
-        #   assistant's stored configuration will be used as fallback for any omitted
-        #   fields.
+        #   AI Assistant configuration and per-call overrides. All fields except `id` are
+        #   optional. Omitted assistant fields use the stored configuration. Supplied
+        #   `voice_settings` and `transcription` objects replace their stored objects rather
+        #   than merging individual settings; include every setting you want to retain.
+        #   `dynamic_variables` are merged, with request values taking precedence.
         #
         #   @return [Telnyx::Models::CallAssistantRequest, nil]
         optional :assistant, -> { Telnyx::CallAssistantRequest }
@@ -87,7 +89,7 @@ module Telnyx
         #
         #   @param call_control_id [String]
         #
-        #   @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration. All fields except `id` are optional — the assistant'
+        #   @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration and per-call overrides. All fields except `id` are op
         #
         #   @param client_state [String] Use this field to add state to every subsequent webhook. It must be a valid Base
         #

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

@@ -149,10 +149,13 @@ module Telnyx
         #   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.
+        #   repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+        #   `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+        #   prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+        #   server.
         #
-        #   @return [Hash{Symbol=>Object}, nil]
-        optional :transcription_engine_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+        #   @return [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig, nil]
+        optional :transcription_engine_config, -> { Telnyx::Calls::ConversationRelayTranscriptionEngineConfig }
 
         # @!attribute tts_provider
         #   Text-to-speech provider. If omitted, Telnyx derives it from `voice` or
@@ -179,10 +182,10 @@ module Telnyx
         #     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).)
+        #   - **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
@@ -197,6 +200,12 @@ module Telnyx
         #   - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
         #     `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
         #     `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+        #   - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+        #     Supported model: `tts-rt-v2`. Browse the catalog via the
+        #     [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+        #     Every voice speaks all supported languages; set `language` to the two-letter
+        #     ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+        #     `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
         #   - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
         #     `ara`, `rex`, `sal`, `leo`.
         #   - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -210,7 +219,7 @@ module Telnyx
         # @!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::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, nil]
+        #   @return [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings, nil]
         optional :voice_settings, union: -> { Telnyx::Calls::ActionStartConversationRelayParams::VoiceSettings }
 
         # @!method initialize(call_control_id:, assistant: nil, client_state: nil, command_id: nil, conversation_relay_dtmf_detection: nil, conversation_relay_settings: nil, conversation_relay_url: nil, 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: nil, transcription_engine: nil, transcription_engine_config: nil, tts_provider: nil, url: nil, voice: nil, voice_settings: nil, request_options: {})
@@ -255,7 +264,7 @@ module Telnyx
         #
         #   @param transcription_engine [Symbol, Telnyx::Models::Calls::ActionStartConversationRelayParams::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_engine_config [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig] 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
         #
@@ -263,7 +272,7 @@ module Telnyx
         #
         #   @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::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        #   @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
@@ -381,8 +390,10 @@ module Telnyx
 
           variant :xai, -> { Telnyx::XaiVoiceSettings }
 
+          variant :soniox, -> { Telnyx::Calls::SonioxVoiceSettings }
+
           # @!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::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings)]
+          #   @return [Array(Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings)]
         end
       end
     end

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

@@ -34,7 +34,16 @@ module Telnyx
         #   'greeting_end' or 'detect_words' is used and a 'machine' is detected, you will
         #   receive another 'call.machine.greeting.ended' webhook when the answering machine
         #   greeting ends with a beep or silence. If `detect_beep` is used, you will only
-        #   receive 'call.machine.greeting.ended' if a beep is detected.
+        #   receive 'call.machine.greeting.ended' if a beep is detected. If
+        #   `answering_machine_detection` is set to `premium_ios_call_screening_detection`,
+        #   Premium AMD runs with iOS Call Screening support: after an initial `machine`
+        #   result, Telnyx listens for the iOS call-screening prompt to end or for an Apple
+        #   Call Screening tone, sends `call.machine.premium.greeting.ended` with
+        #   `result=prompt_ended` or `call.machine.premium.call_screening.detected` with
+        #   `result=screening` respectively. When the Apple Call Screening tone is detected,
+        #   Premium AMD is restarted on the screened call and a
+        #   `call.machine.premium.detection.ended` webhook with the post-screening
+        #   classification follows.
         #
         #   @return [Symbol, Telnyx::Models::Calls::ActionTransferParams::AnsweringMachineDetection, nil]
         optional :answering_machine_detection,
@@ -44,7 +53,8 @@ module Telnyx
         #   Optional configuration parameters to modify 'answering_machine_detection'
         #   performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
         #   parameters are applicable when `premium` is selected as
-        #   answering_machine_detection.
+        #   answering_machine_detection. `prompt_end_timeout_millis` is additionally
+        #   applicable when `premium_ios_call_screening_detection` is selected.
         #
         #   @return [Telnyx::Models::Calls::ActionTransferParams::AnsweringMachineDetectionConfig, nil]
         optional :answering_machine_detection_config,
@@ -443,11 +453,21 @@ module Telnyx
         # 'greeting_end' or 'detect_words' is used and a 'machine' is detected, you will
         # receive another 'call.machine.greeting.ended' webhook when the answering machine
         # greeting ends with a beep or silence. If `detect_beep` is used, you will only
-        # receive 'call.machine.greeting.ended' if a beep is detected.
+        # receive 'call.machine.greeting.ended' if a beep is detected. If
+        # `answering_machine_detection` is set to `premium_ios_call_screening_detection`,
+        # Premium AMD runs with iOS Call Screening support: after an initial `machine`
+        # result, Telnyx listens for the iOS call-screening prompt to end or for an Apple
+        # Call Screening tone, sends `call.machine.premium.greeting.ended` with
+        # `result=prompt_ended` or `call.machine.premium.call_screening.detected` with
+        # `result=screening` respectively. When the Apple Call Screening tone is detected,
+        # Premium AMD is restarted on the screened call and a
+        # `call.machine.premium.detection.ended` webhook with the post-screening
+        # classification follows.
         module AnsweringMachineDetection
           extend Telnyx::Internal::Type::Enum
 
           PREMIUM = :premium
+          PREMIUM_IOS_CALL_SCREENING_DETECTION = :premium_ios_call_screening_detection
           DETECT = :detect
           DETECT_BEEP = :detect_beep
           DETECT_WORDS = :detect_words
@@ -573,6 +593,15 @@ module Telnyx
           #   @return [Integer, nil]
           optional :maximum_word_length_millis, Integer
 
+          # @!attribute prompt_end_timeout_millis
+          #   Maximum time Telnyx waits, in milliseconds, for the iOS call-screening prompt to
+          #   end after Premium AMD initially detects a `machine`. Used when
+          #   `answering_machine_detection` is `premium_ios_call_screening_detection`.
+          #   Defaults to 5000 milliseconds.
+          #
+          #   @return [Integer, nil]
+          optional :prompt_end_timeout_millis, Integer
+
           # @!attribute silence_threshold
           #   Minimum noise threshold for any analysis.
           #
@@ -585,7 +614,7 @@ module Telnyx
           #   @return [Integer, nil]
           optional :total_analysis_time_millis, Integer
 
-          # @!method initialize(after_greeting_silence_millis: nil, beep_detection_profile: nil, beep_max_frequency_hz: nil, beep_min_frequency_hz: nil, beep_min_tone_duration_millis: nil, beep_spectral_confirmation: nil, beep_spectral_min_purity: nil, beep_spectral_reject_fax_cng: nil, beep_spectral_window_millis: nil, between_words_silence_millis: nil, greeting_duration_millis: nil, greeting_silence_duration_millis: nil, greeting_total_analysis_time_millis: nil, initial_silence_millis: nil, maximum_number_of_words: nil, maximum_word_length_millis: nil, silence_threshold: nil, total_analysis_time_millis: nil)
+          # @!method initialize(after_greeting_silence_millis: nil, beep_detection_profile: nil, beep_max_frequency_hz: nil, beep_min_frequency_hz: nil, beep_min_tone_duration_millis: nil, beep_spectral_confirmation: nil, beep_spectral_min_purity: nil, beep_spectral_reject_fax_cng: nil, beep_spectral_window_millis: nil, between_words_silence_millis: nil, greeting_duration_millis: nil, greeting_silence_duration_millis: nil, greeting_total_analysis_time_millis: nil, initial_silence_millis: nil, maximum_number_of_words: nil, maximum_word_length_millis: nil, prompt_end_timeout_millis: nil, silence_threshold: nil, total_analysis_time_millis: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::Calls::ActionTransferParams::AnsweringMachineDetectionConfig}
           #   for more details.
@@ -593,7 +622,8 @@ module Telnyx
           #   Optional configuration parameters to modify 'answering_machine_detection'
           #   performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
           #   parameters are applicable when `premium` is selected as
-          #   answering_machine_detection.
+          #   answering_machine_detection. `prompt_end_timeout_millis` is additionally
+          #   applicable when `premium_ios_call_screening_detection` is selected.
           #
           #   @param after_greeting_silence_millis [Integer] Silence duration threshold after a greeting message or voice for it be considere
           #
@@ -627,6 +657,8 @@ module Telnyx
           #
           #   @param maximum_word_length_millis [Integer] If a single word lasts longer than this threshold, consider it a machine.
           #
+          #   @param prompt_end_timeout_millis [Integer] Maximum time Telnyx waits, in milliseconds, for the iOS call-screening prompt to
+          #
           #   @param silence_threshold [Integer] Minimum noise threshold for any analysis.
           #
           #   @param total_analysis_time_millis [Integer] Maximum timeout threshold for overall detection.

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Calls
+      class ConversationRelayTranscriptionEngineConfig < Telnyx::Internal::Type::BaseModel
+        # @!attribute eager_eot_threshold
+        #   Deepgram Flux: confidence at which an `eagerEndOfTurn` frame is sent before the
+        #   final prompt, followed by `turnResumed` if the caller keeps talking. When
+        #   omitted, these frames are not sent.
+        #
+        #   @return [Float, nil]
+        optional :eager_eot_threshold, Float
+
+        # @!attribute eot_threshold
+        #   Deepgram Flux: confidence required to end the caller's turn.
+        #
+        #   @return [Float, nil]
+        optional :eot_threshold, Float
+
+        # @!attribute interim_results
+        #   Deepgram Flux: send interim transcripts as `prompt` frames with `last: false`.
+        #
+        #   @return [Boolean, nil]
+        optional :interim_results, Telnyx::Internal::Type::Boolean
+
+        # @!method initialize(eager_eot_threshold: nil, eot_threshold: nil, interim_results: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig} for more
+        #   details.
+        #
+        #   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. With Deepgram Flux (`deepgram/flux`),
+        #   `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+        #   prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+        #   server.
+        #
+        #   @param eager_eot_threshold [Float] Deepgram Flux: confidence at which an `eagerEndOfTurn` frame is sent before the
+        #
+        #   @param eot_threshold [Float] Deepgram Flux: confidence required to end the caller's turn.
+        #
+        #   @param interim_results [Boolean] Deepgram Flux: send interim transcripts as `prompt` frames with `last: false`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Calls
+      class SonioxVoiceSettings < Telnyx::Internal::Type::BaseModel
+        # @!attribute type
+        #   Voice settings provider type
+        #
+        #   @return [Symbol, Telnyx::Models::Calls::SonioxVoiceSettings::Type]
+        required :type, enum: -> { Telnyx::Calls::SonioxVoiceSettings::Type }
+
+        # @!attribute reduce_silence
+        #   Shortens the pauses between words.
+        #
+        #   @return [Boolean, nil]
+        optional :reduce_silence, Telnyx::Internal::Type::Boolean
+
+        # @!attribute speed
+        #   Speaking rate. 1.0 is normal speed.
+        #
+        #   @return [Float, nil]
+        optional :speed, Float
+
+        # @!method initialize(type:, reduce_silence: nil, speed: nil)
+        #   @param type [Symbol, Telnyx::Models::Calls::SonioxVoiceSettings::Type] Voice settings provider type
+        #
+        #   @param reduce_silence [Boolean] Shortens the pauses between words.
+        #
+        #   @param speed [Float] Speaking rate. 1.0 is normal speed.
+
+        # Voice settings provider type
+        #
+        # @see Telnyx::Models::Calls::SonioxVoiceSettings#type
+        module Type
+          extend Telnyx::Internal::Type::Enum
+
+          SONIOX = :soniox
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -11,9 +11,10 @@ module Telnyx
         required :type, enum: -> { Telnyx::Calls::TelnyxVoiceSettings::Type }
 
         # @!attribute voice_speed
-        #   The voice speed to be used for the voice. The voice speed must be between 0.1
-        #   and 2.0. Default value is 1.0. Not supported for `Telnyx.Bayan.*` or
-        #   `Telnyx.Sukhan.*` voices.
+        #   The voice speed to be used for the voice. Telnyx `Ultra` voices accept values
+        #   from 0.6 to 1.5; values outside that range are rejected by the synthesis engine.
+        #   `Qwen3TTS` and `KokoroTTS` accept the field but do not apply it. Default value
+        #   is 1.0. Not supported for `Telnyx.Bayan.*` or `Telnyx.Sukhan.*` voices.
         #
         #   @return [Float, nil]
         optional :voice_speed, Float
@@ -24,7 +25,7 @@ module Telnyx
         #
         #   @param type [Symbol, Telnyx::Models::Calls::TelnyxVoiceSettings::Type] Voice settings provider type
         #
-        #   @param voice_speed [Float] The voice speed to be used for the voice. The voice speed must be between 0.1 an
+        #   @param voice_speed [Float] The voice speed to be used for the voice. Telnyx `Ultra` voices accept values fr
 
         # Voice settings provider type
         #

data/lib/telnyx/models/conferences/action_speak_params.rb

@@ -64,6 +64,12 @@ module Telnyx
         #   - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
         #     `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
         #     `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+        #   - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+        #     Supported model: `tts-rt-v2`. Browse the catalog via the
+        #     [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+        #     Every voice speaks all supported languages; set `language` to the two-letter
+        #     ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+        #     `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
         #   - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
         #     `ara`, `rex`, `sal`, `leo`.
         #   - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -116,7 +122,7 @@ module Telnyx
         # @!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::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, nil]
+        #   @return [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings, nil]
         optional :voice_settings, union: -> { Telnyx::Conferences::ActionSpeakParams::VoiceSettings }
 
         # @!method initialize(id:, payload:, voice:, call_control_ids: nil, command_id: nil, language: nil, payload_type: nil, region: nil, voice_settings: nil, request_options: {})
@@ -139,7 +145,7 @@ module Telnyx
         #
         #   @param region [Symbol, Telnyx::Models::Conferences::ConferenceRegion] Region where the conference data is located. Defaults to the region defined in u
         #
-        #   @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        #   @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
@@ -216,8 +222,10 @@ module Telnyx
 
           variant :xai, -> { Telnyx::XaiVoiceSettings }
 
+          variant :soniox, -> { Telnyx::Calls::SonioxVoiceSettings }
+
           # @!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::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings)]
+          #   @return [Array(Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings)]
         end
       end
     end

data/lib/telnyx/models/conversation_relay_embedded_config.rb

@@ -90,10 +90,13 @@ module Telnyx
       #   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.
+      #   repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+      #   `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+      #   prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+      #   server.
       #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :transcription_engine_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+      #   @return [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig, nil]
+      optional :transcription_engine_config, -> { Telnyx::Calls::ConversationRelayTranscriptionEngineConfig }
 
       # @!attribute tts_provider
       #   Text-to-speech provider. If omitted, Telnyx derives it from `voice` or
@@ -113,10 +116,10 @@ module Telnyx
       #     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).)
+      #   - **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
@@ -131,6 +134,12 @@ module Telnyx
       #   - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
       #     `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
       #     `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+      #   - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+      #     Supported model: `tts-rt-v2`. Browse the catalog via the
+      #     [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+      #     Every voice speaks all supported languages; set `language` to the two-letter
+      #     ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+      #     `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
       #   - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
       #     `ara`, `rex`, `sal`, `leo`.
       #   - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -144,7 +153,7 @@ module Telnyx
       # @!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::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, nil]
+      #   @return [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings, nil]
       optional :voice_settings, union: -> { Telnyx::ConversationRelayEmbeddedConfig::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)
@@ -182,13 +191,13 @@ module Telnyx
       #
       #   @param transcription_engine [Symbol, Telnyx::Models::ConversationRelayEmbeddedConfig::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_engine_config [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig] 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::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+      #   @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
 
       # Engine to use for speech recognition. Legacy values `A` - `Google`, `B` -
       # `Telnyx` are supported for backward compatibility. For Conversation Relay, use
@@ -238,8 +247,10 @@ module Telnyx
 
         variant :xai, -> { Telnyx::XaiVoiceSettings }
 
+        variant :soniox, -> { Telnyx::Calls::SonioxVoiceSettings }
+
         # @!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::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings)]
+        #   @return [Array(Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings)]
       end
     end
   end