telnyx 5.170.0 → 5.171.0

data/lib/telnyx/models/call_dial_params.rb

@@ -54,7 +54,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::CallDialParams::AnsweringMachineDetection, nil]
       optional :answering_machine_detection, enum: -> { Telnyx::CallDialParams::AnsweringMachineDetection }
@@ -63,16 +72,19 @@ 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::CallDialParams::AnsweringMachineDetectionConfig, nil]
       optional :answering_machine_detection_config,
                -> { Telnyx::CallDialParams::AnsweringMachineDetectionConfig }
 
       # @!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 }
@@ -532,7 +544,7 @@ module Telnyx
       #
       #   @param answering_machine_detection_config [Telnyx::Models::CallDialParams::AnsweringMachineDetectionConfig] Optional configuration parameters to modify 'answering_machine_detection' perfor
       #
-      #   @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 audio_url [String] The URL of a file to be played back to the callee when the call is answered. The
       #
@@ -696,11 +708,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
@@ -826,6 +848,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.
         #
@@ -838,7 +869,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::CallDialParams::AnsweringMachineDetectionConfig} for more
         #   details.
@@ -846,7 +877,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
         #
@@ -880,6 +912,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/call_machine_premium_call_screening_detected_webhook_event.rb

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class CallMachinePremiumCallScreeningDetectedWebhookEvent < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data, nil]
+      optional :data, -> { Telnyx::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data }
+
+      # @!method initialize(data: nil)
+      #   @param data [Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data]
+
+      # @see Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent#data
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Identifies the type of resource.
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute event_type
+        #   The type of event being delivered.
+        #
+        #   @return [Symbol, Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::EventType, nil]
+        optional :event_type,
+                 enum: -> { Telnyx::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::EventType }
+
+        # @!attribute occurred_at
+        #   ISO 8601 datetime of when the event occurred.
+        #
+        #   @return [Time, nil]
+        optional :occurred_at, Time
+
+        # @!attribute payload
+        #
+        #   @return [Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::Payload, nil]
+        optional :payload, -> { Telnyx::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::Payload }
+
+        # @!attribute record_type
+        #   Identifies the type of the resource.
+        #
+        #   @return [Symbol, Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::RecordType, nil]
+        optional :record_type,
+                 enum: -> { Telnyx::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::RecordType }
+
+        # @!method initialize(id: nil, event_type: nil, occurred_at: nil, payload: nil, record_type: nil)
+        #   @param id [String] Identifies the type of resource.
+        #
+        #   @param event_type [Symbol, Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::EventType] The type of event being delivered.
+        #
+        #   @param occurred_at [Time] ISO 8601 datetime of when the event occurred.
+        #
+        #   @param payload [Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::Payload]
+        #
+        #   @param record_type [Symbol, Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::RecordType] Identifies the type of the resource.
+
+        # The type of event being delivered.
+        #
+        # @see Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data#event_type
+        module EventType
+          extend Telnyx::Internal::Type::Enum
+
+          CALL_MACHINE_PREMIUM_CALL_SCREENING_DETECTED = :"call.machine.premium.call_screening.detected"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data#payload
+        class Payload < Telnyx::Internal::Type::BaseModel
+          # @!attribute call_control_id
+          #   Call ID used to issue commands via Call Control API.
+          #
+          #   @return [String, nil]
+          optional :call_control_id, String
+
+          # @!attribute call_leg_id
+          #   ID that is unique to the call and can be used to correlate webhook events.
+          #
+          #   @return [String, nil]
+          optional :call_leg_id, String
+
+          # @!attribute call_session_id
+          #   ID that is unique to the call session and can be used to correlate webhook
+          #   events. Call session is a group of related call legs that logically belong to
+          #   the same phone call, e.g. an inbound and outbound leg of a transferred call.
+          #
+          #   @return [String, nil]
+          optional :call_session_id, String
+
+          # @!attribute client_state
+          #   State received from a command.
+          #
+          #   @return [String, nil]
+          optional :client_state, String
+
+          # @!attribute connection_id
+          #   Call Control App ID (formerly Telnyx connection ID) used in the call.
+          #
+          #   @return [String, nil]
+          optional :connection_id, String
+
+          # @!attribute from
+          #   Number or SIP URI placing the call.
+          #
+          #   @return [String, nil]
+          optional :from, String
+
+          # @!attribute result
+          #   Apple Call Screening detection result. Sent when an Apple Call Screening tone is
+          #   detected; Premium Answering Machine Detection is restarted on the screened call
+          #   afterwards.
+          #
+          #   @return [Symbol, Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::Payload::Result, nil]
+          optional :result,
+                   enum: -> { Telnyx::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::Payload::Result }
+
+          # @!attribute to
+          #   Destination number or SIP URI of the call.
+          #
+          #   @return [String, nil]
+          optional :to, String
+
+          # @!method initialize(call_control_id: nil, call_leg_id: nil, call_session_id: nil, client_state: nil, connection_id: nil, from: nil, result: nil, to: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::Payload}
+          #   for more details.
+          #
+          #   @param call_control_id [String] Call ID used to issue commands via Call Control API.
+          #
+          #   @param call_leg_id [String] ID that is unique to the call and can be used to correlate webhook events.
+          #
+          #   @param call_session_id [String] ID that is unique to the call session and can be used to correlate webhook event
+          #
+          #   @param client_state [String] State received from a command.
+          #
+          #   @param connection_id [String] Call Control App ID (formerly Telnyx connection ID) used in the call.
+          #
+          #   @param from [String] Number or SIP URI placing the call.
+          #
+          #   @param result [Symbol, Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::Payload::Result] Apple Call Screening detection result. Sent when an Apple Call Screening tone is
+          #
+          #   @param to [String] Destination number or SIP URI of the call.
+
+          # Apple Call Screening detection result. Sent when an Apple Call Screening tone is
+          # detected; Premium Answering Machine Detection is restarted on the screened call
+          # afterwards.
+          #
+          # @see Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data::Payload#result
+          module Result
+            extend Telnyx::Internal::Type::Enum
+
+            SCREENING = :screening
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # Identifies the type of the resource.
+        #
+        # @see Telnyx::Models::CallMachinePremiumCallScreeningDetectedWebhookEvent::Data#record_type
+        module RecordType
+          extend Telnyx::Internal::Type::Enum
+
+          EVENT = :event
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/call_machine_premium_detection_started_webhook_event.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class CallMachinePremiumDetectionStartedWebhookEvent < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data, nil]
+      optional :data, -> { Telnyx::CallMachinePremiumDetectionStartedWebhookEvent::Data }
+
+      # @!method initialize(data: nil)
+      #   @param data [Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data]
+
+      # @see Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent#data
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Identifies the type of resource.
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute event_type
+        #   The type of event being delivered.
+        #
+        #   @return [Symbol, Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data::EventType, nil]
+        optional :event_type, enum: -> { Telnyx::CallMachinePremiumDetectionStartedWebhookEvent::Data::EventType }
+
+        # @!attribute occurred_at
+        #   ISO 8601 datetime of when the event occurred.
+        #
+        #   @return [Time, nil]
+        optional :occurred_at, Time
+
+        # @!attribute payload
+        #
+        #   @return [Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data::Payload, nil]
+        optional :payload, -> { Telnyx::CallMachinePremiumDetectionStartedWebhookEvent::Data::Payload }
+
+        # @!attribute record_type
+        #   Identifies the type of the resource.
+        #
+        #   @return [Symbol, Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data::RecordType, nil]
+        optional :record_type,
+                 enum: -> { Telnyx::CallMachinePremiumDetectionStartedWebhookEvent::Data::RecordType }
+
+        # @!method initialize(id: nil, event_type: nil, occurred_at: nil, payload: nil, record_type: nil)
+        #   @param id [String] Identifies the type of resource.
+        #
+        #   @param event_type [Symbol, Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data::EventType] The type of event being delivered.
+        #
+        #   @param occurred_at [Time] ISO 8601 datetime of when the event occurred.
+        #
+        #   @param payload [Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data::Payload]
+        #
+        #   @param record_type [Symbol, Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data::RecordType] Identifies the type of the resource.
+
+        # The type of event being delivered.
+        #
+        # @see Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data#event_type
+        module EventType
+          extend Telnyx::Internal::Type::Enum
+
+          CALL_MACHINE_PREMIUM_DETECTION_STARTED = :"call.machine.premium.detection.started"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data#payload
+        class Payload < Telnyx::Internal::Type::BaseModel
+          # @!attribute call_control_id
+          #   Call ID used to issue commands via Call Control API.
+          #
+          #   @return [String, nil]
+          optional :call_control_id, String
+
+          # @!attribute call_leg_id
+          #   ID that is unique to the call and can be used to correlate webhook events.
+          #
+          #   @return [String, nil]
+          optional :call_leg_id, String
+
+          # @!attribute call_session_id
+          #   ID that is unique to the call session and can be used to correlate webhook
+          #   events. Call session is a group of related call legs that logically belong to
+          #   the same phone call, e.g. an inbound and outbound leg of a transferred call.
+          #
+          #   @return [String, nil]
+          optional :call_session_id, String
+
+          # @!attribute client_state
+          #   State received from a command.
+          #
+          #   @return [String, nil]
+          optional :client_state, String
+
+          # @!attribute connection_id
+          #   Call Control App ID (formerly Telnyx connection ID) used in the call.
+          #
+          #   @return [String, nil]
+          optional :connection_id, String
+
+          # @!attribute from
+          #   Number or SIP URI placing the call.
+          #
+          #   @return [String, nil]
+          optional :from, String
+
+          # @!attribute to
+          #   Destination number or SIP URI of the call.
+          #
+          #   @return [String, nil]
+          optional :to, String
+
+          # @!method initialize(call_control_id: nil, call_leg_id: nil, call_session_id: nil, client_state: nil, connection_id: nil, from: nil, to: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data::Payload}
+          #   for more details.
+          #
+          #   @param call_control_id [String] Call ID used to issue commands via Call Control API.
+          #
+          #   @param call_leg_id [String] ID that is unique to the call and can be used to correlate webhook events.
+          #
+          #   @param call_session_id [String] ID that is unique to the call session and can be used to correlate webhook event
+          #
+          #   @param client_state [String] State received from a command.
+          #
+          #   @param connection_id [String] Call Control App ID (formerly Telnyx connection ID) used in the call.
+          #
+          #   @param from [String] Number or SIP URI placing the call.
+          #
+          #   @param to [String] Destination number or SIP URI of the call.
+        end
+
+        # Identifies the type of the resource.
+        #
+        # @see Telnyx::Models::CallMachinePremiumDetectionStartedWebhookEvent::Data#record_type
+        module RecordType
+          extend Telnyx::Internal::Type::Enum
+
+          EVENT = :event
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/call_machine_premium_greeting_ended.rb

@@ -96,7 +96,9 @@ module Telnyx
         optional :from, String
 
         # @!attribute result
-        #   Premium Answering Machine Greeting Ended result.
+        #   Premium Answering Machine Greeting Ended result. `prompt_ended` is only sent
+        #   when `answering_machine_detection` is `premium_ios_call_screening_detection` and
+        #   the iOS call-screening prompt ends without a beep.
         #
         #   @return [Symbol, Telnyx::Models::CallMachinePremiumGreetingEnded::Payload::Result, nil]
         optional :result, enum: -> { Telnyx::CallMachinePremiumGreetingEnded::Payload::Result }
@@ -123,11 +125,13 @@ module Telnyx
         #
         #   @param from [String] Number or SIP URI placing the call.
         #
-        #   @param result [Symbol, Telnyx::Models::CallMachinePremiumGreetingEnded::Payload::Result] Premium Answering Machine Greeting Ended result.
+        #   @param result [Symbol, Telnyx::Models::CallMachinePremiumGreetingEnded::Payload::Result] Premium Answering Machine Greeting Ended result. `prompt_ended` is only sent whe
         #
         #   @param to [String] Destination number or SIP URI of the call.
 
-        # Premium Answering Machine Greeting Ended result.
+        # Premium Answering Machine Greeting Ended result. `prompt_ended` is only sent
+        # when `answering_machine_detection` is `premium_ios_call_screening_detection` and
+        # the iOS call-screening prompt ends without a beep.
         #
         # @see Telnyx::Models::CallMachinePremiumGreetingEnded::Payload#result
         module Result
@@ -135,6 +139,7 @@ module Telnyx
 
           BEEP_DETECTED = :beep_detected
           NO_BEEP_DETECTED = :no_beep_detected
+          PROMPT_ENDED = :prompt_ended
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/telnyx/models/calls/action_answer_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 }
@@ -192,7 +194,9 @@ module Telnyx
         optional :stream_url, String
 
         # @!attribute transcription
-        #   Enable transcription upon call answer. The default value is false.
+        #   Enable standalone call transcription upon call answer. The default value is
+        #   false. Configure this feature with `transcription_config`. To configure speech
+        #   recognition for an AI assistant, use `assistant.transcription` instead.
         #
         #   @return [Boolean, nil]
         optional :transcription, Telnyx::Internal::Type::Boolean
@@ -245,7 +249,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 billing_group_id [String] Use this field to set the Billing Group ID for the call. Must be a valid and exi
         #
@@ -296,7 +300,7 @@ module Telnyx
         #
         #   @param stream_url [String] The destination WebSocket address where the stream is going to be delivered.
         #
-        #   @param transcription [Boolean] Enable transcription upon call answer. The default value is false.
+        #   @param transcription [Boolean] Enable standalone call transcription upon call answer. The default value is fals
         #
         #   @param transcription_config [Telnyx::Models::Calls::TranscriptionStartRequest]
         #

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

@@ -121,10 +121,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

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