telnyx 7.22.0 → 7.23.0

package/src/resources/texml/calls.ts

@@ -0,0 +1,90 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * TeXML REST Commands
+ */
+export class Calls extends APIResource {
+  /**
+   * 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.
+   *
+   * @example
+   * ```ts
+   * const call = await client.texml.calls.create('1234567890', {
+   *   From: '+13120001234',
+   *   To: '+13121230000',
+   *   Texml: '<Response><Say>Hello</Say></Response>',
+   * });
+   * ```
+   */
+  create(
+    connectionID: string,
+    body: CallCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<CallCreateResponse> {
+    return this._client.post(path`/texml/calls/${connectionID}`, { body, ...options });
+  }
+}
+
+export interface CallCreateResponse {
+  /**
+   * The call control ID of the created call.
+   */
+  call_sid: string;
+
+  /**
+   * The caller address.
+   */
+  from: string;
+
+  /**
+   * The initial status of the outbound call.
+   */
+  status: 'queued';
+
+  /**
+   * The called address.
+   */
+  to: string;
+}
+
+export interface CallCreateParams {
+  /**
+   * The E.164-formatted phone number or SIP URI to present as the caller.
+   */
+  From: string;
+
+  /**
+   * The E.164-formatted phone number or SIP URI to call.
+   */
+  To: string;
+
+  /**
+   * HTTP method used to retrieve TeXML instructions from Url.
+   */
+  Method?: 'GET' | 'POST';
+
+  /**
+   * Inline TeXML instructions to execute when the call is answered.
+   */
+  Texml?: string;
+
+  /**
+   * The URL from which to retrieve TeXML instructions. Overrides the TeXML
+   * application XML request URL.
+   */
+  Url?: string;
+}
+
+export declare namespace Calls {
+  export { type CallCreateResponse as CallCreateResponse, type CallCreateParams as CallCreateParams };
+}

package/src/resources/texml/index.ts

@@ -8,6 +8,7 @@ export {
   type AccountRetrieveRecordingsJsonParams,
   type AccountRetrieveTranscriptionsJsonParams,
 } from './accounts/index';
+export { Calls, type CallCreateResponse, type CallCreateParams } from './calls';
 export {
   Texml,
   type TexmlInitiateAICallResponse,

package/src/resources/texml/texml.ts

@@ -1,6 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as CallsAPI from './calls';
+import { CallCreateParams, CallCreateResponse, Calls } from './calls';
 import * as AccountsAPI from './accounts/accounts';
 import {
   AccountRetrieveRecordingsJsonParams,
@@ -18,6 +20,7 @@ import { path } from '../../internal/utils/path';
  * TeXML REST Commands
  */
 export class Texml extends APIResource {
+  calls: CallsAPI.Calls = new CallsAPI.Calls(this._client);
   accounts: AccountsAPI.Accounts = new AccountsAPI.Accounts(this._client);
 
   /**
@@ -203,6 +206,27 @@ export interface TexmlInitiateAICallParams {
    */
   MachineDetection?: 'Enable' | 'Disable' | 'DetectMessageEnd';
 
+  /**
+   * Highest frequency, in Hz, that a tone can reach and still be treated as a beep.
+   * Only used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepMaxFrequency?: number;
+
+  /**
+   * 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.
+   */
+  MachineDetectionBeepMinFrequency?: number;
+
+  /**
+   * 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.
+   */
+  MachineDetectionBeepMinToneDuration?: number;
+
   /**
    * Selects which detectors must validate a beep. `both` requires the amplitude and
    * frequency detectors to agree. `freq_only` uses the frequency detector alone, for
@@ -211,6 +235,31 @@ export interface TexmlInitiateAICallParams {
    */
   MachineDetectionBeepProfile?: 'both' | 'freq_only';
 
+  /**
+   * When enabled, a candidate beep must pass an additional spectral check before it
+   * is reported. Only used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralConfirmation?: boolean;
+
+  /**
+   * 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.
+   */
+  MachineDetectionBeepSpectralMinPurity?: number;
+
+  /**
+   * When enabled, the fax CNG tone is rejected rather than reported as a beep. Only
+   * used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralRejectFaxCng?: boolean;
+
+  /**
+   * Length of the spectral confirmation window, in milliseconds. Only used when
+   * MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralWindow?: number;
+
   /**
    * Silence duration threshold after a call screening prompt before ending prompt
    * detection, in milliseconds. Used when `DetectionMode` is `PremiumCallScreening`.
@@ -373,6 +422,7 @@ export namespace TexmlInitiateAICallParams {
   }
 }
 
+Texml.Calls = Calls;
 Texml.Accounts = Accounts;
 
 export declare namespace Texml {
@@ -383,6 +433,12 @@ export declare namespace Texml {
     type TexmlInitiateAICallParams as TexmlInitiateAICallParams,
   };
 
+  export {
+    Calls as Calls,
+    type CallCreateResponse as CallCreateResponse,
+    type CallCreateParams as CallCreateParams,
+  };
+
   export {
     Accounts as Accounts,
     type TexmlGetCallRecordingResponseBody as TexmlGetCallRecordingResponseBody,

package/src/resources/voice-clones.ts

@@ -58,8 +58,10 @@ export class VoiceClones extends APIResource {
 
   /**
    * 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.
    *
    * @example
    * ```ts
@@ -412,8 +414,8 @@ export namespace VoiceCloneCreateFromUploadParams {
   export interface TelnyxUltraClone {
     /**
      * Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A.
-     * For best quality, provide 5–10 seconds of clear, uninterrupted speech. Maximum
-     * size: 5MB.
+     * For best quality, provide up to 60 seconds of clear, uninterrupted speech.
+     * Maximum size: 5MB.
      */
     audio_file: Uploadable;
 

package/src/resources/webhooks.ts

@@ -4320,6 +4320,30 @@ export interface InboundSipHeader {
   value: string;
 }
 
+export interface MessagingInboundMessage {
+  /**
+   * Identifies the type of resource.
+   */
+  id?: string;
+
+  /**
+   * The type of event being delivered.
+   */
+  event_type?: 'message.received';
+
+  /**
+   * ISO 8601 formatted date indicating when the resource was created.
+   */
+  occurred_at?: string;
+
+  payload?: MessagesAPI.MessagingInboundMessagePayload;
+
+  /**
+   * Identifies the type of the resource.
+   */
+  record_type?: 'event';
+}
+
 export interface NumberOrderStatusUpdate {
   data: NumberOrderStatusUpdate.Data;
 
@@ -4336,7 +4360,7 @@ export namespace NumberOrderStatusUpdate {
     /**
      * The type of event being sent
      */
-    event_type: string;
+    event_type: 'number_order.complete';
 
     /**
      * ISO 8601 timestamp of when the event occurred
@@ -4373,7 +4397,7 @@ export interface OutboundMessage {
   /**
    * The type of event being delivered.
    */
-  event_type?: 'message.sent' | 'message.finalized';
+  event_type?: 'message.sent' | 'message.finalized' | 'message.read';
 
   /**
    * ISO 8601 formatted date indicating when the resource was created.
@@ -5883,33 +5907,7 @@ export namespace HostedNumberOrderEventWebhookEvent {
 }
 
 export interface InboundMessageWebhookEvent {
-  data?: InboundMessageWebhookEvent.Data;
-}
-
-export namespace InboundMessageWebhookEvent {
-  export interface Data {
-    /**
-     * Identifies the type of resource.
-     */
-    id?: string;
-
-    /**
-     * The type of event being delivered.
-     */
-    event_type?: 'message.received';
-
-    /**
-     * ISO 8601 formatted date indicating when the resource was created.
-     */
-    occurred_at?: string;
-
-    payload?: MessagesAPI.MessagingInboundMessagePayload;
-
-    /**
-     * Identifies the type of the resource.
-     */
-    record_type?: 'event';
-  }
+  data?: MessagingInboundMessage;
 }
 
 export interface NumberOrderStatusUpdateWebhookEvent {
@@ -5928,7 +5926,7 @@ export namespace NumberOrderStatusUpdateWebhookEvent {
     /**
      * The type of event being sent
      */
-    event_type: string;
+    event_type: 'number_order.complete';
 
     /**
      * ISO 8601 timestamp of when the event occurred
@@ -7472,33 +7470,7 @@ export namespace HostedNumberOrderEventWebhookEvent {
 }
 
 export interface InboundMessageWebhookEvent {
-  data?: InboundMessageWebhookEvent.Data;
-}
-
-export namespace InboundMessageWebhookEvent {
-  export interface Data {
-    /**
-     * Identifies the type of resource.
-     */
-    id?: string;
-
-    /**
-     * The type of event being delivered.
-     */
-    event_type?: 'message.received';
-
-    /**
-     * ISO 8601 formatted date indicating when the resource was created.
-     */
-    occurred_at?: string;
-
-    payload?: MessagesAPI.MessagingInboundMessagePayload;
-
-    /**
-     * Identifies the type of the resource.
-     */
-    record_type?: 'event';
-  }
+  data?: MessagingInboundMessage;
 }
 
 export interface NumberOrderStatusUpdateWebhookEvent {
@@ -7517,7 +7489,7 @@ export namespace NumberOrderStatusUpdateWebhookEvent {
     /**
      * The type of event being sent
      */
-    event_type: string;
+    event_type: 'number_order.complete';
 
     /**
      * ISO 8601 timestamp of when the event occurred
@@ -8060,6 +8032,7 @@ export declare namespace Webhooks {
     type FaxSendingStarted as FaxSendingStarted,
     type InboundMessage as InboundMessage,
     type InboundSipHeader as InboundSipHeader,
+    type MessagingInboundMessage as MessagingInboundMessage,
     type NumberOrderStatusUpdate as NumberOrderStatusUpdate,
     type OutboundMessage as OutboundMessage,
     type ReplacedLinkClick as ReplacedLinkClick,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '7.22.0'; // x-release-please-version
+export const VERSION = '7.23.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.22.0";
+export declare const VERSION = "7.23.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.22.0";
+export declare const VERSION = "7.23.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '7.22.0'; // x-release-please-version
+exports.VERSION = '7.23.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '7.22.0'; // x-release-please-version
+export const VERSION = '7.23.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map