telnyx 5.167.0 → 5.169.0

data/rbi/telnyx/resources/messaging_profiles.rbi

@@ -21,6 +21,7 @@ module Telnyx
           daily_spend_limit: String,
           daily_spend_limit_enabled: T::Boolean,
           enabled: T::Boolean,
+          features: T.nilable(Telnyx::MessagingProfileFeatures::OrHash),
           health_webhook_url: T.nilable(String),
           mms_fall_back_to_sms: T::Boolean,
           mms_transcoding: T::Boolean,
@@ -56,6 +57,10 @@ module Telnyx
         daily_spend_limit_enabled: nil,
         # Specifies whether the messaging profile is enabled or not.
         enabled: nil,
+        # Telnyx product features the messaging customer can enable on the messaging
+        # profile. Keys map to individual feature flags; unknown keys are accepted and
+        # preserved for forward compatibility with rolling deployments.
+        features: nil,
         # A URL to receive health check webhooks for numbers in this profile.
         health_webhook_url: nil,
         # enables SMS fallback for MMS messages.
@@ -121,6 +126,7 @@ module Telnyx
           daily_spend_limit: String,
           daily_spend_limit_enabled: T::Boolean,
           enabled: T::Boolean,
+          features: T.nilable(Telnyx::MessagingProfileFeatures::OrHash),
           mms_fall_back_to_sms: T::Boolean,
           mms_transcoding: T::Boolean,
           mobile_only: T::Boolean,
@@ -155,6 +161,10 @@ module Telnyx
         daily_spend_limit_enabled: nil,
         # Specifies whether the messaging profile is enabled or not.
         enabled: nil,
+        # Telnyx product features the messaging customer can enable on the messaging
+        # profile. Keys map to individual feature flags; unknown keys are accepted and
+        # preserved for forward compatibility with rolling deployments.
+        features: nil,
         # enables SMS fallback for MMS messages.
         mms_fall_back_to_sms: nil,
         # enables automated resizing of MMS media.

data/rbi/telnyx/resources/noise_suppression_engines.rbi

@@ -0,0 +1,26 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    # Noise suppression engines that can be selected when configuring noise
+    # suppression on voice connections.
+    class NoiseSuppressionEngines
+      # Returns all noise suppression engines available to the authenticated user.
+      # Engines gated behind a feature flag are included only when the flag is enabled
+      # for the user's account. Results are not paginated; the number of engines is
+      # expected to remain small.
+      sig do
+        params(request_options: Telnyx::RequestOptions::OrHash).returns(
+          Telnyx::Models::NoiseSuppressionEngineListResponse
+        )
+      end
+      def list(request_options: {})
+      end
+
+      # @api private
+      sig { params(client: Telnyx::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/texml/accounts/conferences/participants.rbi

@@ -159,8 +159,15 @@ module Telnyx
                 label: String,
                 machine_detection:
                   Telnyx::Texml::Accounts::Conferences::ParticipantParticipantsParams::MachineDetection::OrSymbol,
+                machine_detection_beep_max_frequency: Integer,
+                machine_detection_beep_min_frequency: Integer,
+                machine_detection_beep_min_tone_duration: Integer,
                 machine_detection_beep_profile:
                   Telnyx::Texml::Accounts::Conferences::ParticipantParticipantsParams::MachineDetectionBeepProfile::OrSymbol,
+                machine_detection_beep_spectral_confirmation: T::Boolean,
+                machine_detection_beep_spectral_min_purity: Float,
+                machine_detection_beep_spectral_reject_fax_cng: T::Boolean,
+                machine_detection_beep_spectral_window: Integer,
                 machine_detection_silence_timeout: Integer,
                 machine_detection_speech_end_threshold: Integer,
                 machine_detection_speech_threshold: Integer,
@@ -283,11 +290,36 @@ module Telnyx
               # is identified. Use `DetectMessageEnd`, if you would like to leave a message on
               # an answering machine.
               machine_detection: nil,
+              # Body param: Highest frequency, in Hz, that a tone can reach and still be treated
+              # as a beep. Only used when MachineDetection is enabled.
+              machine_detection_beep_max_frequency: nil,
+              # Body param: Lowest frequency, in Hz, that a tone must reach to be treated as a
+              # beep. Raising it above 480 excludes North American ringback (440 + 480 Hz),
+              # which can otherwise be reported as a beep when the `freq_only` profile is in
+              # use. Only used when MachineDetection is enabled.
+              machine_detection_beep_min_frequency: nil,
+              # Body param: Shortest tone, in milliseconds, that can be treated as a beep.
+              # Raising it rejects brief tones such as call-progress blips. Only used when
+              # MachineDetection is enabled.
+              machine_detection_beep_min_tone_duration: nil,
               # Body param: Selects which detectors must validate a beep. `both` requires the
               # amplitude and frequency detectors to agree. `freq_only` uses the frequency
               # detector alone, for beeps whose volume is too unsteady for the default profile.
               # Only used when MachineDetection is enabled.
               machine_detection_beep_profile: nil,
+              # Body param: When enabled, a candidate beep must pass an additional spectral
+              # check before it is reported. Only used when MachineDetection is enabled.
+              machine_detection_beep_spectral_confirmation: nil,
+              # Body param: Minimum spectral purity, from 0 to 1, for a tone to be treated as a
+              # beep. Raising it rejects mixed tones such as ringback, which combines two
+              # frequencies. Only used when MachineDetection is enabled.
+              machine_detection_beep_spectral_min_purity: nil,
+              # Body param: When enabled, the fax CNG tone is rejected rather than reported as a
+              # beep. Only used when MachineDetection is enabled.
+              machine_detection_beep_spectral_reject_fax_cng: nil,
+              # Body param: Length of the spectral confirmation window, in milliseconds. Only
+              # used when MachineDetection is enabled.
+              machine_detection_beep_spectral_window: nil,
               # Body param: If initial silence duration is greater than this value, consider it
               # a machine. Ignored when `premium` detection is used.
               machine_detection_silence_timeout: nil,

data/rbi/telnyx/resources/texml/calls.rbi

@@ -0,0 +1,50 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class Texml
+      # TeXML REST Commands
+      class Calls
+        # Initiate an outbound TeXML call using a TeXML application connection ID, not an
+        # account SID. Request parameter names are case-sensitive. From and To are
+        # required; Texml supplies inline instructions and Url overrides the application
+        # XML request URL. When neither is supplied, the application configuration
+        # supplies the instructions. The response is a flat call object without a data
+        # wrapper.
+        sig do
+          params(
+            connection_id: String,
+            from: String,
+            to: String,
+            method_: Telnyx::Texml::CallCreateParams::Method::OrSymbol,
+            texml: String,
+            url: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Models::Texml::CallCreateResponse)
+        end
+        def create(
+          # The ID of the connection holding the TeXML application to call from.
+          connection_id,
+          # The E.164-formatted phone number or SIP URI to present as the caller.
+          from:,
+          # The E.164-formatted phone number or SIP URI to call.
+          to:,
+          # HTTP method used to retrieve TeXML instructions from Url.
+          method_: nil,
+          # Inline TeXML instructions to execute when the call is answered.
+          texml: nil,
+          # The URL from which to retrieve TeXML instructions. Overrides the TeXML
+          # application XML request URL.
+          url: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Telnyx::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/texml.rbi

@@ -4,6 +4,10 @@ module Telnyx
   module Resources
     # TeXML REST Commands
     class Texml
+      # TeXML REST Commands
+      sig { returns(Telnyx::Resources::Texml::Calls) }
+      attr_reader :calls
+
       # TeXML REST Commands
       sig { returns(Telnyx::Resources::Texml::Accounts) }
       attr_reader :accounts
@@ -46,8 +50,15 @@ module Telnyx
             Telnyx::TexmlInitiateAICallParams::DetectionMode::OrSymbol,
           machine_detection:
             Telnyx::TexmlInitiateAICallParams::MachineDetection::OrSymbol,
+          machine_detection_beep_max_frequency: Integer,
+          machine_detection_beep_min_frequency: Integer,
+          machine_detection_beep_min_tone_duration: Integer,
           machine_detection_beep_profile:
             Telnyx::TexmlInitiateAICallParams::MachineDetectionBeepProfile::OrSymbol,
+          machine_detection_beep_spectral_confirmation: T::Boolean,
+          machine_detection_beep_spectral_min_purity: Float,
+          machine_detection_beep_spectral_reject_fax_cng: T::Boolean,
+          machine_detection_beep_spectral_window: Integer,
           machine_detection_prompt_end_timeout: Integer,
           machine_detection_silence_timeout: Integer,
           machine_detection_speech_end_threshold: Integer,
@@ -124,11 +135,36 @@ module Telnyx
         detection_mode: nil,
         # Enables Answering Machine Detection.
         machine_detection: nil,
+        # Highest frequency, in Hz, that a tone can reach and still be treated as a beep.
+        # Only used when MachineDetection is enabled.
+        machine_detection_beep_max_frequency: nil,
+        # Lowest frequency, in Hz, that a tone must reach to be treated as a beep. Raising
+        # it above 480 excludes North American ringback (440 + 480 Hz), which can
+        # otherwise be reported as a beep when the `freq_only` profile is in use. Only
+        # used when MachineDetection is enabled.
+        machine_detection_beep_min_frequency: nil,
+        # Shortest tone, in milliseconds, that can be treated as a beep. Raising it
+        # rejects brief tones such as call-progress blips. Only used when MachineDetection
+        # is enabled.
+        machine_detection_beep_min_tone_duration: nil,
         # Selects which detectors must validate a beep. `both` requires the amplitude and
         # frequency detectors to agree. `freq_only` uses the frequency detector alone, for
         # beeps whose volume is too unsteady for the default profile. Only used when
         # MachineDetection is enabled.
         machine_detection_beep_profile: nil,
+        # When enabled, a candidate beep must pass an additional spectral check before it
+        # is reported. Only used when MachineDetection is enabled.
+        machine_detection_beep_spectral_confirmation: nil,
+        # Minimum spectral purity, from 0 to 1, for a tone to be treated as a beep.
+        # Raising it rejects mixed tones such as ringback, which combines two frequencies.
+        # Only used when MachineDetection is enabled.
+        machine_detection_beep_spectral_min_purity: nil,
+        # When enabled, the fax CNG tone is rejected rather than reported as a beep. Only
+        # used when MachineDetection is enabled.
+        machine_detection_beep_spectral_reject_fax_cng: nil,
+        # Length of the spectral confirmation window, in milliseconds. Only used when
+        # MachineDetection is enabled.
+        machine_detection_beep_spectral_window: nil,
         # Silence duration threshold after a call screening prompt before ending prompt
         # detection, in milliseconds. Used when `DetectionMode` is `PremiumCallScreening`.
         machine_detection_prompt_end_timeout: nil,

data/rbi/telnyx/resources/voice_clones.rbi

@@ -88,8 +88,10 @@ module Telnyx
       end
 
       # Creates a new voice clone by uploading an audio file directly. Supported
-      # formats: WAV, MP3, FLAC, OGG, M4A. For best results, provide 5–10 seconds of
-      # clear speech. Maximum file size: 5MB for Telnyx, 20MB for Minimax.
+      # formats: WAV, MP3, FLAC, OGG, M4A. For best results, provide 5–60 seconds of
+      # clear speech (Ultra accepts up to 60 seconds; Qwen3TTS auto-trims to 10 seconds;
+      # Minimax accepts up to 5 minutes). Maximum file size: 5MB for Telnyx, 20MB for
+      # Minimax.
       sig do
         params(
           voice_clone_upload_request:

data/rbi/telnyx/resources/webhooks.rbi

@@ -78,7 +78,9 @@ module Telnyx
             Telnyx::ReplacedLinkClickWebhookEvent,
             Telnyx::SessionStatusChangedWebhookEvent,
             Telnyx::TranscriptCompletedWebhookEvent,
-            Telnyx::TranscriptionWebhookEvent
+            Telnyx::TranscriptionWebhookEvent,
+            Telnyx::WhatsappAccountUpdate,
+            Telnyx::WhatsappMessageEcho
           )
         )
       end
@@ -167,7 +169,9 @@ module Telnyx
             Telnyx::ReplacedLinkClickWebhookEvent,
             Telnyx::SessionStatusChangedWebhookEvent,
             Telnyx::TranscriptCompletedWebhookEvent,
-            Telnyx::TranscriptionWebhookEvent
+            Telnyx::TranscriptionWebhookEvent,
+            Telnyx::WhatsappAccountUpdate,
+            Telnyx::WhatsappMessageEcho
           )
         )
       end

data/rbi/telnyx/resources/whatsapp/phone_numbers.rbi

@@ -101,6 +101,24 @@ module Telnyx
         )
         end
 
+        # Returns one WhatsApp phone number linked to the authenticated Telnyx account.
+        # For a coexistence number in the `syncing` state, the response includes
+        # `sync_progress`.
+        sig do
+          params(
+            phone_number: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(
+            Telnyx::Models::Whatsapp::PhoneNumberRetrievePhoneNumberResponse
+          )
+        end
+        def retrieve_phone_number(
+          # Phone number (E.164 format)
+          phone_number,
+          request_options: {}
+        )
+        end
+
         # Submits the verification code received for the specified WhatsApp phone number.
         sig do
           params(

data/rbi/telnyx/resources/x402/credit_account/payments.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class X402
+      class CreditAccount
+        # Operations for x402 cryptocurrency payment transactions. Fund your Telnyx
+        # account using USDC stablecoin payments via the x402 protocol.
+        class Payments
+          # Returns a single x402 payment transaction by ID. The transaction must belong to
+          # the authenticated user; organization sub-users must have read permission on
+          # transactions. Returns 404 if the transaction does not exist or belongs to
+          # another user.
+          sig do
+            params(
+              id: String,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(
+              Telnyx::Models::X402::CreditAccount::PaymentRetrieveResponse
+            )
+          end
+          def retrieve(
+            # The x402 payment transaction ID.
+            id,
+            request_options: {}
+          )
+          end
+
+          # Returns a paginated list of the authenticated user's x402 payment transactions,
+          # newest first. Organization sub-users must have read permission on transactions;
+          # without it the list is empty.
+          sig do
+            params(
+              page_number: Integer,
+              page_size: Integer,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(
+              Telnyx::Internal::DefaultFlatPagination[
+                Telnyx::X402::CreditAccount::X402TransactionRecord
+              ]
+            )
+          end
+          def list(
+            # The page number to load.
+            page_number: nil,
+            # The size of the page.
+            page_size: nil,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: Telnyx::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/x402/credit_account.rbi

@@ -6,6 +6,11 @@ module Telnyx
       # Operations for x402 cryptocurrency payment transactions. Fund your Telnyx
       # account using USDC stablecoin payments via the x402 protocol.
       class CreditAccount
+        # Operations for x402 cryptocurrency payment transactions. Fund your Telnyx
+        # account using USDC stablecoin payments via the x402 protocol.
+        sig { returns(Telnyx::Resources::X402::CreditAccount::Payments) }
+        attr_reader :payments
+
         # Creates a payment quote for the specified USD amount. Returns payment details
         # including the x402 payment requirements, network, and expiration time. The quote
         # must be settled before it expires.

data/sig/telnyx/client.rbs

@@ -380,6 +380,18 @@ module Telnyx
 
     attr_reader external_requirements: Telnyx::Resources::ExternalRequirements
 
+    attr_reader compute: Telnyx::Resources::Compute
+
+    attr_reader noise_suppression_engines: Telnyx::Resources::NoiseSuppressionEngines
+
+    attr_reader bot_challenge: Telnyx::Resources::BotChallenge
+
+    attr_reader bot_sessions: Telnyx::Resources::BotSessions
+
+    attr_reader bot_signup: Telnyx::Resources::BotSignup
+
+    attr_reader machine_payments: Telnyx::Resources::MachinePayments
+
     private def auth_headers: -> ::Hash[String, String]
 
     private def bearer_auth: -> ::Hash[String, String]

data/sig/telnyx/models/ai/assistant_a2_a_agent.rbs

@@ -0,0 +1,140 @@
+module Telnyx
+  module Models
+    module AI
+      type assistant_a2_a_agent =
+        {
+          name: String,
+          url: String,
+          async: bool,
+          headers: ::Array[Telnyx::AI::AssistantA2AAgent::Header],
+          messages: ::Array[Telnyx::Models::AI::AssistantA2AAgent::message],
+          poll_interval_ms: Integer,
+          timeout_ms: Integer
+        }
+
+      class AssistantA2AAgent < Telnyx::Internal::Type::BaseModel
+        attr_accessor name: String
+
+        attr_accessor url: String
+
+        attr_reader async: bool?
+
+        def async=: (bool) -> bool
+
+        attr_reader headers: ::Array[Telnyx::AI::AssistantA2AAgent::Header]?
+
+        def headers=: (
+          ::Array[Telnyx::AI::AssistantA2AAgent::Header]
+        ) -> ::Array[Telnyx::AI::AssistantA2AAgent::Header]
+
+        attr_reader messages: ::Array[Telnyx::Models::AI::AssistantA2AAgent::message]?
+
+        def messages=: (
+          ::Array[Telnyx::Models::AI::AssistantA2AAgent::message]
+        ) -> ::Array[Telnyx::Models::AI::AssistantA2AAgent::message]
+
+        attr_reader poll_interval_ms: Integer?
+
+        def poll_interval_ms=: (Integer) -> Integer
+
+        attr_reader timeout_ms: Integer?
+
+        def timeout_ms=: (Integer) -> Integer
+
+        def initialize: (
+          name: String,
+          url: String,
+          ?async: bool,
+          ?headers: ::Array[Telnyx::AI::AssistantA2AAgent::Header],
+          ?messages: ::Array[Telnyx::Models::AI::AssistantA2AAgent::message],
+          ?poll_interval_ms: Integer,
+          ?timeout_ms: Integer
+        ) -> void
+
+        def to_hash: -> {
+          name: String,
+          url: String,
+          async: bool,
+          headers: ::Array[Telnyx::AI::AssistantA2AAgent::Header],
+          messages: ::Array[Telnyx::Models::AI::AssistantA2AAgent::message],
+          poll_interval_ms: Integer,
+          timeout_ms: Integer
+        }
+
+        type header = { name: String, value: String }
+
+        class Header < Telnyx::Internal::Type::BaseModel
+          attr_accessor name: String
+
+          attr_accessor value: String
+
+          def initialize: (name: String, value: String) -> void
+
+          def to_hash: -> { name: String, value: String }
+        end
+
+        type message =
+          Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage
+          | Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage
+
+        module Message
+          extend Telnyx::Internal::Type::Union
+
+          type a2_a_agent_request_start_message =
+            { content: String, type: :request_start, timing_ms: Integer }
+
+          class A2AAgentRequestStartMessage < Telnyx::Internal::Type::BaseModel
+            attr_accessor content: String
+
+            attr_accessor type: :request_start
+
+            attr_reader timing_ms: Integer?
+
+            def timing_ms=: (Integer) -> Integer
+
+            def initialize: (
+              content: String,
+              ?timing_ms: Integer,
+              ?type: :request_start
+            ) -> void
+
+            def to_hash: -> {
+              content: String,
+              type: :request_start,
+              timing_ms: Integer
+            }
+          end
+
+          type a2_a_agent_request_response_delayed_message =
+            {
+              content: String,
+              timing_ms: Integer,
+              type: :request_response_delayed
+            }
+
+          class A2AAgentRequestResponseDelayedMessage < Telnyx::Internal::Type::BaseModel
+            attr_accessor content: String
+
+            attr_accessor timing_ms: Integer
+
+            attr_accessor type: :request_response_delayed
+
+            def initialize: (
+              content: String,
+              timing_ms: Integer,
+              ?type: :request_response_delayed
+            ) -> void
+
+            def to_hash: -> {
+              content: String,
+              timing_ms: Integer,
+              type: :request_response_delayed
+            }
+          end
+
+          def self?.variants: -> ::Array[Telnyx::Models::AI::AssistantA2AAgent::message]
+        end
+      end
+    end
+  end
+end

data/sig/telnyx/models/ai/assistant_create_params.rbs

@@ -5,6 +5,7 @@ module Telnyx
         {
           instructions: String,
           name: String,
+          :a2a_agents => ::Array[Telnyx::AI::AssistantA2AAgent],
           conversation_flow: Telnyx::AI::ConversationFlowReq,
           description: String,
           dynamic_variables: ::Hash[Symbol, top],
@@ -43,6 +44,12 @@ module Telnyx
 
         attr_accessor name: String
 
+        attr_reader a2a_agents: ::Array[Telnyx::AI::AssistantA2AAgent]?
+
+        def a2a_agents=: (
+          ::Array[Telnyx::AI::AssistantA2AAgent]
+        ) -> ::Array[Telnyx::AI::AssistantA2AAgent]
+
         attr_reader conversation_flow: Telnyx::AI::ConversationFlowReq?
 
         def conversation_flow=: (
@@ -188,6 +195,7 @@ module Telnyx
         def initialize: (
           instructions: String,
           name: String,
+          ?a2a_agents: ::Array[Telnyx::AI::AssistantA2AAgent],
           ?conversation_flow: Telnyx::AI::ConversationFlowReq,
           ?description: String,
           ?dynamic_variables: ::Hash[Symbol, top],
@@ -221,6 +229,7 @@ module Telnyx
         def to_hash: -> {
           instructions: String,
           name: String,
+          :a2a_agents => ::Array[Telnyx::AI::AssistantA2AAgent],
           conversation_flow: Telnyx::AI::ConversationFlowReq,
           description: String,
           dynamic_variables: ::Hash[Symbol, top],