telnyx 5.168.0 → 5.170.0

data/lib/telnyx/resources/email_templates.rb

@@ -9,16 +9,22 @@ module Telnyx
       #
       # Creates a Liquid email template. Variables are auto-extracted when omitted.
       #
-      # @overload create(name:, html_body: nil, subject: nil, text_body: nil, variables: nil, idempotency_key: nil, request_options: {})
+      # @overload create(name:, autoescape: nil, html_body: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil, idempotency_key: nil, request_options: {})
       #
       # @param name [String] Body param: Letters, numbers, spaces, hyphens, and underscores only.
       #
+      # @param autoescape [Boolean] Body param: Per-template HTML autoescaping setting. Defaults to `false` for back
+      #
       # @param html_body [String, nil] Body param: Liquid template HTML body.
       #
+      # @param strict_variables [Boolean] Body param: Per-template strict variable-validation setting. Defaults to `false`
+      #
       # @param subject [String, nil] Body param: Liquid template subject.
       #
       # @param text_body [String, nil] Body param: Liquid template text body.
       #
+      # @param variable_schema [Hash{Symbol=>Telnyx::Models::EmailTemplateCreateParams::VariableSchema}, nil] Body param: Structured variable requirements. Required variables cannot define d
+      #
       # @param variables [Array<String>] Body param: Template variables. Auto-extracted from subject/body fields when abs
       #
       # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
@@ -62,21 +68,30 @@ module Telnyx
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::EmailTemplateUpdateParams} for more details.
+      #
       # Updates one or more fields of the specified email template and returns the
       # updated template.
       #
-      # @overload update(id, html_body: nil, name: nil, subject: nil, text_body: nil, variables: nil, request_options: {})
+      # @overload update(id, autoescape: nil, html_body: nil, name: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil, request_options: {})
       #
       # @param id [String] Email template UUID.
       #
+      # @param autoescape [Boolean] Per-template HTML autoescaping setting.
+      #
       # @param html_body [String, nil] Liquid template HTML body.
       #
       # @param name [String]
       #
+      # @param strict_variables [Boolean] Per-template strict variable-validation setting.
+      #
       # @param subject [String, nil] Liquid template subject.
       #
       # @param text_body [String, nil] Liquid template text body.
       #
+      # @param variable_schema [Hash{Symbol=>Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema}, nil] Structured variable requirements. Required variables cannot define defaults; inv
+      #
       # @param variables [Array<String>]
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -151,6 +166,12 @@ module Telnyx
       # Renders a template using the provided Liquid variables. Missing
       # `template_variables` defaults to `{}`.
       #
+      # When the template has `strict_variables` enabled and a required variable (per
+      # `variable_schema`) is missing, returns 422 naming the variable. When the
+      # template has `autoescape` enabled, the rendered `html_body` expression output is
+      # HTML-escaped at the output boundary; `subject` and `text_body` are not
+      # autoescaped.
+      #
       # @overload render(id, template_variables: nil, request_options: {})
       #
       # @param id [String] Email template UUID.
@@ -173,21 +194,30 @@ module Telnyx
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::EmailTemplateReplaceParams} for more details.
+      #
       # Replaces template fields. Behaves identically to PATCH; provided for
       # compatibility with Phoenix resource routes.
       #
-      # @overload replace(id, html_body: nil, name: nil, subject: nil, text_body: nil, variables: nil, request_options: {})
+      # @overload replace(id, autoescape: nil, html_body: nil, name: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil, request_options: {})
       #
       # @param id [String] Email template UUID.
       #
+      # @param autoescape [Boolean] Per-template HTML autoescaping setting.
+      #
       # @param html_body [String, nil] Liquid template HTML body.
       #
       # @param name [String]
       #
+      # @param strict_variables [Boolean] Per-template strict variable-validation setting.
+      #
       # @param subject [String, nil] Liquid template subject.
       #
       # @param text_body [String, nil] Liquid template text body.
       #
+      # @param variable_schema [Hash{Symbol=>Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema}, nil] Structured variable requirements. Required variables cannot define defaults; inv
+      #
       # @param variables [Array<String>]
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/telnyx/resources/machine_payments.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    # Machine payment (MPP) account-credit operations. Fund your Telnyx account
+    # programmatically from a machine or agent using the Machine Payment Protocol, an
+    # HTTP-402 flow settled via Stripe or Tempo.
+    class MachinePayments
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::MachinePaymentAccountCreditParams} for more details.
+      #
+      # Creates an account credit using the Machine Payment Protocol (MPP), an HTTP-402
+      # payment flow for machines and agents.
+      #
+      # The flow has two steps. First, send an authenticated request with the
+      # `amount_usd` to credit; the response is `402 Payment Required` with one or more
+      # payment challenges (for example separate Tempo and Stripe challenges) in the
+      # `WWW-Authenticate` header. Second, retry the request with an
+      # `Authorization: Payment ...` credential constructed from the challenge; on
+      # success the response includes the credited transaction and a `Payment-Receipt`
+      # header.
+      #
+      # The credited account is never chosen by the request body: the initial request
+      # credits the account of the authenticated user, and a paid retry credits the
+      # account bound to the verified payment credential. The amount must be within the
+      # configured bounds (by default between 5.00 and 500.00 USD).
+      #
+      # Successful paid retries are idempotent — when Rails reaches its
+      # duplicate-transaction lookup for an already-recorded payment, it returns the
+      # existing transaction with `created: false` instead of crediting the account
+      # again. This deduplication applies to successful fulfillment: re-sending the same
+      # Stripe credential may instead be rejected by the upstream provider as an
+      # idempotent replay and return `402 Payment Required` rather than the existing
+      # transaction.
+      #
+      # > **Warning: the payment credential is bound to a specific Telnyx account ID.**
+      # > A payment is captured before the bound account is validated. If the credential
+      # > names an account that is missing, suspended, blocked, cancelled, dormant, or
+      # > ineligible for the tier, the payment is captured but **no account is
+      # > credited**. If the credential names a different but eligible account, that
+      # > account is credited — the service does not compare it against the payer's
+      # > account. There is **no automatic refund**: if the captured payment does not
+      # > credit the intended account, contact Telnyx support for remediation.
+      #
+      # @overload account_credit(amount_usd:, request_options: {})
+      #
+      # @param amount_usd [String] Amount to credit in USD, as a decimal string with up to two fractional digits (b
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MachinePaymentAccountCreditResponse]
+      #
+      # @see Telnyx::Models::MachinePaymentAccountCreditParams
+      def account_credit(params)
+        parsed, options = Telnyx::MachinePaymentAccountCreditParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "machine-payments/account-credit",
+          body: parsed,
+          model: Telnyx::Models::MachinePaymentAccountCreditResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/telnyx/resources/meeting_sessions/actions.rb

@@ -32,7 +32,13 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::MeetingSessions::ActionSpeakParams} for more details.
         #
-        # Sends audio / text-to-speech into a meeting session.
+        # Sends audio / text-to-speech into a meeting session. With a Telnyx AI Assistant
+        # (or avatar) attached, the bot is a webpage-output bot: the speak audio routes
+        # through the assistant's output page rather than the bot mic and plays once the
+        # assistant is connected -- it is not refused. If that page cannot be reached,
+        # delivery fails with the 502 below, which may arrive without an error envelope,
+        # so branch on the status code before parsing a body. The assistant is designed to
+        # own the conversation, so prefer letting it speak or use `send_chat`.
         #
         # @overload speak(id, text:, interrupt: nil, voice: nil, request_options: {})
         #

data/lib/telnyx/resources/meeting_sessions/artifacts.rb

@@ -5,17 +5,26 @@ module Telnyx
     class MeetingSessions
       # Create and retrieve asynchronous summaries and action-item artifacts.
       class Artifacts
-        # Requests asynchronous generation of one `summary` or `action_items` artifact.
-        # Each type requires its own request. Generation requires transcript content and
-        # configured inference and currently reads at most the first 10,000 segments, so
-        # exceptionally long transcripts may produce incomplete artifacts or fail model
-        # limits.
-        #
-        # @overload create(id, type:, request_options: {})
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::MeetingSessions::ArtifactCreateParams} for more details.
+        #
+        # Requests asynchronous generation of one artifact: `summary`, `action_items`,
+        # `decisions`, `topics`, `open_questions`, or `custom`. Each request produces one
+        # artifact. `custom` is answered from a `prompt` you supply, which is required for
+        # `custom` and rejected on the five named types. Generation requires transcript
+        # content and configured inference and currently reads at most the first 10,000
+        # segments, so exceptionally long transcripts may produce incomplete artifacts or
+        # fail model limits. **Not idempotent, and every call is billed**: each request is
+        # a separate inference run, so a retry or a duplicate POST produces a second
+        # artifact and a second charge. Guard the call rather than relying on the service
+        # to collapse it. The automatic `summarize_on_end` attempt is billed on the same
+        # basis.
+        #
+        # @overload create(id, body:, request_options: {})
         #
         # @param id [String] Unique identifier for the meeting session.
         #
-        # @param type [Symbol, Telnyx::Models::MeetingSessions::ArtifactCreateParams::Type] Type of artifact to generate from the session.
+        # @param body [Telnyx::Models::MeetingSessions::ArtifactCreateParams::Body::NamedArtifact, Telnyx::Models::MeetingSessions::ArtifactCreateParams::Body::CustomArtifact] One of two shapes: a named type on its own, or `custom` with the prompt it answe
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -27,7 +36,7 @@ module Telnyx
           @client.request(
             method: :post,
             path: ["meeting_sessions/%1$s/artifacts", id],
-            body: parsed,
+            body: parsed[:body],
             model: Telnyx::MeetingSessions::MeetingSessionArtifactResponse,
             options: options
           )

data/lib/telnyx/resources/meeting_sessions.rb

@@ -26,11 +26,11 @@ module Telnyx
       # before bot creation; neither the source URL nor image bytes are persisted,
       # returned, or logged. Treat signed URLs as credentials.
       #
-      # @overload create(meeting_url:, assistant: nil, avatar: nil, barge_in: nil, bot_name: nil, camera_image: nil, idempotency_key: nil, join_at: nil, metadata: nil, speak_on_enter: nil, summarize_on_end: nil, voice: nil, webhook_url: nil, request_options: {})
+      # @overload create(meeting_url:, assistant: nil, avatar: nil, barge_in: nil, bot_name: nil, camera_image: nil, chat_on_enter: nil, idempotency_key: nil, join_at: nil, metadata: nil, speak_on_enter: nil, summarize_on_end: nil, voice: nil, webhook_url: nil, request_options: {})
       #
       # @param meeting_url [String] The meeting URL the bot should join.
       #
-      # @param assistant [Telnyx::Models::MeetingSessionCreateParams::Assistant] Request options for attaching a voice assistant to the session. Routing fields (
+      # @param assistant [Telnyx::Models::MeetingSessionCreateParams::Assistant] Attach a Telnyx AI Assistant to the session. Supply the Assistant's ID; the Meet
       #
       # @param avatar [Telnyx::Models::MeetingSessionCreateParams::Avatar] Request options for attaching a bring-your-own-key avatar to the session.
       #
@@ -40,13 +40,16 @@ module Telnyx
       #
       # @param camera_image [Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageBase64Source, Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageURLSource] Write-only static camera-tile image for this session, not a native account or pa
       #
+      # @param chat_on_enter [String] A message the bot posts to the meeting's chat as soon as it becomes active — typ
+      #
       # @param idempotency_key [String] Client-supplied idempotency key to safely retry creation requests without duplic
       #
       # @param join_at [Time] ISO-8601 timestamp in the future at which the bot should join. If omitted, the b
       #
       # @param metadata [Hash{Symbol=>Object}] Arbitrary key-value metadata attached to the session. The serialized JSON repres
       #
-      # @param speak_on_enter [String] Text the bot speaks when it enters the meeting.
+      # @param speak_on_enter [String] Text the bot speaks when it enters the meeting. \*\*Not spoken when an
+      # `assistant`
       #
       # @param summarize_on_end [Boolean] If true, generate a summary artifact when the session ends.
       #
@@ -165,8 +168,6 @@ module Telnyx
         )
       end
 
-      # **Not yet available in production** — this route is not currently routed on
-      # api.telnyx.com and returns a generic 404; it is documented ahead of rollout.
       # Irreversibly requests deletion of provider-hosted aggregate recording media
       # under the provider contract. The operation retains the Telnyx-local Meeting
       # session, transcript segments, events, artifacts, and usage records. It is

data/lib/telnyx/resources/noise_suppression_engines.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+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.
+      #
+      # @overload list(request_options: {})
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::NoiseSuppressionEngineListResponse]
+      #
+      # @see Telnyx::Models::NoiseSuppressionEngineListParams
+      def list(params = {})
+        @client.request(
+          method: :get,
+          path: "noise_suppression_engines",
+          model: Telnyx::Models::NoiseSuppressionEngineListResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/telnyx/resources/private_wireless_gateways.rb

@@ -11,12 +11,14 @@ module Telnyx
       # created network. This operation may take several minutes so you can check the
       # Private Wireless Gateway status at the section Get a Private Wireless Gateway.
       #
-      # @overload create(name:, network_id:, region_code: nil, request_options: {})
+      # @overload create(name:, network_id:, address_mode: nil, region_code: nil, request_options: {})
       #
       # @param name [String] The private wireless gateway name.
       #
       # @param network_id [String] The identification of the related network resource.
       #
+      # @param address_mode [Symbol, Telnyx::Models::PrivateWirelessGatewayCreateParams::AddressMode] Determines how IP addresses are assigned to SIM cards using this gateway. With s
+      #
       # @param region_code [String] The code of the region where the private wireless gateway will be assigned. A li
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -75,7 +77,7 @@ module Telnyx
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::PrivateWirelessGateway>]
+      # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::WirelessPrivateWirelessGateway>]
       #
       # @see Telnyx::Models::PrivateWirelessGatewayListParams
       def list(params = {})
@@ -94,7 +96,7 @@ module Telnyx
             page_size: "page[size]"
           ),
           page: Telnyx::Internal::DefaultFlatPagination,
-          model: Telnyx::PrivateWirelessGateway,
+          model: Telnyx::WirelessPrivateWirelessGateway,
           options: options
         )
       end

data/lib/telnyx/resources/texml/accounts/calls.rb

@@ -130,16 +130,16 @@ module Telnyx
           # Returns multiple call resouces for an account. This endpoint is eventually
           # consistent.
           #
-          # @overload retrieve_calls(account_sid, end_time: nil, end_time_gt: nil, end_time_lt: nil, from: nil, page: nil, page_size: nil, page_token: nil, start_time: nil, start_time_gt: nil, start_time_lt: nil, status: nil, to: nil, request_options: {})
+          # @overload retrieve_calls(account_sid, end_time: nil, end_time_lt: nil, end_time_gt: nil, from: nil, page: nil, page_size: nil, page_token: nil, start_time: nil, start_time_lt: nil, start_time_gt: nil, status: nil, to: nil, request_options: {})
           #
           # @param account_sid [String] The id of the account the resource belongs to.
           #
           # @param end_time [String] Filters calls by their end date. Expected format is YYYY-MM-DD
           #
-          # @param end_time_gt [String] Filters calls by their end date (after). Expected format is YYYY-MM-DD
-          #
           # @param end_time_lt [String] Filters calls by their end date (before). Expected format is YYYY-MM-DD
           #
+          # @param end_time_gt [String] Filters calls by their end date (after). Expected format is YYYY-MM-DD
+          #
           # @param from [String] Filters calls by the from number.
           #
           # @param page [Integer] The number of the page to be displayed, zero-indexed, should be used in conjucti
@@ -150,10 +150,10 @@ module Telnyx
           #
           # @param start_time [String] Filters calls by their start date. Expected format is YYYY-MM-DD.
           #
-          # @param start_time_gt [String] Filters calls by their start date (after). Expected format is YYYY-MM-DD
-          #
           # @param start_time_lt [String] Filters calls by their start date (before). Expected format is YYYY-MM-DD
           #
+          # @param start_time_gt [String] Filters calls by their start date (after). Expected format is YYYY-MM-DD
+          #
           # @param status [Symbol, Telnyx::Models::Texml::Accounts::CallRetrieveCallsParams::Status] Filters calls by status.
           #
           # @param to [String] Filters calls by the to number.
@@ -171,15 +171,15 @@ module Telnyx
               path: ["texml/Accounts/%1$s/Calls", account_sid],
               query: query.transform_keys(
                 end_time: "EndTime",
-                end_time_gt: "EndTime_gt",
-                end_time_lt: "EndTime_lt",
+                end_time_lt: "EndTime<",
+                end_time_gt: "EndTime>",
                 from: "From",
                 page: "Page",
                 page_size: "PageSize",
                 page_token: "PageToken",
                 start_time: "StartTime",
-                start_time_gt: "StartTime_gt",
-                start_time_lt: "StartTime_lt",
+                start_time_lt: "StartTime<",
+                start_time_gt: "StartTime>",
                 status: "Status",
                 to: "To"
               ),

data/lib/telnyx/resources/texml/accounts/conferences/participants.rb

@@ -159,7 +159,7 @@ module Telnyx
             # Dials a new participant into the specified conference and returns the created
             # participant resource.
             #
-            # @overload participants(conference_sid, account_sid:, amd_status_callback: nil, amd_status_callback_method: nil, application_sid: nil, beep: nil, caller_id: nil, call_sid_to_coach: nil, cancel_playback_on_detect_message_end: nil, cancel_playback_on_machine_detection: nil, coaching: nil, conference_record: nil, conference_recording_status_callback: nil, conference_recording_status_callback_event: nil, conference_recording_status_callback_method: nil, conference_recording_timeout: nil, conference_status_callback: nil, conference_status_callback_event: nil, conference_status_callback_method: nil, conference_trim: nil, custom_headers: nil, early_media: nil, end_conference_on_exit: nil, from: nil, label: nil, machine_detection: nil, machine_detection_beep_profile: nil, machine_detection_silence_timeout: nil, machine_detection_speech_end_threshold: nil, machine_detection_speech_threshold: nil, machine_detection_timeout: nil, max_participants: nil, muted: nil, preferred_codecs: nil, record: nil, recording_channels: nil, recording_status_callback: nil, recording_status_callback_event: nil, recording_status_callback_method: nil, recording_track: nil, sip_auth_password: nil, sip_auth_username: nil, start_conference_on_enter: nil, status_callback: nil, status_callback_event: nil, status_callback_method: nil, time_limit: nil, timeout_seconds: nil, to: nil, trim: nil, wait_url: nil, request_options: {})
+            # @overload participants(conference_sid, account_sid:, amd_status_callback: nil, amd_status_callback_method: nil, application_sid: nil, beep: nil, caller_id: nil, call_sid_to_coach: nil, cancel_playback_on_detect_message_end: nil, cancel_playback_on_machine_detection: nil, coaching: nil, conference_record: nil, conference_recording_status_callback: nil, conference_recording_status_callback_event: nil, conference_recording_status_callback_method: nil, conference_recording_timeout: nil, conference_status_callback: nil, conference_status_callback_event: nil, conference_status_callback_method: nil, conference_trim: nil, custom_headers: nil, early_media: nil, end_conference_on_exit: nil, from: nil, label: nil, machine_detection: nil, machine_detection_beep_max_frequency: nil, machine_detection_beep_min_frequency: nil, machine_detection_beep_min_tone_duration: nil, machine_detection_beep_profile: nil, machine_detection_beep_spectral_confirmation: nil, machine_detection_beep_spectral_min_purity: nil, machine_detection_beep_spectral_reject_fax_cng: nil, machine_detection_beep_spectral_window: nil, machine_detection_silence_timeout: nil, machine_detection_speech_end_threshold: nil, machine_detection_speech_threshold: nil, machine_detection_timeout: nil, max_participants: nil, muted: nil, preferred_codecs: nil, record: nil, recording_channels: nil, recording_status_callback: nil, recording_status_callback_event: nil, recording_status_callback_method: nil, recording_track: nil, sip_auth_password: nil, sip_auth_username: nil, start_conference_on_enter: nil, status_callback: nil, status_callback_event: nil, status_callback_method: nil, time_limit: nil, timeout_seconds: nil, to: nil, trim: nil, wait_url: nil, request_options: {})
             #
             # @param conference_sid [String] Path param: The ConferenceSid that uniquely identifies a conference.
             #
@@ -213,8 +213,22 @@ module Telnyx
             #
             # @param machine_detection [Symbol, Telnyx::Models::Texml::Accounts::Conferences::ParticipantParticipantsParams::MachineDetection] Body param: Whether to detect if a human or an answering machine picked up the c
             #
+            # @param machine_detection_beep_max_frequency [Integer] Body param: Highest frequency, in Hz, that a tone can reach and still be treated
+            #
+            # @param machine_detection_beep_min_frequency [Integer] Body param: Lowest frequency, in Hz, that a tone must reach to be treated as a b
+            #
+            # @param machine_detection_beep_min_tone_duration [Integer] Body param: Shortest tone, in milliseconds, that can be treated as a beep. Raisi
+            #
             # @param machine_detection_beep_profile [Symbol, Telnyx::Models::Texml::Accounts::Conferences::ParticipantParticipantsParams::MachineDetectionBeepProfile] Body param: Selects which detectors must validate a beep. `both` requires the am
             #
+            # @param machine_detection_beep_spectral_confirmation [Boolean] Body param: When enabled, a candidate beep must pass an additional spectral chec
+            #
+            # @param machine_detection_beep_spectral_min_purity [Float] Body param: Minimum spectral purity, from 0 to 1, for a tone to be treated as a
+            #
+            # @param machine_detection_beep_spectral_reject_fax_cng [Boolean] Body param: When enabled, the fax CNG tone is rejected rather than reported as a
+            #
+            # @param machine_detection_beep_spectral_window [Integer] Body param: Length of the spectral confirmation window, in milliseconds. Only us
+            #
             # @param machine_detection_silence_timeout [Integer] Body param: If initial silence duration is greater than this value, consider it
             #
             # @param machine_detection_speech_end_threshold [Integer] Body param: Silence duration threshold after a greeting message or voice for it

data/lib/telnyx/resources/texml/calls.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Texml
+      # TeXML REST Commands
+      class Calls
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Texml::CallCreateParams} for more details.
+        #
+        # 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.
+        #
+        # @overload create(connection_id, from:, to:, method_: nil, texml: nil, url: nil, request_options: {})
+        #
+        # @param connection_id [String] The ID of the connection holding the TeXML application to call from.
+        #
+        # @param from [String] The E.164-formatted phone number or SIP URI to present as the caller.
+        #
+        # @param to [String] The E.164-formatted phone number or SIP URI to call.
+        #
+        # @param method_ [Symbol, Telnyx::Models::Texml::CallCreateParams::Method] HTTP method used to retrieve TeXML instructions from Url.
+        #
+        # @param texml [String] Inline TeXML instructions to execute when the call is answered.
+        #
+        # @param url [String] The URL from which to retrieve TeXML instructions. Overrides the TeXML applicati
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Texml::CallCreateResponse]
+        #
+        # @see Telnyx::Models::Texml::CallCreateParams
+        def create(connection_id, params)
+          parsed, options = Telnyx::Texml::CallCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["texml/calls/%1$s", connection_id],
+            body: parsed,
+            model: Telnyx::Models::Texml::CallCreateResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/texml.rb

@@ -4,6 +4,10 @@ module Telnyx
   module Resources
     # TeXML REST Commands
     class Texml
+      # TeXML REST Commands
+      # @return [Telnyx::Resources::Texml::Calls]
+      attr_reader :calls
+
       # TeXML REST Commands
       # @return [Telnyx::Resources::Texml::Accounts]
       attr_reader :accounts
@@ -27,7 +31,7 @@ module Telnyx
       # Recording, AMD, transcription, and deepfake detection callbacks are only sent
       # when those features are enabled.
       #
-      # @overload initiate_ai_call(connection_id, ai_assistant_id:, from:, to:, ai_assistant_dynamic_variables: nil, ai_assistant_version: nil, async_amd: nil, async_amd_status_callback: nil, async_amd_status_callback_method: nil, caller_id: nil, conversation_callback: nil, conversation_callback_method: nil, conversation_callbacks: nil, custom_headers: nil, detection_mode: nil, machine_detection: nil, machine_detection_beep_profile: nil, machine_detection_prompt_end_timeout: nil, machine_detection_silence_timeout: nil, machine_detection_speech_end_threshold: nil, machine_detection_speech_threshold: nil, machine_detection_timeout: nil, passports: nil, preferred_codecs: nil, record: nil, recording_channels: nil, recording_status_callback: nil, recording_status_callback_event: nil, recording_status_callback_method: nil, recording_timeout: nil, recording_track: nil, send_recording_url: nil, sip_auth_password: nil, sip_auth_username: nil, sip_region: nil, status_callback: nil, status_callback_event: nil, status_callback_method: nil, status_callbacks: nil, time_limit: nil, timeout_seconds: nil, trim: nil, request_options: {})
+      # @overload initiate_ai_call(connection_id, ai_assistant_id:, from:, to:, ai_assistant_dynamic_variables: nil, ai_assistant_version: nil, async_amd: nil, async_amd_status_callback: nil, async_amd_status_callback_method: nil, caller_id: nil, conversation_callback: nil, conversation_callback_method: nil, conversation_callbacks: nil, custom_headers: nil, detection_mode: nil, machine_detection: nil, machine_detection_beep_max_frequency: nil, machine_detection_beep_min_frequency: nil, machine_detection_beep_min_tone_duration: nil, machine_detection_beep_profile: nil, machine_detection_beep_spectral_confirmation: nil, machine_detection_beep_spectral_min_purity: nil, machine_detection_beep_spectral_reject_fax_cng: nil, machine_detection_beep_spectral_window: nil, machine_detection_prompt_end_timeout: nil, machine_detection_silence_timeout: nil, machine_detection_speech_end_threshold: nil, machine_detection_speech_threshold: nil, machine_detection_timeout: nil, passports: nil, preferred_codecs: nil, record: nil, recording_channels: nil, recording_status_callback: nil, recording_status_callback_event: nil, recording_status_callback_method: nil, recording_timeout: nil, recording_track: nil, send_recording_url: nil, sip_auth_password: nil, sip_auth_username: nil, sip_region: nil, status_callback: nil, status_callback_event: nil, status_callback_method: nil, status_callbacks: nil, time_limit: nil, timeout_seconds: nil, trim: nil, request_options: {})
       #
       # @param connection_id [String] The ID of the TeXML connection to use for the call.
       #
@@ -61,8 +65,22 @@ module Telnyx
       #
       # @param machine_detection [Symbol, Telnyx::Models::TexmlInitiateAICallParams::MachineDetection] Enables Answering Machine Detection.
       #
+      # @param machine_detection_beep_max_frequency [Integer] Highest frequency, in Hz, that a tone can reach and still be treated as a beep.
+      #
+      # @param machine_detection_beep_min_frequency [Integer] Lowest frequency, in Hz, that a tone must reach to be treated as a beep. Raising
+      #
+      # @param machine_detection_beep_min_tone_duration [Integer] Shortest tone, in milliseconds, that can be treated as a beep. Raising it reject
+      #
       # @param machine_detection_beep_profile [Symbol, Telnyx::Models::TexmlInitiateAICallParams::MachineDetectionBeepProfile] Selects which detectors must validate a beep. `both` requires the amplitude and
       #
+      # @param machine_detection_beep_spectral_confirmation [Boolean] When enabled, a candidate beep must pass an additional spectral check before it
+      #
+      # @param machine_detection_beep_spectral_min_purity [Float] Minimum spectral purity, from 0 to 1, for a tone to be treated as a beep. Raisin
+      #
+      # @param machine_detection_beep_spectral_reject_fax_cng [Boolean] When enabled, the fax CNG tone is rejected rather than reported as a beep. Only
+      #
+      # @param machine_detection_beep_spectral_window [Integer] Length of the spectral confirmation window, in milliseconds. Only used when Mach
+      #
       # @param machine_detection_prompt_end_timeout [Integer] Silence duration threshold after a call screening prompt before ending prompt de
       #
       # @param machine_detection_silence_timeout [Integer] If initial silence duration is greater than this value, consider it a machine. I
@@ -165,6 +183,7 @@ module Telnyx
       # @param client [Telnyx::Client]
       def initialize(client:)
         @client = client
+        @calls = Telnyx::Resources::Texml::Calls.new(client: client)
         @accounts = Telnyx::Resources::Texml::Accounts.new(client: client)
       end
     end

data/lib/telnyx/resources/text_to_speech.rb

@@ -20,13 +20,13 @@ module Telnyx
       # parameters.
       #
       # Supported providers: `aws`, `telnyx`, `azure`, `elevenlabs`, `minimax`,
-      # `resemble`, `xai`, `humain`.
+      # `resemble`, `xai`, `humain`, `soniox`.
       #
       # The Telnyx `Ultra` model supports 44 languages with emotion control, speed
       # adjustment, and volume control. Use the `telnyx` provider-specific parameters to
       # configure these features.
       #
-      # @overload generate_speech(aws: nil, azure: nil, disable_cache: nil, elevenlabs: nil, humain: nil, language: nil, minimax: nil, output_type: nil, provider: nil, resemble: nil, telnyx: nil, text: nil, text_type: nil, voice: nil, voice_settings: nil, xai: nil, request_options: {})
+      # @overload generate_speech(aws: nil, azure: nil, disable_cache: nil, elevenlabs: nil, humain: nil, language: nil, minimax: nil, output_type: nil, provider: nil, resemble: nil, soniox: nil, telnyx: nil, text: nil, text_type: nil, voice: nil, voice_settings: nil, xai: nil, request_options: {})
       #
       # @param aws [::Telnyx::Models::TextToSpeechGenerateSpeechParams::Aws] AWS Polly provider-specific parameters.
       #
@@ -48,6 +48,8 @@ module Telnyx
       #
       # @param resemble [::Telnyx::Models::TextToSpeechGenerateSpeechParams::Resemble] Resemble AI provider-specific parameters.
       #
+      # @param soniox [::Telnyx::Models::TextToSpeechGenerateSpeechParams::Soniox] Soniox provider-specific parameters. Every voice speaks all supported languages;
+      #
       # @param telnyx [::Telnyx::Models::TextToSpeechGenerateSpeechParams::Telnyx] Telnyx provider-specific parameters. For the `Ultra` model, use `voice_speed`, `
       #
       # @param text [String] The text to convert to speech.
@@ -113,8 +115,8 @@ module Telnyx
       # `Authorization: Bearer <API_KEY>` header. Send JSON frames with text to
       # synthesize; receive JSON frames containing base64-encoded audio chunks.
       #
-      # Supported providers: `aws`, `telnyx`, `azure`, `murfai`, `minimax`, `resemble`,
-      # `elevenlabs`, `xai`, `humain`.
+      # Supported providers: `aws`, `telnyx`, `azure`, `minimax`, `resemble`,
+      # `elevenlabs`, `xai`, `humain`, `soniox`.
       #
       # **Connection flow:**
       #

data/lib/telnyx/resources/voice_clones.rb

@@ -117,8 +117,10 @@ module Telnyx
       # {Telnyx::Models::VoiceCloneCreateFromUploadParams} for more details.
       #
       # 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.
       #
       # @overload create_from_upload(voice_clone_upload_request:, request_options: {})
       #

data/lib/telnyx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telnyx
-  VERSION = "5.168.0"
+  VERSION = "5.170.0"
 end