telnyx 7.25.0 → 7.27.0

package/src/resources/webhooks.ts

@@ -6,6 +6,7 @@ import * as NumberOrdersAPI from './number-orders';
 import * as CallsAPI from './calls/calls';
 import * as MessagesAPI from './messages/messages';
 import * as ThreadsAPI from './email-inboxes/threads/threads';
+import * as NumbersAPI from './enterprises/reputation/numbers';
 import { EmailBracketCursorPagination } from '../core/pagination';
 import { unsafeUnwrapWebhook, unwrapWebhook } from '../lib/webhooks';
 
@@ -534,6 +535,16 @@ export namespace CallConversationEnded {
      */
     llm_model?: string;
 
+    /**
+     * The conversation transcript, in order. By default it contains only `user` and
+     * `assistant` text turns. When the assistant's
+     * `telephony_settings.conversation_ended_full_history` is `true`, it contains the
+     * full conversation history, including assistant tool calls, tool results, and
+     * `system` and `developer` entries. Redacted when data retention is disabled for
+     * the account.
+     */
+    messages?: Array<Payload.Message>;
+
     /**
      * Reason the conversation ended. For Conversation Relay, `customer_disconnect`
      * indicates that the customer WebSocket disconnected.
@@ -565,6 +576,73 @@ export namespace CallConversationEnded {
      */
     tts_voice_id?: string;
   }
+
+  export namespace Payload {
+    export interface Message {
+      /**
+       * The text of the message. For a tool result, the tool output. May be absent on an
+       * assistant message that only contains `tool_calls`.
+       */
+      content?: string;
+
+      /**
+       * The author of the message. `tool`, `system`, and `developer` only appear when
+       * `conversation_ended_full_history` is enabled. `system` and `developer` entries
+       * are informational (for example idle check-ins, voicemail prompts,
+       * participant-left notices, or messages added through the API); their wording is
+       * not a stable contract.
+       */
+      role?: 'user' | 'assistant' | 'tool' | 'system' | 'developer';
+
+      /**
+       * ISO 8601 datetime of when the message was added to the conversation.
+       */
+      timestamp?: string;
+
+      /**
+       * The `id` of the tool call this message answers. Only present on `tool` messages
+       * when `conversation_ended_full_history` is enabled.
+       */
+      tool_call_id?: string;
+
+      /**
+       * Tools the assistant called in this turn. Only present on `assistant` messages
+       * when `conversation_ended_full_history` is enabled.
+       */
+      tool_calls?: Array<Message.ToolCall>;
+    }
+
+    export namespace Message {
+      export interface ToolCall {
+        /**
+         * Identifier of the tool call, referenced by the matching tool result's
+         * `tool_call_id`.
+         */
+        id?: string;
+
+        function?: ToolCall.Function;
+
+        /**
+         * The type of tool call.
+         */
+        type?: 'function';
+      }
+
+      export namespace ToolCall {
+        export interface Function {
+          /**
+           * The arguments passed to the tool, as a JSON-encoded string.
+           */
+          arguments?: string;
+
+          /**
+           * The name of the tool that was called.
+           */
+          name?: string;
+        }
+      }
+    }
+  }
 }
 
 export interface CallConversationInsightsGenerated {
@@ -4842,6 +4920,262 @@ export namespace ArtifactFailedWebhookEvent {
   }
 }
 
+export interface CallAnalyzedWebhookEvent {
+  data?: CallAnalyzedWebhookEvent.Data;
+}
+
+export namespace CallAnalyzedWebhookEvent {
+  export interface Data {
+    /**
+     * Unique identifier for the event.
+     */
+    id?: string;
+
+    /**
+     * The type of event being delivered.
+     */
+    event_type?: 'call.analyzed';
+
+    /**
+     * ISO 8601 datetime of when the event occurred.
+     */
+    occurred_at?: string;
+
+    payload?: Data.Payload;
+
+    /**
+     * Identifies the type of the resource.
+     */
+    record_type?: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      /**
+       * Unique identifier of the assistant involved in the call.
+       */
+      assistant_id?: string;
+
+      /**
+       * Call ID used to issue commands via Call Control API.
+       */
+      call_control_id?: string;
+
+      /**
+       * ID that is unique to the call leg.
+       */
+      call_leg_id?: string;
+
+      /**
+       * ID that is unique to the call session (group of related call legs).
+       */
+      call_session_id?: string;
+
+      /**
+       * Base64-encoded state received from a command.
+       */
+      client_state?: string;
+
+      /**
+       * Call Control App ID (formerly Telnyx connection ID) used in the call.
+       */
+      connection_id?: string;
+
+      /**
+       * ID unique to the conversation generated for the call.
+       */
+      conversation_id?: string;
+
+      /**
+       * The conversation's generated insights, when insight generation was enabled for
+       * the assistant and has completed. Each entry carries a `status` and the generated
+       * `conversation_insights` results. An empty array when the conversation has no
+       * generated insights; null when insight data could not be retrieved.
+       */
+      conversation_insights?: Array<Payload.ConversationInsight> | null;
+
+      /**
+       * The session's cost breakdown from Session Analysis, covering every product
+       * billed on the call: the AI Voice Assistant engine minutes
+       * (`ai-voice-assistant`), LLM inference tokens (`inference`), and call-control,
+       * SIP trunking, and recording lines. If cost data could not be retrieved after
+       * retries, this field carries the placeholder string `No cost data available.`
+       * instead of an object.
+       */
+      cost?: Payload.UnionMember0 | string;
+
+      /**
+       * Duration of the conversation in seconds.
+       */
+      duration_sec?: number;
+
+      /**
+       * The caller's number or identifier.
+       */
+      from?: string;
+
+      /**
+       * The large language model used during the conversation.
+       */
+      llm_model?: string;
+
+      /**
+       * Reason the conversation ended.
+       */
+      reason?: string | null;
+
+      /**
+       * Recordings created for the call. An empty array when the call had no recordings;
+       * null when recording data could not be retrieved.
+       */
+      recordings?: Array<Payload.Recording> | null;
+
+      /**
+       * The speech-to-text model used in the conversation.
+       */
+      stt_model?: string;
+
+      /**
+       * The callee's number or SIP address.
+       */
+      to?: string;
+
+      /**
+       * The model ID used for text-to-speech synthesis.
+       */
+      tts_model_id?: string;
+
+      /**
+       * The text-to-speech provider used in the call.
+       */
+      tts_provider?: string;
+
+      /**
+       * Voice ID used for TTS.
+       */
+      tts_voice_id?: string;
+    }
+
+    export namespace Payload {
+      export interface ConversationInsight {
+        /**
+         * Generated insight results.
+         */
+        conversation_insights?: Array<ConversationInsight.ConversationInsight> | null;
+
+        /**
+         * Status of insight generation for this entry.
+         */
+        status?: string;
+      }
+
+      export namespace ConversationInsight {
+        export interface ConversationInsight {
+          /**
+           * Identifier of the insight template the result was generated from.
+           */
+          insight_id?: string;
+
+          /**
+           * The generated insight result.
+           */
+          result?: string;
+        }
+      }
+
+      /**
+       * The session's cost breakdown from Session Analysis, covering every product
+       * billed on the call: the AI Voice Assistant engine minutes
+       * (`ai-voice-assistant`), LLM inference tokens (`inference`), and call-control,
+       * SIP trunking, and recording lines. If cost data could not be retrieved after
+       * retries, this field carries the placeholder string `No cost data available.`
+       * instead of an object.
+       */
+      export interface UnionMember0 {
+        /**
+         * Cost lines grouped by product.
+         */
+        breakdown?: Array<UnionMember0.Breakdown>;
+
+        /**
+         * The currency of the cost amounts.
+         */
+        currency?: string;
+
+        /**
+         * The total cost of the call, summed across every product in the breakdown.
+         */
+        total?: string;
+      }
+
+      export namespace UnionMember0 {
+        export interface Breakdown {
+          /**
+           * Total cost for this product across the call, in the currency given by
+           * `cost.currency`.
+           */
+          cost?: string;
+
+          /**
+           * The Telnyx product the cost line belongs to (for example `ai-voice-assistant`,
+           * `inference`, `callcontrol-cdrs`, `siptrunking-cdrs`, `recording-cdrs`).
+           */
+          product?: string;
+        }
+      }
+
+      export interface Recording {
+        /**
+         * Unique identifier of the recording.
+         */
+        id?: string;
+
+        /**
+         * The recording channel configuration.
+         */
+        channels?: string;
+
+        /**
+         * Download URL per format. URLs are pre-signed and expire.
+         */
+        download_urls?: Recording.DownloadURLs;
+
+        /**
+         * ISO 8601 datetime of when the recording ended.
+         */
+        end_time?: string;
+
+        /**
+         * The recording file format.
+         */
+        format?: string;
+
+        /**
+         * ISO 8601 datetime of when the recording started.
+         */
+        start_time?: string;
+      }
+
+      export namespace Recording {
+        /**
+         * Download URL per format. URLs are pre-signed and expire.
+         */
+        export interface DownloadURLs {
+          /**
+           * Pre-signed URL for the mp3 recording file.
+           */
+          mp3?: string;
+
+          /**
+           * Pre-signed URL for the wav recording file.
+           */
+          wav?: string;
+        }
+      }
+    }
+  }
+}
+
 export interface CallAnsweredWebhookEvent {
   data?: CallAnswered;
 }
@@ -4950,21 +5284,36 @@ export interface CallConversationInsightsGeneratedWebhookEvent {
   data?: CallConversationInsightsGenerated;
 }
 
-export interface CallCostWebhookEvent {
-  data?: CallCostWebhookEvent.Data;
+export interface CallConversationStartFailedWebhookEvent {
+  /**
+   * The AI assistant requested for the call could not be started, so no conversation
+   * was created. No `call.conversation.created` or `call.conversation.ended` is sent
+   * for this attempt.
+   */
+  data?: CallConversationStartFailedWebhookEvent.Data;
 }
 
-export namespace CallCostWebhookEvent {
+export namespace CallConversationStartFailedWebhookEvent {
+  /**
+   * The AI assistant requested for the call could not be started, so no conversation
+   * was created. No `call.conversation.created` or `call.conversation.ended` is sent
+   * for this attempt.
+   */
   export interface Data {
     /**
-     * Unique identifier of the event.
+     * Unique identifier for the event.
      */
     id?: string;
 
+    /**
+     * Timestamp when the event was created in the system.
+     */
+    created_at?: string;
+
     /**
      * The type of event being delivered.
      */
-    event_type?: 'call.cost';
+    event_type?: 'call.conversation.start_failed';
 
     /**
      * ISO 8601 datetime of when the event occurred.
@@ -4982,14 +5331,9 @@ export namespace CallCostWebhookEvent {
   export namespace Data {
     export interface Payload {
       /**
-       * The longest billed duration across all cost parts, in seconds.
-       */
-      billed_duration_secs?: number | null;
-
-      /**
-       * Identifies the billing group associated with the call.
+       * Identifier of the AI assistant that failed to start.
        */
-      billing_group_id?: string | null;
+      assistant_id?: string;
 
       /**
        * Call ID used to issue commands via Call Control API.
@@ -4997,19 +5341,22 @@ export namespace CallCostWebhookEvent {
       call_control_id?: string;
 
       /**
-       * ID that is unique to the call and can be used to correlate webhook events.
+       * ID that is unique to the call leg.
        */
       call_leg_id?: string;
 
       /**
-       * 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.
+       * ID that is unique to the call session (group of related call legs).
        */
       call_session_id?: string;
 
       /**
-       * State received from a command. Base64-encoded.
+       * The type of calling party connection.
+       */
+      calling_party_type?: 'pstn' | 'sip';
+
+      /**
+       * Base64-encoded state received from a command.
        */
       client_state?: string;
 
@@ -5019,21 +5366,110 @@ export namespace CallCostWebhookEvent {
       connection_id?: string;
 
       /**
-       * Breakdown of costs by call part.
+       * The caller's number or identifier.
        */
-      cost_parts?: Array<Payload.CostPart>;
+      from?: string;
 
       /**
-       * ISO 8601 datetime of when the event occurred.
+       * Why the conversation could not be started. `invalid_request`: the assistant
+       * request was rejected, for example because the assistant ID does not exist.
+       * `service_error`: the assistant could not be started because of an error on the
+       * Telnyx side.
        */
-      occurred_at?: string;
+      reason?: 'invalid_request' | 'service_error';
 
       /**
-       * The status of the cost calculation (`success` or `error`).
+       * The callee's number or SIP address.
        */
-      status?: 'success' | 'error';
-
-      /**
+      to?: string;
+    }
+  }
+}
+
+export interface CallCostWebhookEvent {
+  data?: CallCostWebhookEvent.Data;
+}
+
+export namespace CallCostWebhookEvent {
+  export interface Data {
+    /**
+     * Unique identifier of the event.
+     */
+    id?: string;
+
+    /**
+     * The type of event being delivered.
+     */
+    event_type?: 'call.cost';
+
+    /**
+     * ISO 8601 datetime of when the event occurred.
+     */
+    occurred_at?: string;
+
+    payload?: Data.Payload;
+
+    /**
+     * Identifies the type of the resource.
+     */
+    record_type?: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      /**
+       * The longest billed duration across all cost parts, in seconds.
+       */
+      billed_duration_secs?: number | null;
+
+      /**
+       * Identifies the billing group associated with the call.
+       */
+      billing_group_id?: string | null;
+
+      /**
+       * Call ID used to issue commands via Call Control API.
+       */
+      call_control_id?: string;
+
+      /**
+       * ID that is unique to the call and can be used to correlate webhook events.
+       */
+      call_leg_id?: string;
+
+      /**
+       * 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.
+       */
+      call_session_id?: string;
+
+      /**
+       * State received from a command. Base64-encoded.
+       */
+      client_state?: string;
+
+      /**
+       * Call Control App ID (formerly Telnyx connection ID) used in the call.
+       */
+      connection_id?: string;
+
+      /**
+       * Breakdown of costs by call part.
+       */
+      cost_parts?: Array<Payload.CostPart>;
+
+      /**
+       * ISO 8601 datetime of when the event occurred.
+       */
+      occurred_at?: string;
+
+      /**
+       * The status of the cost calculation (`success` or `error`).
+       */
+      status?: 'success' | 'error';
+
+      /**
        * The total cost of the call.
        */
       total_cost?: string | null;
@@ -6344,47 +6780,174 @@ export namespace NumberOrderStatusUpdateWebhookEvent {
   }
 }
 
-export interface RecordingAvailableWebhookEvent {
-  /**
-   * Unique event id; deduplicate deliveries on it.
-   */
-  id: string;
+export interface NumberReputationExternalVerificationStatusChangedWebhookEvent {
+  data: NumberReputationExternalVerificationStatusChangedWebhookEvent.Data;
 
-  /**
-   * Available recording types.
-   */
-  data: RecordingAvailableWebhookEvent.Data;
+  meta: NumberReputationExternalVerificationStatusChangedWebhookEvent.Meta;
+}
 
-  /**
-   * Event type.
-   */
-  event: 'recording.available';
+export namespace NumberReputationExternalVerificationStatusChangedWebhookEvent {
+  export interface Data {
+    /**
+     * Identifies the event; the same id is reused if the event is redelivered.
+     */
+    id: string;
 
-  /**
-   * When the event occurred.
-   */
-  occurred_at: string;
+    event_type: 'number_reputation.external_verification.status_changed';
 
-  /**
-   * Envelope version.
-   */
-  version: string;
+    occurred_at: string;
+
+    payload: Data.Payload;
+
+    record_type: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      enterprise_id: string;
+
+      record_type: 'reputation_external_verification';
+
+      /**
+       * When the review decision was made. Always set: this event is only sent after a
+       * review.
+       */
+      reviewed_at: string;
+
+      /**
+       * The review outcome. `pending` is never delivered: the event is sent only once
+       * the proof is reviewed.
+       */
+      status: 'approved' | 'rejected';
+
+      /**
+       * Set only when `status` is `rejected`.
+       */
+      rejection_reason?: string | null;
+    }
+  }
+
+  export interface Meta {
+    attempt: number;
+
+    delivered_to: string;
+  }
 }
 
-export namespace RecordingAvailableWebhookEvent {
-  /**
-   * Available recording types.
-   */
+export interface NumberReputationNumberFlaggedWebhookEvent {
+  data: NumberReputationNumberFlaggedWebhookEvent.Data;
+
+  meta: NumberReputationNumberFlaggedWebhookEvent.Meta;
+}
+
+export namespace NumberReputationNumberFlaggedWebhookEvent {
   export interface Data {
     /**
-     * Available recording types.
+     * Identifies the event; the same id is reused if the event is redelivered.
      */
-    recording_types: Array<string>;
+    id: string;
+
+    event_type: 'number_reputation.number.flagged';
+
+    occurred_at: string;
+
+    payload: Data.Payload;
 
+    record_type: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      /**
+       * Confirm ownership before this time or the number is removed (carrier change) or
+       * flagged (re-verification).
+       */
+      confirm_by: string;
+
+      enterprise_id: string;
+
+      /**
+       * `carrier_changed`: the number moved to a different carrier.
+       * `reverification_due`: the periodic ownership re-verification is due.
+       */
+      flag_reason: 'carrier_changed' | 'reverification_due';
+
+      ownership_status: 'pending_confirmation';
+
+      phone_number: string;
+
+      record_type: 'reputation_phone_number';
+
+      /**
+       * Where the phone number is hosted. `telnyx`: in your Telnyx inventory.
+       * `external`: a number you own that is hosted with another provider.
+       */
+      source: NumbersAPI.ReputationNumberSource;
+    }
+  }
+
+  export interface Meta {
+    attempt: number;
+
+    delivered_to: string;
+  }
+}
+
+export interface NumberReputationNumberRemovedWebhookEvent {
+  data: NumberReputationNumberRemovedWebhookEvent.Data;
+
+  meta: NumberReputationNumberRemovedWebhookEvent.Meta;
+}
+
+export namespace NumberReputationNumberRemovedWebhookEvent {
+  export interface Data {
     /**
-     * The meeting session this event belongs to.
+     * Identifies the event; the same id is reused if the event is redelivered.
      */
-    session_id: string;
+    id: string;
+
+    event_type: 'number_reputation.number.removed';
+
+    occurred_at: string;
+
+    payload: Data.Payload;
+
+    record_type: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      enterprise_id: string;
+
+      ownership_status: 'removed';
+
+      phone_number: string;
+
+      record_type: 'reputation_phone_number';
+
+      /**
+       * `ported_away`: you confirmed you no longer own it after a carrier change.
+       * `unconfirmed_ownership`: the confirmation deadline passed. `reassigned`: the
+       * number was reported as permanently disconnected. `customer_reported`: you
+       * reported that you no longer own it. Removing a number yourself with `DELETE`
+       * sends no event.
+       */
+      removal_reason: 'ported_away' | 'unconfirmed_ownership' | 'reassigned' | 'customer_reported';
+
+      removed_at: string;
+
+      /**
+       * Where the phone number is hosted. `telnyx`: in your Telnyx inventory.
+       * `external`: a number you own that is hosted with another provider.
+       */
+      source: NumbersAPI.ReputationNumberSource;
+    }
+  }
+
+  export interface Meta {
+    attempt: number;
+
+    delivered_to: string;
   }
 }
 
@@ -6440,8 +7003,7 @@ export namespace SessionStatusChangedWebhookEvent {
     status: string;
 
     /**
-     * Additional detail about the status (for example `timeout_exceeded_everyone_left`
-     * or `cancelled`), or null.
+     * Additional detail about the status (for example `cancelled`), or null.
      */
     status_detail: string | null;
   }
@@ -6505,6 +7067,56 @@ export interface TranscriptionWebhookEvent {
   data?: Transcription;
 }
 
+export interface WhatsappWabaAddedWebhookEvent {
+  data: WhatsappWabaAddedWebhookEvent.Data;
+}
+
+export namespace WhatsappWabaAddedWebhookEvent {
+  export interface Data {
+    id: string;
+
+    event_type: 'whatsapp.waba_added';
+
+    occurred_at: string;
+
+    payload: Data.Payload;
+
+    record_type: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      /**
+       * Signup session ID.
+       */
+      event_id: string;
+
+      record_type: 'waba_account_added';
+
+      /**
+       * Signup session outcome.
+       */
+      status: 'SUCCESS' | 'FAILURE';
+
+      /**
+       * Meta WhatsApp Business Account identifier.
+       */
+      waba_id: string;
+
+      /**
+       * Errors recorded during provisioning.
+       */
+      errors?: Array<string>;
+
+      /**
+       * Phone numbers found on the WABA. Omitted for standard sessions started with a
+       * phone_number_id, and for sessions that fail before Telnyx fetches the numbers.
+       */
+      phone_numbers?: Array<string>;
+    }
+  }
+}
+
 export interface CallAIGatherEndedWebhookEvent {
   data?: CallAIGatherEnded;
 }
@@ -6645,10 +7257,266 @@ export namespace ArtifactFailedWebhookEvent {
      */
     session_id: string;
 
-    /**
-     * Type of the failed artifact.
-     */
-    type: 'summary' | 'action_items' | 'decisions' | 'topics' | 'open_questions' | 'custom';
+    /**
+     * Type of the failed artifact.
+     */
+    type: 'summary' | 'action_items' | 'decisions' | 'topics' | 'open_questions' | 'custom';
+  }
+}
+
+export interface CallAnalyzedWebhookEvent {
+  data?: CallAnalyzedWebhookEvent.Data;
+}
+
+export namespace CallAnalyzedWebhookEvent {
+  export interface Data {
+    /**
+     * Unique identifier for the event.
+     */
+    id?: string;
+
+    /**
+     * The type of event being delivered.
+     */
+    event_type?: 'call.analyzed';
+
+    /**
+     * ISO 8601 datetime of when the event occurred.
+     */
+    occurred_at?: string;
+
+    payload?: Data.Payload;
+
+    /**
+     * Identifies the type of the resource.
+     */
+    record_type?: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      /**
+       * Unique identifier of the assistant involved in the call.
+       */
+      assistant_id?: string;
+
+      /**
+       * Call ID used to issue commands via Call Control API.
+       */
+      call_control_id?: string;
+
+      /**
+       * ID that is unique to the call leg.
+       */
+      call_leg_id?: string;
+
+      /**
+       * ID that is unique to the call session (group of related call legs).
+       */
+      call_session_id?: string;
+
+      /**
+       * Base64-encoded state received from a command.
+       */
+      client_state?: string;
+
+      /**
+       * Call Control App ID (formerly Telnyx connection ID) used in the call.
+       */
+      connection_id?: string;
+
+      /**
+       * ID unique to the conversation generated for the call.
+       */
+      conversation_id?: string;
+
+      /**
+       * The conversation's generated insights, when insight generation was enabled for
+       * the assistant and has completed. Each entry carries a `status` and the generated
+       * `conversation_insights` results. An empty array when the conversation has no
+       * generated insights; null when insight data could not be retrieved.
+       */
+      conversation_insights?: Array<Payload.ConversationInsight> | null;
+
+      /**
+       * The session's cost breakdown from Session Analysis, covering every product
+       * billed on the call: the AI Voice Assistant engine minutes
+       * (`ai-voice-assistant`), LLM inference tokens (`inference`), and call-control,
+       * SIP trunking, and recording lines. If cost data could not be retrieved after
+       * retries, this field carries the placeholder string `No cost data available.`
+       * instead of an object.
+       */
+      cost?: Payload.UnionMember0 | string;
+
+      /**
+       * Duration of the conversation in seconds.
+       */
+      duration_sec?: number;
+
+      /**
+       * The caller's number or identifier.
+       */
+      from?: string;
+
+      /**
+       * The large language model used during the conversation.
+       */
+      llm_model?: string;
+
+      /**
+       * Reason the conversation ended.
+       */
+      reason?: string | null;
+
+      /**
+       * Recordings created for the call. An empty array when the call had no recordings;
+       * null when recording data could not be retrieved.
+       */
+      recordings?: Array<Payload.Recording> | null;
+
+      /**
+       * The speech-to-text model used in the conversation.
+       */
+      stt_model?: string;
+
+      /**
+       * The callee's number or SIP address.
+       */
+      to?: string;
+
+      /**
+       * The model ID used for text-to-speech synthesis.
+       */
+      tts_model_id?: string;
+
+      /**
+       * The text-to-speech provider used in the call.
+       */
+      tts_provider?: string;
+
+      /**
+       * Voice ID used for TTS.
+       */
+      tts_voice_id?: string;
+    }
+
+    export namespace Payload {
+      export interface ConversationInsight {
+        /**
+         * Generated insight results.
+         */
+        conversation_insights?: Array<ConversationInsight.ConversationInsight> | null;
+
+        /**
+         * Status of insight generation for this entry.
+         */
+        status?: string;
+      }
+
+      export namespace ConversationInsight {
+        export interface ConversationInsight {
+          /**
+           * Identifier of the insight template the result was generated from.
+           */
+          insight_id?: string;
+
+          /**
+           * The generated insight result.
+           */
+          result?: string;
+        }
+      }
+
+      /**
+       * The session's cost breakdown from Session Analysis, covering every product
+       * billed on the call: the AI Voice Assistant engine minutes
+       * (`ai-voice-assistant`), LLM inference tokens (`inference`), and call-control,
+       * SIP trunking, and recording lines. If cost data could not be retrieved after
+       * retries, this field carries the placeholder string `No cost data available.`
+       * instead of an object.
+       */
+      export interface UnionMember0 {
+        /**
+         * Cost lines grouped by product.
+         */
+        breakdown?: Array<UnionMember0.Breakdown>;
+
+        /**
+         * The currency of the cost amounts.
+         */
+        currency?: string;
+
+        /**
+         * The total cost of the call, summed across every product in the breakdown.
+         */
+        total?: string;
+      }
+
+      export namespace UnionMember0 {
+        export interface Breakdown {
+          /**
+           * Total cost for this product across the call, in the currency given by
+           * `cost.currency`.
+           */
+          cost?: string;
+
+          /**
+           * The Telnyx product the cost line belongs to (for example `ai-voice-assistant`,
+           * `inference`, `callcontrol-cdrs`, `siptrunking-cdrs`, `recording-cdrs`).
+           */
+          product?: string;
+        }
+      }
+
+      export interface Recording {
+        /**
+         * Unique identifier of the recording.
+         */
+        id?: string;
+
+        /**
+         * The recording channel configuration.
+         */
+        channels?: string;
+
+        /**
+         * Download URL per format. URLs are pre-signed and expire.
+         */
+        download_urls?: Recording.DownloadURLs;
+
+        /**
+         * ISO 8601 datetime of when the recording ended.
+         */
+        end_time?: string;
+
+        /**
+         * The recording file format.
+         */
+        format?: string;
+
+        /**
+         * ISO 8601 datetime of when the recording started.
+         */
+        start_time?: string;
+      }
+
+      export namespace Recording {
+        /**
+         * Download URL per format. URLs are pre-signed and expire.
+         */
+        export interface DownloadURLs {
+          /**
+           * Pre-signed URL for the mp3 recording file.
+           */
+          mp3?: string;
+
+          /**
+           * Pre-signed URL for the wav recording file.
+           */
+          wav?: string;
+        }
+      }
+    }
   }
 }
 
@@ -6760,6 +7628,108 @@ export interface CallConversationInsightsGeneratedWebhookEvent {
   data?: CallConversationInsightsGenerated;
 }
 
+export interface CallConversationStartFailedWebhookEvent {
+  /**
+   * The AI assistant requested for the call could not be started, so no conversation
+   * was created. No `call.conversation.created` or `call.conversation.ended` is sent
+   * for this attempt.
+   */
+  data?: CallConversationStartFailedWebhookEvent.Data;
+}
+
+export namespace CallConversationStartFailedWebhookEvent {
+  /**
+   * The AI assistant requested for the call could not be started, so no conversation
+   * was created. No `call.conversation.created` or `call.conversation.ended` is sent
+   * for this attempt.
+   */
+  export interface Data {
+    /**
+     * Unique identifier for the event.
+     */
+    id?: string;
+
+    /**
+     * Timestamp when the event was created in the system.
+     */
+    created_at?: string;
+
+    /**
+     * The type of event being delivered.
+     */
+    event_type?: 'call.conversation.start_failed';
+
+    /**
+     * ISO 8601 datetime of when the event occurred.
+     */
+    occurred_at?: string;
+
+    payload?: Data.Payload;
+
+    /**
+     * Identifies the type of the resource.
+     */
+    record_type?: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      /**
+       * Identifier of the AI assistant that failed to start.
+       */
+      assistant_id?: string;
+
+      /**
+       * Call ID used to issue commands via Call Control API.
+       */
+      call_control_id?: string;
+
+      /**
+       * ID that is unique to the call leg.
+       */
+      call_leg_id?: string;
+
+      /**
+       * ID that is unique to the call session (group of related call legs).
+       */
+      call_session_id?: string;
+
+      /**
+       * The type of calling party connection.
+       */
+      calling_party_type?: 'pstn' | 'sip';
+
+      /**
+       * Base64-encoded state received from a command.
+       */
+      client_state?: string;
+
+      /**
+       * Call Control App ID (formerly Telnyx connection ID) used in the call.
+       */
+      connection_id?: string;
+
+      /**
+       * The caller's number or identifier.
+       */
+      from?: string;
+
+      /**
+       * Why the conversation could not be started. `invalid_request`: the assistant
+       * request was rejected, for example because the assistant ID does not exist.
+       * `service_error`: the assistant could not be started because of an error on the
+       * Telnyx side.
+       */
+      reason?: 'invalid_request' | 'service_error';
+
+      /**
+       * The callee's number or SIP address.
+       */
+      to?: string;
+    }
+  }
+}
+
 export interface CallCostWebhookEvent {
   data?: CallCostWebhookEvent.Data;
 }
@@ -8154,47 +9124,174 @@ export namespace NumberOrderStatusUpdateWebhookEvent {
   }
 }
 
-export interface RecordingAvailableWebhookEvent {
-  /**
-   * Unique event id; deduplicate deliveries on it.
-   */
-  id: string;
+export interface NumberReputationExternalVerificationStatusChangedWebhookEvent {
+  data: NumberReputationExternalVerificationStatusChangedWebhookEvent.Data;
 
-  /**
-   * Available recording types.
-   */
-  data: RecordingAvailableWebhookEvent.Data;
+  meta: NumberReputationExternalVerificationStatusChangedWebhookEvent.Meta;
+}
 
-  /**
-   * Event type.
-   */
-  event: 'recording.available';
+export namespace NumberReputationExternalVerificationStatusChangedWebhookEvent {
+  export interface Data {
+    /**
+     * Identifies the event; the same id is reused if the event is redelivered.
+     */
+    id: string;
 
-  /**
-   * When the event occurred.
-   */
-  occurred_at: string;
+    event_type: 'number_reputation.external_verification.status_changed';
 
-  /**
-   * Envelope version.
-   */
-  version: string;
+    occurred_at: string;
+
+    payload: Data.Payload;
+
+    record_type: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      enterprise_id: string;
+
+      record_type: 'reputation_external_verification';
+
+      /**
+       * When the review decision was made. Always set: this event is only sent after a
+       * review.
+       */
+      reviewed_at: string;
+
+      /**
+       * The review outcome. `pending` is never delivered: the event is sent only once
+       * the proof is reviewed.
+       */
+      status: 'approved' | 'rejected';
+
+      /**
+       * Set only when `status` is `rejected`.
+       */
+      rejection_reason?: string | null;
+    }
+  }
+
+  export interface Meta {
+    attempt: number;
+
+    delivered_to: string;
+  }
 }
 
-export namespace RecordingAvailableWebhookEvent {
-  /**
-   * Available recording types.
-   */
+export interface NumberReputationNumberFlaggedWebhookEvent {
+  data: NumberReputationNumberFlaggedWebhookEvent.Data;
+
+  meta: NumberReputationNumberFlaggedWebhookEvent.Meta;
+}
+
+export namespace NumberReputationNumberFlaggedWebhookEvent {
   export interface Data {
     /**
-     * Available recording types.
+     * Identifies the event; the same id is reused if the event is redelivered.
      */
-    recording_types: Array<string>;
+    id: string;
+
+    event_type: 'number_reputation.number.flagged';
+
+    occurred_at: string;
+
+    payload: Data.Payload;
+
+    record_type: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      /**
+       * Confirm ownership before this time or the number is removed (carrier change) or
+       * flagged (re-verification).
+       */
+      confirm_by: string;
+
+      enterprise_id: string;
+
+      /**
+       * `carrier_changed`: the number moved to a different carrier.
+       * `reverification_due`: the periodic ownership re-verification is due.
+       */
+      flag_reason: 'carrier_changed' | 'reverification_due';
+
+      ownership_status: 'pending_confirmation';
+
+      phone_number: string;
+
+      record_type: 'reputation_phone_number';
+
+      /**
+       * Where the phone number is hosted. `telnyx`: in your Telnyx inventory.
+       * `external`: a number you own that is hosted with another provider.
+       */
+      source: NumbersAPI.ReputationNumberSource;
+    }
+  }
+
+  export interface Meta {
+    attempt: number;
+
+    delivered_to: string;
+  }
+}
+
+export interface NumberReputationNumberRemovedWebhookEvent {
+  data: NumberReputationNumberRemovedWebhookEvent.Data;
+
+  meta: NumberReputationNumberRemovedWebhookEvent.Meta;
+}
 
+export namespace NumberReputationNumberRemovedWebhookEvent {
+  export interface Data {
     /**
-     * The meeting session this event belongs to.
+     * Identifies the event; the same id is reused if the event is redelivered.
      */
-    session_id: string;
+    id: string;
+
+    event_type: 'number_reputation.number.removed';
+
+    occurred_at: string;
+
+    payload: Data.Payload;
+
+    record_type: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      enterprise_id: string;
+
+      ownership_status: 'removed';
+
+      phone_number: string;
+
+      record_type: 'reputation_phone_number';
+
+      /**
+       * `ported_away`: you confirmed you no longer own it after a carrier change.
+       * `unconfirmed_ownership`: the confirmation deadline passed. `reassigned`: the
+       * number was reported as permanently disconnected. `customer_reported`: you
+       * reported that you no longer own it. Removing a number yourself with `DELETE`
+       * sends no event.
+       */
+      removal_reason: 'ported_away' | 'unconfirmed_ownership' | 'reassigned' | 'customer_reported';
+
+      removed_at: string;
+
+      /**
+       * Where the phone number is hosted. `telnyx`: in your Telnyx inventory.
+       * `external`: a number you own that is hosted with another provider.
+       */
+      source: NumbersAPI.ReputationNumberSource;
+    }
+  }
+
+  export interface Meta {
+    attempt: number;
+
+    delivered_to: string;
   }
 }
 
@@ -8250,8 +9347,7 @@ export namespace SessionStatusChangedWebhookEvent {
     status: string;
 
     /**
-     * Additional detail about the status (for example `timeout_exceeded_everyone_left`
-     * or `cancelled`), or null.
+     * Additional detail about the status (for example `cancelled`), or null.
      */
     status_detail: string | null;
   }
@@ -8315,17 +9411,69 @@ export interface TranscriptionWebhookEvent {
   data?: Transcription;
 }
 
+export interface WhatsappWabaAddedWebhookEvent {
+  data: WhatsappWabaAddedWebhookEvent.Data;
+}
+
+export namespace WhatsappWabaAddedWebhookEvent {
+  export interface Data {
+    id: string;
+
+    event_type: 'whatsapp.waba_added';
+
+    occurred_at: string;
+
+    payload: Data.Payload;
+
+    record_type: 'event';
+  }
+
+  export namespace Data {
+    export interface Payload {
+      /**
+       * Signup session ID.
+       */
+      event_id: string;
+
+      record_type: 'waba_account_added';
+
+      /**
+       * Signup session outcome.
+       */
+      status: 'SUCCESS' | 'FAILURE';
+
+      /**
+       * Meta WhatsApp Business Account identifier.
+       */
+      waba_id: string;
+
+      /**
+       * Errors recorded during provisioning.
+       */
+      errors?: Array<string>;
+
+      /**
+       * Phone numbers found on the WABA. Omitted for standard sessions started with a
+       * phone_number_id, and for sessions that fail before Telnyx fetches the numbers.
+       */
+      phone_numbers?: Array<string>;
+    }
+  }
+}
+
 export type UnsafeUnwrapWebhookEvent =
   | CallAIGatherEndedWebhookEvent
   | CallAIGatherMessageHistoryUpdatedWebhookEvent
   | CallAIGatherPartialResultsWebhookEvent
   | ArtifactCompletedWebhookEvent
   | ArtifactFailedWebhookEvent
+  | CallAnalyzedWebhookEvent
   | CallAnsweredWebhookEvent
   | CallBridgedWebhookEvent
   | CallConversationCreatedWebhookEvent
   | CallConversationEndedWebhookEvent
   | CallConversationInsightsGeneratedWebhookEvent
+  | CallConversationStartFailedWebhookEvent
   | CallCostWebhookEvent
   | CallDeepfakeDetectionErrorWebhookEvent
   | CallDeepfakeDetectionResultWebhookEvent
@@ -8387,13 +9535,16 @@ export type UnsafeUnwrapWebhookEvent =
   | HostedNumberOrderEventWebhookEvent
   | InboundMessageWebhookEvent
   | NumberOrderStatusUpdateWebhookEvent
-  | RecordingAvailableWebhookEvent
+  | NumberReputationExternalVerificationStatusChangedWebhookEvent
+  | NumberReputationNumberFlaggedWebhookEvent
+  | NumberReputationNumberRemovedWebhookEvent
   | ReplacedLinkClickWebhookEvent
   | SessionStatusChangedWebhookEvent
   | TranscriptCompletedWebhookEvent
   | TranscriptionWebhookEvent
   | WhatsappAccountUpdate
-  | WhatsappMessageEcho;
+  | WhatsappMessageEcho
+  | WhatsappWabaAddedWebhookEvent;
 
 export type UnwrapWebhookEvent =
   | CallAIGatherEndedWebhookEvent
@@ -8401,11 +9552,13 @@ export type UnwrapWebhookEvent =
   | CallAIGatherPartialResultsWebhookEvent
   | ArtifactCompletedWebhookEvent
   | ArtifactFailedWebhookEvent
+  | CallAnalyzedWebhookEvent
   | CallAnsweredWebhookEvent
   | CallBridgedWebhookEvent
   | CallConversationCreatedWebhookEvent
   | CallConversationEndedWebhookEvent
   | CallConversationInsightsGeneratedWebhookEvent
+  | CallConversationStartFailedWebhookEvent
   | CallCostWebhookEvent
   | CallDeepfakeDetectionErrorWebhookEvent
   | CallDeepfakeDetectionResultWebhookEvent
@@ -8467,13 +9620,16 @@ export type UnwrapWebhookEvent =
   | HostedNumberOrderEventWebhookEvent
   | InboundMessageWebhookEvent
   | NumberOrderStatusUpdateWebhookEvent
-  | RecordingAvailableWebhookEvent
+  | NumberReputationExternalVerificationStatusChangedWebhookEvent
+  | NumberReputationNumberFlaggedWebhookEvent
+  | NumberReputationNumberRemovedWebhookEvent
   | ReplacedLinkClickWebhookEvent
   | SessionStatusChangedWebhookEvent
   | TranscriptCompletedWebhookEvent
   | TranscriptionWebhookEvent
   | WhatsappAccountUpdate
-  | WhatsappMessageEcho;
+  | WhatsappMessageEcho
+  | WhatsappWabaAddedWebhookEvent;
 
 export declare namespace Webhooks {
   export {
@@ -8546,11 +9702,13 @@ export declare namespace Webhooks {
     type CallAIGatherPartialResultsWebhookEvent as CallAIGatherPartialResultsWebhookEvent,
     type ArtifactCompletedWebhookEvent as ArtifactCompletedWebhookEvent,
     type ArtifactFailedWebhookEvent as ArtifactFailedWebhookEvent,
+    type CallAnalyzedWebhookEvent as CallAnalyzedWebhookEvent,
     type CallAnsweredWebhookEvent as CallAnsweredWebhookEvent,
     type CallBridgedWebhookEvent as CallBridgedWebhookEvent,
     type CallConversationCreatedWebhookEvent as CallConversationCreatedWebhookEvent,
     type CallConversationEndedWebhookEvent as CallConversationEndedWebhookEvent,
     type CallConversationInsightsGeneratedWebhookEvent as CallConversationInsightsGeneratedWebhookEvent,
+    type CallConversationStartFailedWebhookEvent as CallConversationStartFailedWebhookEvent,
     type CallCostWebhookEvent as CallCostWebhookEvent,
     type CallDeepfakeDetectionErrorWebhookEvent as CallDeepfakeDetectionErrorWebhookEvent,
     type CallDeepfakeDetectionResultWebhookEvent as CallDeepfakeDetectionResultWebhookEvent,
@@ -8605,11 +9763,14 @@ export declare namespace Webhooks {
     type HostedNumberOrderEventWebhookEvent as HostedNumberOrderEventWebhookEvent,
     type InboundMessageWebhookEvent as InboundMessageWebhookEvent,
     type NumberOrderStatusUpdateWebhookEvent as NumberOrderStatusUpdateWebhookEvent,
-    type RecordingAvailableWebhookEvent as RecordingAvailableWebhookEvent,
+    type NumberReputationExternalVerificationStatusChangedWebhookEvent as NumberReputationExternalVerificationStatusChangedWebhookEvent,
+    type NumberReputationNumberFlaggedWebhookEvent as NumberReputationNumberFlaggedWebhookEvent,
+    type NumberReputationNumberRemovedWebhookEvent as NumberReputationNumberRemovedWebhookEvent,
     type ReplacedLinkClickWebhookEvent as ReplacedLinkClickWebhookEvent,
     type SessionStatusChangedWebhookEvent as SessionStatusChangedWebhookEvent,
     type TranscriptCompletedWebhookEvent as TranscriptCompletedWebhookEvent,
     type TranscriptionWebhookEvent as TranscriptionWebhookEvent,
+    type WhatsappWabaAddedWebhookEvent as WhatsappWabaAddedWebhookEvent,
     type UnsafeUnwrapWebhookEvent as UnsafeUnwrapWebhookEvent,
     type UnwrapWebhookEvent as UnwrapWebhookEvent,
   };