telnyx 7.24.0 → 7.26.0

package/src/resources/whatsapp/index.ts

@@ -20,6 +20,13 @@ export {
   type PhoneNumberGetParams,
   type PhoneNumberListResponsesDefaultFlatPagination,
 } from './phone-numbers/index';
+export {
+  Signup,
+  type SignupListResponse,
+  type SignupRetrieveStatusResponse,
+  type SignupListParams,
+  type SignupListResponsesDefaultFlatPagination,
+} from './signup';
 export {
   Templates,
   type WhatsappTemplateBodyComponent,

package/src/resources/whatsapp/phone-numbers/calling-routing.ts

@@ -0,0 +1,114 @@
+// 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';
+
+/**
+ * Manage Whatsapp phone numbers
+ */
+export class CallingRouting extends APIResource {
+  /**
+   * Retrieve the connection ID currently stored for a WhatsApp Calling BYON (Bring
+   * Your Own Number) phone number: the connection that inbound WhatsApp calls to the
+   * number are delivered to.
+   *
+   * Use it to check the result of
+   * `PATCH /whatsapp/phone_numbers/{id}/calling_routing`. A read made immediately
+   * after an update can still return the previous value.
+   *
+   * Sub-users need read permission on connections.
+   *
+   * @example
+   * ```ts
+   * const callingRoutings =
+   *   await client.whatsapp.phoneNumbers.callingRouting.list(
+   *     '+13125550100',
+   *   );
+   * ```
+   */
+  list(id: string, options?: RequestOptions): APIPromise<CallingRoutingListResponse> {
+    return this._client.get(path`/whatsapp/phone_numbers/${id}/calling_routing`, options);
+  }
+
+  /**
+   * Set or clear the connection ID for a WhatsApp Calling BYON (Bring Your Own
+   * Number) phone number: the connection that inbound WhatsApp calls to the number
+   * are delivered to.
+   *
+   * The update is processed asynchronously. A `202` response means the request was
+   * accepted, not that the routing changed. Check the result with
+   * `GET /whatsapp/phone_numbers/{id}/calling_routing`, which can return the
+   * previous value immediately after an update. An update for a number that is not a
+   * WhatsApp Calling number in the account returns 404.
+   *
+   * The connection must belong to the same account and must not be a WhatsApp
+   * connection. Send `connection_id: null` to clear the routing; omitting
+   * `connection_id` is rejected. Numbers active on Telnyx are rejected, because they
+   * route through their own connection assignment.
+   *
+   * Sub-users need update permission on connections, and read permission to check
+   * the result with `GET`.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.whatsapp.phoneNumbers.callingRouting.patchAll(
+   *     '+13125550100',
+   *     { connection_id: '1234567890' },
+   *   );
+   * ```
+   */
+  patchAll(
+    id: string,
+    body: CallingRoutingPatchAllParams,
+    options?: RequestOptions,
+  ): APIPromise<CallingRoutingPatchAllResponse> {
+    return this._client.patch(path`/whatsapp/phone_numbers/${id}/calling_routing`, { body, ...options });
+  }
+}
+
+export interface WhatsappCallingRoutingData {
+  /**
+   * ID of the routing connection, or `null` when none is set.
+   */
+  connection_id: string | null;
+
+  /**
+   * Phone number in E.164 format, with a leading `+`.
+   */
+  phone_number: string;
+
+  /**
+   * Identifies the type of the resource.
+   */
+  record_type: 'whatsapp_calling_routing';
+}
+
+export interface CallingRoutingListResponse {
+  data: WhatsappCallingRoutingData;
+}
+
+export interface CallingRoutingPatchAllResponse {
+  data: WhatsappCallingRoutingData;
+}
+
+export interface CallingRoutingPatchAllParams {
+  /**
+   * ID of the connection to deliver inbound WhatsApp calls to: a positive integer up
+   * to 9223372036854775807, sent as a decimal string or an integer. Send a string to
+   * keep large IDs exact. Non-null values are returned as strings. `null` clears the
+   * routing.
+   */
+  connection_id: string | number | null;
+}
+
+export declare namespace CallingRouting {
+  export {
+    type WhatsappCallingRoutingData as WhatsappCallingRoutingData,
+    type CallingRoutingListResponse as CallingRoutingListResponse,
+    type CallingRoutingPatchAllResponse as CallingRoutingPatchAllResponse,
+    type CallingRoutingPatchAllParams as CallingRoutingPatchAllParams,
+  };
+}

package/src/resources/whatsapp/phone-numbers/index.ts

@@ -1,5 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  CallingRouting,
+  type WhatsappCallingRoutingData,
+  type CallingRoutingListResponse,
+  type CallingRoutingPatchAllResponse,
+  type CallingRoutingPatchAllParams,
+} from './calling-routing';
 export {
   CallingSettings,
   type WhatsappCallingSettingsData,

package/src/resources/whatsapp/phone-numbers/phone-numbers.ts

@@ -2,6 +2,14 @@
 
 import { APIResource } from '../../../core/resource';
 import * as Shared from '../../shared';
+import * as CallingRoutingAPI from './calling-routing';
+import {
+  CallingRouting,
+  CallingRoutingListResponse,
+  CallingRoutingPatchAllParams,
+  CallingRoutingPatchAllResponse,
+  WhatsappCallingRoutingData,
+} from './calling-routing';
 import * as CallingSettingsAPI from './calling-settings';
 import {
   CallingSettingRetrieveResponse,
@@ -44,6 +52,7 @@ export class PhoneNumbers extends APIResource {
   profile: ProfileAPI.Profile = new ProfileAPI.Profile(this._client);
   conversationalComponents: ConversationalComponentsAPI.ConversationalComponents =
     new ConversationalComponentsAPI.ConversationalComponents(this._client);
+  callingRouting: CallingRoutingAPI.CallingRouting = new CallingRoutingAPI.CallingRouting(this._client);
 
   /**
    * Returns WhatsApp phone numbers linked to the authenticated Telnyx account.
@@ -528,6 +537,7 @@ export interface PhoneNumberGetParams {
 PhoneNumbers.CallingSettings = CallingSettings;
 PhoneNumbers.Profile = Profile;
 PhoneNumbers.ConversationalComponents = ConversationalComponents;
+PhoneNumbers.CallingRouting = CallingRouting;
 
 export declare namespace PhoneNumbers {
   export {
@@ -566,4 +576,12 @@ export declare namespace PhoneNumbers {
     type ConversationalComponentPatchAllResponse as ConversationalComponentPatchAllResponse,
     type ConversationalComponentPatchAllParams as ConversationalComponentPatchAllParams,
   };
+
+  export {
+    CallingRouting as CallingRouting,
+    type WhatsappCallingRoutingData as WhatsappCallingRoutingData,
+    type CallingRoutingListResponse as CallingRoutingListResponse,
+    type CallingRoutingPatchAllResponse as CallingRoutingPatchAllResponse,
+    type CallingRoutingPatchAllParams as CallingRoutingPatchAllParams,
+  };
 }

package/src/resources/whatsapp/signup.ts

@@ -0,0 +1,188 @@
+// 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 { DefaultFlatPagination, type DefaultFlatPaginationParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Signup extends APIResource {
+  /**
+   * List finished WhatsApp Embedded Signup sessions, with status `SUCCESS` or
+   * `FAILURE`, newest first. Use the `errors` of a failed session to see why
+   * provisioning stopped.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const signupListResponse of client.whatsapp.signup.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: SignupListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<SignupListResponsesDefaultFlatPagination, SignupListResponse> {
+    return this._client.getAPIList('/whatsapp/signup', DefaultFlatPagination<SignupListResponse>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Retrieve the current state and status of a WhatsApp Embedded Signup session.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.whatsapp.signup.retrieveStatus('id');
+   * ```
+   */
+  retrieveStatus(id: string, options?: RequestOptions): APIPromise<SignupRetrieveStatusResponse> {
+    return this._client.get(path`/whatsapp/signup/${id}/status`, options);
+  }
+}
+
+export type SignupListResponsesDefaultFlatPagination = DefaultFlatPagination<SignupListResponse>;
+
+export interface SignupListResponse {
+  created_at?: string;
+
+  /**
+   * Tech provider customer reference submitted with the signup
+   */
+  customer_id?: string;
+
+  /**
+   * Errors recorded during provisioning
+   */
+  errors?: Array<string>;
+
+  record_type?: 'whatsapp_session_id';
+
+  /**
+   * Signup session ID
+   */
+  session_id?: string;
+
+  /**
+   * Current provisioning step, or the step that failed. `REGISTER_PHONE_NUMBER` is
+   * skipped for coexistence signups.
+   */
+  state?:
+    | 'SUBSCRIBE_WEBHOOKS'
+    | 'ASSIGNED_USERS'
+    | 'SHARE_CREDIT_LINE'
+    | 'REGISTER_PHONE_NUMBER'
+    | 'ADD_WABA_TO_DB'
+    | 'ADD_PHONE_NUMBERS_TO_DB'
+    | 'COMPLETE';
+
+  /**
+   * `INCOMPLETE` waits for the Meta signup code, `PENDING` is in progress, `SUCCESS`
+   * finished provisioning, and `FAILURE` stopped at `state`.
+   */
+  status?: 'INCOMPLETE' | 'PENDING' | 'SUCCESS' | 'FAILURE';
+
+  updated_at?: string;
+
+  /**
+   * Telnyx user ID that owns the signup session
+   */
+  user_id?: string;
+
+  /**
+   * Meta WhatsApp Business Account ID
+   */
+  waba_id?: string;
+}
+
+export interface SignupRetrieveStatusResponse {
+  data?: SignupRetrieveStatusResponse.Data;
+}
+
+export namespace SignupRetrieveStatusResponse {
+  export interface Data {
+    created_at?: string;
+
+    /**
+     * Tech provider customer reference submitted with the signup
+     */
+    customer_id?: string;
+
+    /**
+     * Errors recorded during provisioning
+     */
+    errors?: Array<string>;
+
+    record_type?: 'whatsapp_session_id';
+
+    /**
+     * Signup session ID
+     */
+    session_id?: string;
+
+    /**
+     * Current provisioning step, or the step that failed. `REGISTER_PHONE_NUMBER` is
+     * skipped for coexistence signups.
+     */
+    state?:
+      | 'SUBSCRIBE_WEBHOOKS'
+      | 'ASSIGNED_USERS'
+      | 'SHARE_CREDIT_LINE'
+      | 'REGISTER_PHONE_NUMBER'
+      | 'ADD_WABA_TO_DB'
+      | 'ADD_PHONE_NUMBERS_TO_DB'
+      | 'COMPLETE';
+
+    /**
+     * `INCOMPLETE` waits for the Meta signup code, `PENDING` is in progress, `SUCCESS`
+     * finished provisioning, and `FAILURE` stopped at `state`.
+     */
+    status?: 'INCOMPLETE' | 'PENDING' | 'SUCCESS' | 'FAILURE';
+
+    updated_at?: string;
+
+    /**
+     * Telnyx user ID that owns the signup session
+     */
+    user_id?: string;
+
+    /**
+     * Meta WhatsApp Business Account ID
+     */
+    waba_id?: string;
+  }
+}
+
+export interface SignupListParams extends DefaultFlatPaginationParams {
+  /**
+   * Return sessions created at or after this time (RFC 3339)
+   */
+  'filter[created_at][gte]'?: string;
+
+  /**
+   * Return sessions created at or before this time (RFC 3339)
+   */
+  'filter[created_at][lte]'?: string;
+
+  /**
+   * Filter by the tech provider customer reference
+   */
+  'filter[customer_id]'?: string;
+
+  /**
+   * Filter by Meta WABA ID
+   */
+  'filter[waba_id]'?: string;
+}
+
+export declare namespace Signup {
+  export {
+    type SignupListResponse as SignupListResponse,
+    type SignupRetrieveStatusResponse as SignupRetrieveStatusResponse,
+    type SignupListResponsesDefaultFlatPagination as SignupListResponsesDefaultFlatPagination,
+    type SignupListParams as SignupListParams,
+  };
+}

package/src/resources/whatsapp/whatsapp.ts

@@ -1,6 +1,14 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as SignupAPI from './signup';
+import {
+  Signup,
+  SignupListParams,
+  SignupListResponse,
+  SignupListResponsesDefaultFlatPagination,
+  SignupRetrieveStatusResponse,
+} from './signup';
 import * as TemplatesAPI from './templates';
 import {
   TemplateCreateParams,
@@ -51,12 +59,14 @@ export class Whatsapp extends APIResource {
   templates: TemplatesAPI.Templates = new TemplatesAPI.Templates(this._client);
   phoneNumbers: PhoneNumbersAPI.PhoneNumbers = new PhoneNumbersAPI.PhoneNumbers(this._client);
   userData: UserDataAPI.UserData = new UserDataAPI.UserData(this._client);
+  signup: SignupAPI.Signup = new SignupAPI.Signup(this._client);
 }
 
 Whatsapp.BusinessAccounts = BusinessAccounts;
 Whatsapp.Templates = Templates;
 Whatsapp.PhoneNumbers = PhoneNumbers;
 Whatsapp.UserData = UserData;
+Whatsapp.Signup = Signup;
 
 export declare namespace Whatsapp {
   export {
@@ -100,4 +110,12 @@ export declare namespace Whatsapp {
     type UserDataUpdateResponse as UserDataUpdateResponse,
     type UserDataUpdateParams as UserDataUpdateParams,
   };
+
+  export {
+    Signup as Signup,
+    type SignupListResponse as SignupListResponse,
+    type SignupRetrieveStatusResponse as SignupRetrieveStatusResponse,
+    type SignupListResponsesDefaultFlatPagination as SignupListResponsesDefaultFlatPagination,
+    type SignupListParams as SignupListParams,
+  };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '7.24.0'; // x-release-please-version
+export const VERSION = '7.26.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.24.0";
+export declare const VERSION = "7.26.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.24.0'; // x-release-please-version
+exports.VERSION = '7.26.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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