telnyx 5.170.0 → 5.171.0

data/lib/telnyx/models/ai/tool_node_req.rb

@@ -13,14 +13,26 @@ module Telnyx
         # @!attribute shared_tool_id
         #   ID of the single shared (org-level) tool this node executes. When the flow
         #   reaches this node the tool runs as a deliberate step (no LLM turn); its outgoing
-        #   `tool_result` edges then route on the outcome. Arguments are filled from the
-        #   conversation's dynamic variables by name — a dynamic variable whose name matches
-        #   one of the tool's parameters supplies that argument. Cross-validated against the
-        #   org's shared tools on write.
+        #   `llm` / `expression` edges route the flow on the tool's outcome. Arguments are
+        #   filled from the conversation's dynamic variables by name — a dynamic variable
+        #   whose name matches one of the tool's parameters supplies that argument.
+        #   Cross-validated against the org's shared tools on write.
         #
         #   @return [String]
         required :shared_tool_id, String
 
+        # @!attribute message
+        #   Optional message delivered to the user verbatim immediately before the tool
+        #   executes — an announcement such as 'One moment while I look that up.' No LLM
+        #   turn and no customer turn: the message is spoken/sent, then the tool runs, in
+        #   the same deterministic step. `{{variable}}` placeholders are interpolated from
+        #   the conversation's dynamic variables (unresolved → empty string); the tool's own
+        #   result is not yet available when the message is rendered. Omit for a silent tool
+        #   step.
+        #
+        #   @return [String, nil]
+        optional :message, String
+
         # @!attribute name
         #   Optional human-readable label, displayed in authoring UIs.
         #
@@ -41,7 +53,7 @@ module Telnyx
         #   @return [Symbol, Telnyx::Models::AI::ToolNodeReq::Type, nil]
         optional :type, enum: -> { Telnyx::AI::ToolNodeReq::Type }
 
-        # @!method initialize(id:, shared_tool_id:, name: nil, position: nil, type: nil)
+        # @!method initialize(id:, shared_tool_id:, message: nil, name: nil, position: nil, type: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ToolNodeReq} for more details.
         #
@@ -49,13 +61,17 @@ module Telnyx
         #
         #   Unlike a prompt node, a tool node has no instructions or model — it isn't an LLM
         #   turn. Reaching it deterministically runs one shared tool (arguments filled from
-        #   matching dynamic variables by name), then routes on the result via outgoing
-        #   `tool_result` edges.
+        #   matching dynamic variables by name), then routes via outgoing `llm` /
+        #   `expression` edges, with exactly one `default` fallback edge required when the
+        #   node has any outgoing edges (the tool's outcome is readable as
+        #   `telnyx_last_tool_status_code` in `expression` conditions).
         #
         #   @param id [String] Caller-supplied unique identifier for this node within the flow.
         #
         #   @param shared_tool_id [String] ID of the single shared (org-level) tool this node executes. When the flow reach
         #
+        #   @param message [String] Optional message delivered to the user verbatim immediately before the tool exec
+        #
         #   @param name [String] Optional human-readable label, displayed in authoring UIs.
         #
         #   @param position [Telnyx::Models::AI::NodePosition] Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored

data/lib/telnyx/models/ai/transcription_settings.rb

@@ -11,6 +11,28 @@ module Telnyx
         #   @return [String, nil]
         optional :api_key_ref, String
 
+        # @!attribute challenger
+        #   A second speech-to-text model that transcribes alongside `transcription.model`,
+        #   and the rule that decides which transcript the assistant uses.
+        #
+        #   @return [Telnyx::Models::AI::TranscriptionSettings::Challenger, nil]
+        optional :challenger, -> { Telnyx::AI::TranscriptionSettings::Challenger }, nil?: true
+
+        # @!attribute fallback_models
+        #   Up to 3 streaming models that take over transcription, in this order, when the
+        #   model in use fails, at the start of a call or mid-call. `model` must be a
+        #   streaming model too, and must support `language` alongside other models. On
+        #   update, a list replaces the stored one: omit the field to keep the stored list,
+        #   or send `null` or `[]` to remove it. When an update changes `model` or
+        #   `language`, stored fallbacks that no longer fit are removed without an error.
+        #   Can't be combined with `challenger`, the language booster; to replace a stored
+        #   language booster, send `challenger: null` in the same request.
+        #
+        #   @return [Array<Telnyx::Models::AI::TranscriptionSettings::FallbackModel>, nil]
+        optional :fallback_models,
+                 -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::TranscriptionSettings::FallbackModel] },
+                 nil?: true
+
         # @!attribute language
         #   The language of the audio to be transcribed. If not set, or if set to `auto`,
         #   supported models will automatically detect the language. For `deepgram/flux`,
@@ -57,6 +79,7 @@ module Telnyx
         #   - `reson8/turns` is a turn-based streaming model covering 10 European languages
         #     with automatic language detection.
         #   - `cohere/ar-stt` is a non-streaming Arabic and English transcription model.
+        #   - `telnyx/basira` is a non-streaming Arabic transcription model.
         #
         #   @return [Symbol, Telnyx::Models::AI::TranscriptionSettings::Model, nil]
         optional :model, enum: -> { Telnyx::AI::TranscriptionSettings::Model }
@@ -73,12 +96,16 @@ module Telnyx
         #   @return [Telnyx::Models::AI::TranscriptionSettingsConfig, nil]
         optional :settings, -> { Telnyx::AI::TranscriptionSettingsConfig }
 
-        # @!method initialize(api_key_ref: nil, language: nil, model: nil, region: nil, settings: nil)
+        # @!method initialize(api_key_ref: nil, challenger: nil, fallback_models: nil, language: nil, model: nil, region: nil, settings: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::TranscriptionSettings} for more details.
         #
         #   @param api_key_ref [String] Integration secret identifier for the transcription provider API key. Currently
         #
+        #   @param challenger [Telnyx::Models::AI::TranscriptionSettings::Challenger, nil] A second speech-to-text model that transcribes alongside `transcription.model`,
+        #
+        #   @param fallback_models [Array<Telnyx::Models::AI::TranscriptionSettings::FallbackModel>, nil] Up to 3 streaming models that take over transcription, in this order, when the m
+        #
         #   @param language [String] The language of the audio to be transcribed. If not set, or if set to `auto`, su
         #
         #   @param model [Symbol, Telnyx::Models::AI::TranscriptionSettings::Model] The speech to text model to be used by the voice assistant. All Deepgram models
@@ -87,6 +114,215 @@ module Telnyx
         #
         #   @param settings [Telnyx::Models::AI::TranscriptionSettingsConfig]
 
+        # @see Telnyx::Models::AI::TranscriptionSettings#challenger
+        class Challenger < Telnyx::Internal::Type::BaseModel
+          # @!attribute model
+          #   The language booster's model. It must be the same kind of model as
+          #   `transcription.model`: both streaming (`deepgram/flux`, `deepgram/nova-3`,
+          #   `deepgram/nova-2`, `assemblyai/universal-3-5-pro` or its legacy alias
+          #   `assemblyai/universal-streaming`, `xai/grok-stt`, `soniox/stt-rt-v4`,
+          #   `soniox/stt-rt-v5`, `humain/realtime`, `reson8/turns`) or both non-streaming
+          #   (`azure/fast`, `nvidia/parakeet-v3`, `omi-health/omi-med-stt-v1`,
+          #   `cohere/ar-stt`, `distil-whisper/distil-large-v2`,
+          #   `openai/whisper-large-v3-turbo`, `telnyx/basira`). It can be the same model as
+          #   `transcription.model` on a different `language`.
+          #
+          #   @return [Symbol, Telnyx::Models::AI::TranscriptionSettings::Challenger::Model]
+          required :model, enum: -> { Telnyx::AI::TranscriptionSettings::Challenger::Model }
+
+          # @!attribute language
+          #   The language this model transcribes. Omit it or set it to `null` to use the
+          #   language of `transcription.model`. The request is rejected when this model
+          #   doesn't support the language it would run. It is also rejected when it would run
+          #   the same model on the same language as `transcription.model`.
+          #
+          #   @return [String, nil]
+          optional :language, String, nil?: true
+
+          # @!attribute rule
+          #   How the assistant picks the transcript it uses. The models are compared on how
+          #   complete and confident their transcripts are, not on language, so the rules work
+          #   best when both models understand the callers' language.
+          #
+          #   - `best_turn` (default): both models transcribe the whole call. Each turn uses
+          #     the language booster's transcript only when it scores higher than the
+          #     transcript of `transcription.model` (clearly higher with non-streaming
+          #     models). With streaming models, `transcription.model` also decides when each
+          #     turn ends. Available for every pair.
+          #   - `best_engine`: both models transcribe the first turns, then the call continues
+          #     alone on the model whose transcripts scored higher. If neither clearly leads,
+          #     `transcription.model` continues. Streaming models only.
+          #   - `merge_words`: both models transcribe each utterance and their words are
+          #     merged, keeping Arabic and English spoken in the same sentence. Available only
+          #     for `telnyx/basira` with `cohere/ar-stt`, in either order. The pair runs on
+          #     the language that applies to `telnyx/basira` (its own, or that of
+          #     `transcription.model`), which must be Arabic (`ar` or an `ar-` locale),
+          #     `multi`, or `auto`.
+          #
+          #   @return [Symbol, Telnyx::Models::AI::TranscriptionSettings::Challenger::Rule, nil]
+          optional :rule, enum: -> { Telnyx::AI::TranscriptionSettings::Challenger::Rule }
+
+          # @!attribute settings
+          #   Settings for the language booster, with the same fields and limits as
+          #   `transcription.settings`. Fields that don't apply to this model's provider are
+          #   dropped, and the provider's defaults fill in the rest. Omit it or set it to
+          #   `null` to use the settings of `transcription.model` where they apply to this
+          #   model.
+          #
+          #   @return [Telnyx::Models::AI::TranscriptionSettingsConfig, nil]
+          optional :settings, -> { Telnyx::AI::TranscriptionSettingsConfig }, nil?: true
+
+          # @!method initialize(model:, language: nil, rule: nil, settings: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::TranscriptionSettings::Challenger} for more details.
+          #
+          #   A second speech-to-text model that transcribes alongside `transcription.model`,
+          #   and the rule that decides which transcript the assistant uses.
+          #
+          #   @param model [Symbol, Telnyx::Models::AI::TranscriptionSettings::Challenger::Model] The language booster's model. It must be the same kind of model as `transcriptio
+          #
+          #   @param language [String, nil] The language this model transcribes. Omit it or set it to `null` to use the lang
+          #
+          #   @param rule [Symbol, Telnyx::Models::AI::TranscriptionSettings::Challenger::Rule] How the assistant picks the transcript it uses. The models are compared on how c
+          #
+          #   @param settings [Telnyx::Models::AI::TranscriptionSettingsConfig, nil] Settings for the language booster, with the same fields and limits as `transcrip
+
+          # The language booster's model. It must be the same kind of model as
+          # `transcription.model`: both streaming (`deepgram/flux`, `deepgram/nova-3`,
+          # `deepgram/nova-2`, `assemblyai/universal-3-5-pro` or its legacy alias
+          # `assemblyai/universal-streaming`, `xai/grok-stt`, `soniox/stt-rt-v4`,
+          # `soniox/stt-rt-v5`, `humain/realtime`, `reson8/turns`) or both non-streaming
+          # (`azure/fast`, `nvidia/parakeet-v3`, `omi-health/omi-med-stt-v1`,
+          # `cohere/ar-stt`, `distil-whisper/distil-large-v2`,
+          # `openai/whisper-large-v3-turbo`, `telnyx/basira`). It can be the same model as
+          # `transcription.model` on a different `language`.
+          #
+          # @see Telnyx::Models::AI::TranscriptionSettings::Challenger#model
+          module Model
+            extend Telnyx::Internal::Type::Enum
+
+            DEEPGRAM_FLUX = :"deepgram/flux"
+            DEEPGRAM_NOVA_3 = :"deepgram/nova-3"
+            DEEPGRAM_NOVA_2 = :"deepgram/nova-2"
+            AZURE_FAST = :"azure/fast"
+            ASSEMBLYAI_UNIVERSAL_3_5_PRO = :"assemblyai/universal-3-5-pro"
+            ASSEMBLYAI_UNIVERSAL_STREAMING = :"assemblyai/universal-streaming"
+            XAI_GROK_STT = :"xai/grok-stt"
+            SONIOX_STT_RT_V4 = :"soniox/stt-rt-v4"
+            SONIOX_STT_RT_V5 = :"soniox/stt-rt-v5"
+            NVIDIA_PARAKEET_V3 = :"nvidia/parakeet-v3"
+            OMI_HEALTH_OMI_MED_STT_V1 = :"omi-health/omi-med-stt-v1"
+            HUMAIN_REALTIME = :"humain/realtime"
+            RESON8_TURNS = :"reson8/turns"
+            COHERE_AR_STT = :"cohere/ar-stt"
+            TELNYX_BASIRA = :"telnyx/basira"
+            DISTIL_WHISPER_DISTIL_LARGE_V2 = :"distil-whisper/distil-large-v2"
+            OPENAI_WHISPER_LARGE_V3_TURBO = :"openai/whisper-large-v3-turbo"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # How the assistant picks the transcript it uses. The models are compared on how
+          # complete and confident their transcripts are, not on language, so the rules work
+          # best when both models understand the callers' language.
+          #
+          # - `best_turn` (default): both models transcribe the whole call. Each turn uses
+          #   the language booster's transcript only when it scores higher than the
+          #   transcript of `transcription.model` (clearly higher with non-streaming
+          #   models). With streaming models, `transcription.model` also decides when each
+          #   turn ends. Available for every pair.
+          # - `best_engine`: both models transcribe the first turns, then the call continues
+          #   alone on the model whose transcripts scored higher. If neither clearly leads,
+          #   `transcription.model` continues. Streaming models only.
+          # - `merge_words`: both models transcribe each utterance and their words are
+          #   merged, keeping Arabic and English spoken in the same sentence. Available only
+          #   for `telnyx/basira` with `cohere/ar-stt`, in either order. The pair runs on
+          #   the language that applies to `telnyx/basira` (its own, or that of
+          #   `transcription.model`), which must be Arabic (`ar` or an `ar-` locale),
+          #   `multi`, or `auto`.
+          #
+          # @see Telnyx::Models::AI::TranscriptionSettings::Challenger#rule
+          module Rule
+            extend Telnyx::Internal::Type::Enum
+
+            BEST_TURN = :best_turn
+            BEST_ENGINE = :best_engine
+            MERGE_WORDS = :merge_words
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class FallbackModel < Telnyx::Internal::Type::BaseModel
+          # @!attribute model
+          #   The fallback model. It must be a streaming model other than
+          #   `transcription.model` and the other fallbacks: `deepgram/flux`,
+          #   `deepgram/nova-3`, `deepgram/nova-2`, `assemblyai/universal-3-5-pro` (or its
+          #   legacy alias `assemblyai/universal-streaming`), `xai/grok-stt`,
+          #   `soniox/stt-rt-v4`, `soniox/stt-rt-v5`, `humain/realtime`, or `reson8/turns`.
+          #
+          #   @return [Symbol, Telnyx::Models::AI::TranscriptionSettings::FallbackModel::Model]
+          required :model, enum: -> { Telnyx::AI::TranscriptionSettings::FallbackModel::Model }
+
+          # @!attribute language
+          #   The language the fallback transcribes. Omit it or set it to `null` to use the
+          #   language of `transcription.model`. The request is rejected when the fallback
+          #   model doesn't support the language it would run.
+          #
+          #   @return [String, nil]
+          optional :language, String, nil?: true
+
+          # @!attribute settings
+          #   Settings for the fallback, with the same fields and limits as
+          #   `transcription.settings`. Fields that don't apply to this model's provider are
+          #   dropped, and the provider's defaults fill in the rest. Omit it or set it to
+          #   `null` to use the settings of `transcription.model` where they apply to this
+          #   model.
+          #
+          #   @return [Telnyx::Models::AI::TranscriptionSettingsConfig, nil]
+          optional :settings, -> { Telnyx::AI::TranscriptionSettingsConfig }, nil?: true
+
+          # @!method initialize(model:, language: nil, settings: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::TranscriptionSettings::FallbackModel} for more details.
+          #
+          #   A streaming speech-to-text model that takes over transcription when the model in
+          #   use fails.
+          #
+          #   @param model [Symbol, Telnyx::Models::AI::TranscriptionSettings::FallbackModel::Model] The fallback model. It must be a streaming model other than `transcription.model
+          #
+          #   @param language [String, nil] The language the fallback transcribes. Omit it or set it to `null` to use the la
+          #
+          #   @param settings [Telnyx::Models::AI::TranscriptionSettingsConfig, nil] Settings for the fallback, with the same fields and limits as `transcription.set
+
+          # The fallback model. It must be a streaming model other than
+          # `transcription.model` and the other fallbacks: `deepgram/flux`,
+          # `deepgram/nova-3`, `deepgram/nova-2`, `assemblyai/universal-3-5-pro` (or its
+          # legacy alias `assemblyai/universal-streaming`), `xai/grok-stt`,
+          # `soniox/stt-rt-v4`, `soniox/stt-rt-v5`, `humain/realtime`, or `reson8/turns`.
+          #
+          # @see Telnyx::Models::AI::TranscriptionSettings::FallbackModel#model
+          module Model
+            extend Telnyx::Internal::Type::Enum
+
+            DEEPGRAM_FLUX = :"deepgram/flux"
+            DEEPGRAM_NOVA_3 = :"deepgram/nova-3"
+            DEEPGRAM_NOVA_2 = :"deepgram/nova-2"
+            ASSEMBLYAI_UNIVERSAL_3_5_PRO = :"assemblyai/universal-3-5-pro"
+            ASSEMBLYAI_UNIVERSAL_STREAMING = :"assemblyai/universal-streaming"
+            XAI_GROK_STT = :"xai/grok-stt"
+            SONIOX_STT_RT_V4 = :"soniox/stt-rt-v4"
+            SONIOX_STT_RT_V5 = :"soniox/stt-rt-v5"
+            HUMAIN_REALTIME = :"humain/realtime"
+            RESON8_TURNS = :"reson8/turns"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
         # The speech to text model to be used by the voice assistant. All Deepgram models
         # are run on-premise.
         #
@@ -110,6 +346,7 @@ module Telnyx
         # - `reson8/turns` is a turn-based streaming model covering 10 European languages
         #   with automatic language detection.
         # - `cohere/ar-stt` is a non-streaming Arabic and English transcription model.
+        # - `telnyx/basira` is a non-streaming Arabic transcription model.
         #
         # @see Telnyx::Models::AI::TranscriptionSettings#model
         module Model
@@ -129,6 +366,7 @@ module Telnyx
           HUMAIN_REALTIME = :"humain/realtime"
           RESON8_TURNS = :"reson8/turns"
           COHERE_AR_STT = :"cohere/ar-stt"
+          TELNYX_BASIRA = :"telnyx/basira"
           DISTIL_WHISPER_DISTIL_LARGE_V2 = :"distil-whisper/distil-large-v2"
           OPENAI_WHISPER_LARGE_V3_TURBO = :"openai/whisper-large-v3-turbo"
 

data/lib/telnyx/models/ai/voice_settings.rb

@@ -91,9 +91,9 @@ module Telnyx
         optional :use_speaker_boost, Telnyx::Internal::Type::Boolean
 
         # @!attribute voice_speed
-        #   The speed of the voice in the range [0.25, 2.0]. 1.0 is deafult speed. Larger
-        #   numbers make the voice faster, smaller numbers make it slower. This is only
-        #   applicable for Telnyx Natural voices.
+        #   The speed of the voice in the range [0.6, 1.5]. 1.0 is the default speed. Larger
+        #   numbers make the voice faster, smaller numbers make it slower. Applies to Telnyx
+        #   `Ultra` voices; values outside this range are rejected by the synthesis engine.
         #
         #   @return [Float, nil]
         optional :voice_speed, Float
@@ -122,7 +122,7 @@ module Telnyx
         #
         #   @param use_speaker_boost [Boolean] Amplifies similarity to the original speaker voice. Increases computational load
         #
-        #   @param voice_speed [Float] The speed of the voice in the range [0.25, 2.0]. 1.0 is deafult speed. Larger nu
+        #   @param voice_speed [Float] The speed of the voice in the range [0.6, 1.5]. 1.0 is the default speed. Larger
 
         # Optional background audio to play on the call. Use a predefined media bed, or
         # supply a looped MP3 URL. If a media URL is chosen in the portal, customers can

data/lib/telnyx/models/ai/websocket_settings.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      class WebsocketSettings < Telnyx::Internal::Type::BaseModel
+        # @!attribute auth_ref
+        #   Integration secret identifier whose value Telnyx sends as an
+        #   `Authorization: Bearer <value>` header on the upgrade request. Resolved on every
+        #   connection attempt, so a rotated secret is picked up by the next reconnect.
+        #
+        #   @return [String, nil]
+        optional :auth_ref, String
+
+        # @!attribute enabled
+        #   Whether Telnyx opens a WebSocket to `url` for each of this assistant's
+        #   conversations. Defaults to `false`.
+        #
+        #   @return [Boolean, nil]
+        optional :enabled, Telnyx::Internal::Type::Boolean
+
+        # @!attribute url
+        #   The `ws://` or `wss://` endpoint Telnyx connects to. Required when `enabled` is
+        #   `true`. Must be externally reachable — localhost, private IP ranges and `.local`
+        #   domains are rejected.
+        #
+        #   @return [String, nil]
+        optional :url, String
+
+        # @!method initialize(auth_ref: nil, enabled: nil, url: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::WebsocketSettings} for more details.
+        #
+        #   Streams conversation and telephony events to a WebSocket server you host, and
+        #   accepts messages injected back into the conversation. Telnyx opens the
+        #   connection as a client, once per conversation. Delivery is best effort
+        #   throughout: while the connection is down events are dropped rather than queued,
+        #   and no socket failure is ever allowed to affect the call. Beta feature.
+        #
+        #   @param auth_ref [String] Integration secret identifier whose value Telnyx sends as an `Authorization: Bea
+        #
+        #   @param enabled [Boolean] Whether Telnyx opens a WebSocket to `url` for each of this assistant's conversat
+        #
+        #   @param url [String] The `ws://` or `wss://` endpoint Telnyx connects to. Required when `enabled` is
+      end
+    end
+  end
+end

data/lib/telnyx/models/billing_contact.rb

@@ -4,34 +4,44 @@ module Telnyx
   module Models
     class BillingContact < Telnyx::Internal::Type::BaseModel
       # @!attribute email
+      #   The email address of the person Telnyx should contact about billing for this
+      #   account.
       #
       #   @return [String]
       required :email, String
 
       # @!attribute first_name
+      #   The first name of the person Telnyx should contact about billing for this
+      #   account.
       #
       #   @return [String]
       required :first_name, String
 
       # @!attribute last_name
+      #   The last name of the person Telnyx should contact about billing for this
+      #   account.
       #
       #   @return [String]
       required :last_name, String
 
       # @!attribute phone_number
-      #   E.164 format with leading `+`.
+      #   The phone number of the billing contact, in E.164 format, for example
+      #   +12125551234.
       #
       #   @return [String]
       required :phone_number, String
 
       # @!method initialize(email:, first_name:, last_name:, phone_number:)
-      #   @param email [String]
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::BillingContact} for more details.
       #
-      #   @param first_name [String]
+      #   @param email [String] The email address of the person Telnyx should contact about billing for this acc
       #
-      #   @param last_name [String]
+      #   @param first_name [String] The first name of the person Telnyx should contact about billing for this accoun
       #
-      #   @param phone_number [String] E.164 format with leading `+`.
+      #   @param last_name [String] The last name of the person Telnyx should contact about billing for this account
+      #
+      #   @param phone_number [String] The phone number of the billing contact, in E.164 format, for example +121255512
     end
   end
 end

data/lib/telnyx/models/bpo_authorization_input.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class BpoAuthorizationInput < Telnyx::Internal::Type::BaseModel
+      # @!attribute bpo_enterprise_id
+      #   Enterprise id of an approved BPO (Business Process Outsourcer) account on your
+      #   organization to authorize for this DIR.
+      #
+      #   @return [String]
+      required :bpo_enterprise_id, String
+
+      # @!attribute loa_document_id
+      #   Id of the signed Letter of Authorization document (uploaded via the Telnyx
+      #   Documents API) in which the Brand Owner authorizes this BPO.
+      #
+      #   @return [String]
+      required :loa_document_id, String
+
+      # @!method initialize(bpo_enterprise_id:, loa_document_id:)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::BpoAuthorizationInput} for more details.
+      #
+      #   One authorization to include when creating or updating a DIR: an approved BPO
+      #   (Business Process Outsourcer) account plus the signed Letter of Authorization
+      #   the Brand Owner granted it.
+      #
+      #   @param bpo_enterprise_id [String] Enterprise id of an approved BPO (Business Process Outsourcer) account on your o
+      #
+      #   @param loa_document_id [String] Id of the signed Letter of Authorization document (uploaded via the Telnyx Docum
+    end
+  end
+end

data/lib/telnyx/models/call_assistant_request.rb

@@ -104,18 +104,32 @@ module Telnyx
       #   @return [Array<Telnyx::Models::BookAppointmentTool, Telnyx::Models::CheckAvailabilityTool, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::CallControlRetrievalTool>, nil]
       optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::CallAssistantRequest::Tool] }
 
+      # @!attribute transcription
+      #   Per-call speech-to-text configuration for the assistant. If omitted, the stored
+      #   assistant transcription configuration is used. If supplied, this object replaces
+      #   the stored transcription settings. This is separate from the top-level
+      #   `transcription` boolean on answer and dial commands.
+      #
+      #   @return [Telnyx::Models::Calls::TranscriptionConfig, nil]
+      optional :transcription, -> { Telnyx::Calls::TranscriptionConfig }
+
       # @!attribute voice_settings
+      #   Per-call voice configuration. Set the voice identifier in
+      #   `voice_settings.voice`, not in `assistant.voice`. If supplied, this object
+      #   replaces the stored voice settings.
       #
       #   @return [Telnyx::Models::AI::VoiceSettings, nil]
       optional :voice_settings, -> { Telnyx::AI::VoiceSettings }
 
-      # @!method initialize(id:, dynamic_variables: nil, external_llm: nil, fallback_config: nil, greeting: nil, instructions: nil, llm_api_key_ref: nil, mcp_servers: nil, model: nil, name: nil, observability_settings: nil, openai_api_key_ref: nil, tools: nil, voice_settings: nil)
+      # @!method initialize(id:, dynamic_variables: nil, external_llm: nil, fallback_config: nil, greeting: nil, instructions: nil, llm_api_key_ref: nil, mcp_servers: nil, model: nil, name: nil, observability_settings: nil, openai_api_key_ref: nil, tools: nil, transcription: nil, voice_settings: nil)
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::CallAssistantRequest} for more details.
       #
-      #   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.
       #
       #   @param id [String] The identifier of the AI assistant to use.
       #
@@ -143,7 +157,9 @@ module Telnyx
       #
       #   @param tools [Array<Telnyx::Models::BookAppointmentTool, Telnyx::Models::CheckAvailabilityTool, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::CallControlRetrievalTool>] Inline tool definitions available to the assistant (webhook, retrieval, transfer
       #
-      #   @param voice_settings [Telnyx::Models::AI::VoiceSettings]
+      #   @param transcription [Telnyx::Models::Calls::TranscriptionConfig] Per-call speech-to-text configuration for the assistant. If omitted, the stored
+      #
+      #   @param voice_settings [Telnyx::Models::AI::VoiceSettings] Per-call voice configuration. Set the voice identifier in `voice_settings.voice`
 
       module DynamicVariable
         extend Telnyx::Internal::Type::Union