@linqapp/sdk 0.38.0 → 0.39.0

package/resources/webhooks.d.mts

@@ -107,9 +107,10 @@ export declare namespace MessageEventV2 {
          * `AT_RISK` or `CRITICAL` chats on a single line increase the risk of line
          * flagging.
          *
-         * Switch on `status` to gate sends or surface line health in your UI — the enum is
-         * the long-term contract. Each status carries a `doc_url` that deep-links to the
-         * relevant section of the Chat Health guide.
+         * Switch on `status` to surface chat and line health in your UI — the enum is the
+         * long-term contract. Each status carries a `doc_url` that deep-links to the
+         * relevant section of the Chat Health guide. To gate a send, act on the response
+         * rather than the status: a `403` is the authoritative answer.
          *
          * See the [Chat Health guide](/guides/chats/chat-health) for what each status
          * means and how to react.
@@ -131,9 +132,10 @@ export declare namespace MessageEventV2 {
          * `AT_RISK` or `CRITICAL` chats on a single line increase the risk of line
          * flagging.
          *
-         * Switch on `status` to gate sends or surface line health in your UI — the enum is
-         * the long-term contract. Each status carries a `doc_url` that deep-links to the
-         * relevant section of the Chat Health guide.
+         * Switch on `status` to surface chat and line health in your UI — the enum is the
+         * long-term contract. Each status carries a `doc_url` that deep-links to the
+         * relevant section of the Chat Health guide. To gate a send, act on the response
+         * rather than the status: a `403` is the authoritative answer.
          *
          * See the [Chat Health guide](/guides/chats/chat-health) for what each status
          * means and how to react.
@@ -157,6 +159,11 @@ export declare namespace MessageEventV2 {
              * is not itself an opt-out keyword opts them back in immediately — a reply in any
              * conversation with you counts, the same way the block does.
              *
+             * `OPTED_OUT` marks only the conversation the keyword arrived in. The block below
+             * is wider than the mark, so a conversation still reading `HEALTHY` can be blocked
+             * as well — gate on the `403`, not on the status. Group threads are never marked
+             * and are never blocked.
+             *
              * Linq enforces this: while a recipient is opted out, every send to them is
              * rejected with `403` (error code `2024`) before the message is queued, across
              * every chat and every line on your account. Nothing is delivered, including a
@@ -865,8 +872,8 @@ export declare namespace MessageFailedWebhookEvent {
     interface Data {
         /**
          * Error codes in webhook failure events. The possible set varies by event:
-         * message.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group
-         * update failure events (chat.group_name_update_failed,
+         * message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or
+         * 4008; the group update failure events (chat.group_name_update_failed,
          * chat.group_icon_update_failed) carry 3007 or 4001.
          */
         code: number;
@@ -996,9 +1003,10 @@ export declare namespace MessageEditedWebhookEvent {
              * `AT_RISK` or `CRITICAL` chats on a single line increase the risk of line
              * flagging.
              *
-             * Switch on `status` to gate sends or surface line health in your UI — the enum is
-             * the long-term contract. Each status carries a `doc_url` that deep-links to the
-             * relevant section of the Chat Health guide.
+             * Switch on `status` to surface chat and line health in your UI — the enum is the
+             * long-term contract. Each status carries a `doc_url` that deep-links to the
+             * relevant section of the Chat Health guide. To gate a send, act on the response
+             * rather than the status: a `403` is the authoritative answer.
              *
              * See the [Chat Health guide](/guides/chats/chat-health) for what each status
              * means and how to react.
@@ -1020,9 +1028,10 @@ export declare namespace MessageEditedWebhookEvent {
              * `AT_RISK` or `CRITICAL` chats on a single line increase the risk of line
              * flagging.
              *
-             * Switch on `status` to gate sends or surface line health in your UI — the enum is
-             * the long-term contract. Each status carries a `doc_url` that deep-links to the
-             * relevant section of the Chat Health guide.
+             * Switch on `status` to surface chat and line health in your UI — the enum is the
+             * long-term contract. Each status carries a `doc_url` that deep-links to the
+             * relevant section of the Chat Health guide. To gate a send, act on the response
+             * rather than the status: a `403` is the authoritative answer.
              *
              * See the [Chat Health guide](/guides/chats/chat-health) for what each status
              * means and how to react.
@@ -1046,6 +1055,11 @@ export declare namespace MessageEditedWebhookEvent {
                  * is not itself an opt-out keyword opts them back in immediately — a reply in any
                  * conversation with you counts, the same way the block does.
                  *
+                 * `OPTED_OUT` marks only the conversation the keyword arrived in. The block below
+                 * is wider than the mark, so a conversation still reading `HEALTHY` can be blocked
+                 * as well — gate on the `403`, not on the status. Group threads are never marked
+                 * and are never blocked.
+                 *
                  * Linq enforces this: while a recipient is opted out, every send to them is
                  * rejected with `403` (error code `2024`) before the message is queued, across
                  * every chat and every line on your account. Nothing is delivered, including a
@@ -1161,9 +1175,9 @@ export interface ReactionRemovedWebhookEvent {
     webhook_version: string;
 }
 /**
- * Complete webhook payload for participant.added events
+ * Complete webhook payload for poll.received events
  */
-export interface ParticipantAddedWebhookEvent {
+export interface PollReceivedWebhookEvent {
     /**
      * API version for the webhook payload format
      */
@@ -1173,9 +1187,10 @@ export interface ParticipantAddedWebhookEvent {
      */
     created_at: string;
     /**
-     * Payload for participant.added webhook events
+     * Payload for poll.received — a poll created by someone else and delivered to your
+     * line. Carries the full poll snapshot (options, no voters yet) at receipt time.
      */
-    data: ParticipantAddedWebhookEvent.Data;
+    data: PollReceivedWebhookEvent.Data;
     /**
      * Unique identifier for this event (for deduplication)
      */
@@ -1203,34 +1218,69 @@ export interface ParticipantAddedWebhookEvent {
      */
     webhook_version: string;
 }
-export declare namespace ParticipantAddedWebhookEvent {
+export declare namespace PollReceivedWebhookEvent {
     /**
-     * Payload for participant.added webhook events
+     * Payload for poll.received — a poll created by someone else and delivered to your
+     * line. Carries the full poll snapshot (options, no voters yet) at receipt time.
      */
     interface Data {
         /**
-         * @deprecated DEPRECATED: Use participant instead. Handle (phone number or email
-         * address) of the added participant.
-         */
-        handle: string;
-        /**
-         * When the participant was added
+         * Chat info for poll webhook events.
          */
-        added_at?: string;
+        chat: Data.Chat;
+        created_at: string;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        poll: Data.Poll;
+        received_at: string;
+        service: string;
+        updated_at: string;
         /**
-         * Chat identifier (UUID) of the group chat
+         * The line that created the poll (is_me=false for an inbound poll).
          */
-        chat_id?: string;
+        sender_handle?: Shared.ChatHandle | null;
+    }
+    namespace Data {
         /**
-         * The added participant as a full handle object
+         * Chat info for poll webhook events.
          */
-        participant?: Shared.ChatHandle;
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        interface Poll {
+            options: Array<Poll.Option>;
+            /**
+             * Distinct participants across the whole poll.
+             */
+            total_voters: number;
+        }
+        namespace Poll {
+            interface Option {
+                can_be_edited: boolean;
+                /**
+                 * The participant who added this option (poll creator for the initial options;
+                 * whoever added later ones). Null when unknown.
+                 */
+                creator_handle: Shared.ChatHandle;
+                option_id: string;
+                text: string;
+                voters: Array<Option.Voter>;
+            }
+            namespace Option {
+                interface Voter {
+                    handle: string;
+                    voted_at: string;
+                }
+            }
+        }
     }
 }
 /**
- * Complete webhook payload for participant.removed events
+ * Complete webhook payload for poll.sent events
  */
-export interface ParticipantRemovedWebhookEvent {
+export interface PollSentWebhookEvent {
     /**
      * API version for the webhook payload format
      */
@@ -1240,9 +1290,11 @@ export interface ParticipantRemovedWebhookEvent {
      */
     created_at: string;
     /**
-     * Payload for participant.removed webhook events
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
      */
-    data: ParticipantRemovedWebhookEvent.Data;
+    data: PollSentWebhookEvent.Data;
     /**
      * Unique identifier for this event (for deduplication)
      */
@@ -1270,34 +1322,72 @@ export interface ParticipantRemovedWebhookEvent {
      */
     webhook_version: string;
 }
-export declare namespace ParticipantRemovedWebhookEvent {
+export declare namespace PollSentWebhookEvent {
     /**
-     * Payload for participant.removed webhook events
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
      */
     interface Data {
         /**
-         * @deprecated DEPRECATED: Use participant instead. Handle (phone number or email
-         * address) of the removed participant.
-         */
-        handle: string;
-        /**
-         * Chat identifier (UUID) of the group chat
+         * Chat info for poll webhook events.
          */
-        chat_id?: string;
+        chat: Data.Chat;
+        created_at: string;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        poll: Data.Poll;
+        service: string;
+        updated_at: string;
+        delivered_at?: string | null;
+        read_at?: string | null;
         /**
-         * The removed participant as a full handle object
+         * The handle that sent the poll.
          */
-        participant?: Shared.ChatHandle;
+        sender_handle?: Shared.ChatHandle | null;
+        sent_at?: string | null;
+    }
+    namespace Data {
         /**
-         * When the participant was removed
+         * Chat info for poll webhook events.
          */
-        removed_at?: string;
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        interface Poll {
+            options: Array<Poll.Option>;
+            /**
+             * Distinct participants across the whole poll.
+             */
+            total_voters: number;
+        }
+        namespace Poll {
+            interface Option {
+                can_be_edited: boolean;
+                /**
+                 * The participant who added this option (poll creator for the initial options;
+                 * whoever added later ones). Null when unknown.
+                 */
+                creator_handle: Shared.ChatHandle;
+                option_id: string;
+                text: string;
+                voters: Array<Option.Voter>;
+            }
+            namespace Option {
+                interface Voter {
+                    handle: string;
+                    voted_at: string;
+                }
+            }
+        }
     }
 }
 /**
- * Complete webhook payload for chat.created events
+ * Complete webhook payload for poll.delivered events
  */
-export interface ChatCreatedWebhookEvent {
+export interface PollDeliveredWebhookEvent {
     /**
      * API version for the webhook payload format
      */
@@ -1307,10 +1397,11 @@ export interface ChatCreatedWebhookEvent {
      */
     created_at: string;
     /**
-     * Payload for chat.created webhook events. Matches GET /v3/chats/{chatId}
-     * response.
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
      */
-    data: ChatCreatedWebhookEvent.Data;
+    data: PollDeliveredWebhookEvent.Data;
     /**
      * Unique identifier for this event (for deduplication)
      */
@@ -1338,108 +1429,72 @@ export interface ChatCreatedWebhookEvent {
      */
     webhook_version: string;
 }
-export declare namespace ChatCreatedWebhookEvent {
+export declare namespace PollDeliveredWebhookEvent {
     /**
-     * Payload for chat.created webhook events. Matches GET /v3/chats/{chatId}
-     * response.
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
      */
     interface Data {
         /**
-         * Unique identifier for the chat
-         */
-        id: string;
-        /**
-         * When the chat was created
+         * Chat info for poll webhook events.
          */
+        chat: Data.Chat;
         created_at: string;
-        /**
-         * Display name for the chat. Defaults to a comma-separated list of recipient
-         * handles. Can be updated for group chats.
-         */
-        display_name: string | null;
-        /**
-         * List of chat participants with full handle details. Always contains at least two
-         * handles (your phone number and the other participant).
-         */
-        handles: Array<Shared.ChatHandle>;
-        /**
-         * **[BETA]** Current health for a chat. Always present — chats start at `HEALTHY`
-         * and may shift based on engagement and delivery signals on the conversation. Many
-         * `AT_RISK` or `CRITICAL` chats on a single line increase the risk of line
-         * flagging.
-         *
-         * Switch on `status` to gate sends or surface line health in your UI — the enum is
-         * the long-term contract. Each status carries a `doc_url` that deep-links to the
-         * relevant section of the Chat Health guide.
-         *
-         * See the [Chat Health guide](/guides/chats/chat-health) for what each status
-         * means and how to react.
-         */
-        health_status: Data.HealthStatus;
-        /**
-         * Whether this is a group chat
-         */
-        is_group: boolean;
-        /**
-         * When the chat was last updated
-         */
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        poll: Data.Poll;
+        service: string;
         updated_at: string;
+        delivered_at?: string | null;
+        read_at?: string | null;
         /**
-         * Messaging service type
+         * The handle that sent the poll.
          */
-        service?: Shared.ServiceType | null;
+        sender_handle?: Shared.ChatHandle | null;
+        sent_at?: string | null;
     }
     namespace Data {
         /**
-         * **[BETA]** Current health for a chat. Always present — chats start at `HEALTHY`
-         * and may shift based on engagement and delivery signals on the conversation. Many
-         * `AT_RISK` or `CRITICAL` chats on a single line increase the risk of line
-         * flagging.
-         *
-         * Switch on `status` to gate sends or surface line health in your UI — the enum is
-         * the long-term contract. Each status carries a `doc_url` that deep-links to the
-         * relevant section of the Chat Health guide.
-         *
-         * See the [Chat Health guide](/guides/chats/chat-health) for what each status
-         * means and how to react.
+         * Chat info for poll webhook events.
          */
-        interface HealthStatus {
-            /**
-             * Deep-link to the relevant section of the Chat Health guide for this status.
-             */
-            doc_url: string;
-            /**
-             * Current health bucket for the chat. See the
-             * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
-             * to react. `doc_url` deep-links to the relevant section.
-             *
-             * `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
-             * `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
-             * longer one: `STOP` counts, `please stop` does not. Most keywords must match
-             * exactly, including case. `OPT OUT` is the exception — it matches in any casing,
-             * with or without the space or a hyphen, so `opt out`, `Opt-Out` and `optout` all
-             * count. It clears as soon as they reply again: any later message from them that
-             * is not itself an opt-out keyword opts them back in immediately — a reply in any
-             * conversation with you counts, the same way the block does.
-             *
-             * Linq enforces this: while a recipient is opted out, every send to them is
-             * rejected with `403` (error code `2024`) before the message is queued, across
-             * every chat and every line on your account. Nothing is delivered, including a
-             * final courtesy message — to send one, set `override_optout: true` on that single
-             * request.
-             */
-            status: 'HEALTHY' | 'AT_RISK' | 'CRITICAL' | 'OPTED_OUT';
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        interface Poll {
+            options: Array<Poll.Option>;
             /**
-             * When this status last changed.
+             * Distinct participants across the whole poll.
              */
-            updated_at: string;
+            total_voters: number;
+        }
+        namespace Poll {
+            interface Option {
+                can_be_edited: boolean;
+                /**
+                 * The participant who added this option (poll creator for the initial options;
+                 * whoever added later ones). Null when unknown.
+                 */
+                creator_handle: Shared.ChatHandle;
+                option_id: string;
+                text: string;
+                voters: Array<Option.Voter>;
+            }
+            namespace Option {
+                interface Voter {
+                    handle: string;
+                    voted_at: string;
+                }
+            }
         }
     }
 }
 /**
- * Complete webhook payload for chat.group_name_updated events
+ * Complete webhook payload for poll.read events
  */
-export interface ChatGroupNameUpdatedWebhookEvent {
+export interface PollReadWebhookEvent {
     /**
      * API version for the webhook payload format
      */
@@ -1449,9 +1504,11 @@ export interface ChatGroupNameUpdatedWebhookEvent {
      */
     created_at: string;
     /**
-     * Payload for chat.group_name_updated webhook events
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
      */
-    data: ChatGroupNameUpdatedWebhookEvent.Data;
+    data: PollReadWebhookEvent.Data;
     /**
      * Unique identifier for this event (for deduplication)
      */
@@ -1479,37 +1536,72 @@ export interface ChatGroupNameUpdatedWebhookEvent {
      */
     webhook_version: string;
 }
-export declare namespace ChatGroupNameUpdatedWebhookEvent {
+export declare namespace PollReadWebhookEvent {
     /**
-     * Payload for chat.group_name_updated webhook events
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
      */
     interface Data {
         /**
-         * Chat identifier (UUID) of the group chat
-         */
-        chat_id: string;
-        /**
-         * When the update occurred
+         * Chat info for poll webhook events.
          */
+        chat: Data.Chat;
+        created_at: string;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        poll: Data.Poll;
+        service: string;
         updated_at: string;
+        delivered_at?: string | null;
+        read_at?: string | null;
         /**
-         * The handle who made the change.
-         */
-        changed_by_handle?: Shared.ChatHandle | null;
-        /**
-         * New group name (null if the name was removed)
+         * The handle that sent the poll.
          */
-        new_value?: string | null;
+        sender_handle?: Shared.ChatHandle | null;
+        sent_at?: string | null;
+    }
+    namespace Data {
         /**
-         * Previous group name (null if no previous name)
+         * Chat info for poll webhook events.
          */
-        old_value?: string | null;
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        interface Poll {
+            options: Array<Poll.Option>;
+            /**
+             * Distinct participants across the whole poll.
+             */
+            total_voters: number;
+        }
+        namespace Poll {
+            interface Option {
+                can_be_edited: boolean;
+                /**
+                 * The participant who added this option (poll creator for the initial options;
+                 * whoever added later ones). Null when unknown.
+                 */
+                creator_handle: Shared.ChatHandle;
+                option_id: string;
+                text: string;
+                voters: Array<Option.Voter>;
+            }
+            namespace Option {
+                interface Voter {
+                    handle: string;
+                    voted_at: string;
+                }
+            }
+        }
     }
 }
 /**
- * Complete webhook payload for chat.group_icon_updated events
+ * Complete webhook payload for poll.updated events
  */
-export interface ChatGroupIconUpdatedWebhookEvent {
+export interface PollUpdatedWebhookEvent {
     /**
      * API version for the webhook payload format
      */
@@ -1519,9 +1611,9 @@ export interface ChatGroupIconUpdatedWebhookEvent {
      */
     created_at: string;
     /**
-     * Payload for chat.group_icon_updated webhook events
+     * Payload for poll.updated (option(s) added — add-only).
      */
-    data: ChatGroupIconUpdatedWebhookEvent.Data;
+    data: PollUpdatedWebhookEvent.Data;
     /**
      * Unique identifier for this event (for deduplication)
      */
@@ -1549,37 +1641,56 @@ export interface ChatGroupIconUpdatedWebhookEvent {
      */
     webhook_version: string;
 }
-export declare namespace ChatGroupIconUpdatedWebhookEvent {
+export declare namespace PollUpdatedWebhookEvent {
     /**
-     * Payload for chat.group_icon_updated webhook events
+     * Payload for poll.updated (option(s) added — add-only).
      */
     interface Data {
+        added_options: Array<Data.AddedOption>;
         /**
-         * Chat identifier (UUID) of the group chat
-         */
-        chat_id: string;
-        /**
-         * When the update occurred
-         */
-        updated_at: string;
-        /**
-         * The handle who made the change.
+         * Chat info for poll webhook events.
          */
-        changed_by_handle?: Shared.ChatHandle | null;
+        chat: Data.Chat;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
         /**
-         * New icon URL (null if the icon was removed)
+         * The line that added the option(s) — always present.
          */
-        new_value?: string | null;
+        sender_handle: Shared.ChatHandle;
+        service: string;
+    }
+    namespace Data {
+        interface AddedOption {
+            can_be_edited: boolean;
+            /**
+             * The participant who added this option (poll creator for the initial options;
+             * whoever added later ones). Null when unknown.
+             */
+            creator_handle: Shared.ChatHandle;
+            option_id: string;
+            text: string;
+            voters: Array<AddedOption.Voter>;
+        }
+        namespace AddedOption {
+            interface Voter {
+                handle: string;
+                voted_at: string;
+            }
+        }
         /**
-         * Previous icon URL (null if no previous icon)
+         * Chat info for poll webhook events.
          */
-        old_value?: string | null;
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
     }
 }
 /**
- * Complete webhook payload for chat.group_name_update_failed events
+ * Complete webhook payload for poll.failed events
  */
-export interface ChatGroupNameUpdateFailedWebhookEvent {
+export interface PollFailedWebhookEvent {
     /**
      * API version for the webhook payload format
      */
@@ -1589,11 +1700,10 @@ export interface ChatGroupNameUpdateFailedWebhookEvent {
      */
     created_at: string;
     /**
-     * Error details for chat.group_name_update_failed webhook events. See
-     * [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error
-     * code reference.
+     * Payload for poll.failed — an outbound poll (or poll action) that failed to send.
+     * Carries the poll snapshot at failure time plus the error and when it failed.
      */
-    data: ChatGroupNameUpdateFailedWebhookEvent.Data;
+    data: PollFailedWebhookEvent.Data;
     /**
      * Unique identifier for this event (for deduplication)
      */
@@ -1621,40 +1731,765 @@ export interface ChatGroupNameUpdateFailedWebhookEvent {
      */
     webhook_version: string;
 }
-export declare namespace ChatGroupNameUpdateFailedWebhookEvent {
+export declare namespace PollFailedWebhookEvent {
     /**
-     * Error details for chat.group_name_update_failed webhook events. See
-     * [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error
-     * code reference.
+     * Payload for poll.failed — an outbound poll (or poll action) that failed to send.
+     * Carries the poll snapshot at failure time plus the error and when it failed.
      */
     interface Data {
         /**
-         * Chat identifier (UUID) of the group chat
+         * Chat info for poll webhook events.
          */
-        chat_id: string;
+        chat: Data.Chat;
+        direction: 'inbound' | 'outbound';
+        error: Data.Error;
+        failed_at: string;
+        message_id: string;
+        poll: Data.Poll;
+        service: string;
         /**
-         * Error codes in webhook failure events. The possible set varies by event:
-         * message.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group
-         * update failure events (chat.group_name_update_failed,
-         * chat.group_icon_update_failed) carry 3007 or 4001.
+         * Null on failure (the send never landed).
          */
-        error_code: number;
+        sender_handle?: Shared.ChatHandle | null;
+    }
+    namespace Data {
         /**
-         * When the failure was detected
+         * Chat info for poll webhook events.
          */
-        failed_at: string;
-    }
-}
-/**
- * Complete webhook payload for chat.group_icon_update_failed events
- */
-export interface ChatGroupIconUpdateFailedWebhookEvent {
-    /**
-     * API version for the webhook payload format
-     */
-    api_version: string;
-    /**
-     * When the event was created
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        interface Error {
+            /**
+             * Error codes in webhook failure events. The possible set varies by event:
+             * message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or
+             * 4008; the group update failure events (chat.group_name_update_failed,
+             * chat.group_icon_update_failed) carry 3007 or 4001.
+             */
+            code: number;
+            message: string;
+        }
+        interface Poll {
+            options: Array<Poll.Option>;
+            /**
+             * Distinct participants across the whole poll.
+             */
+            total_voters: number;
+        }
+        namespace Poll {
+            interface Option {
+                can_be_edited: boolean;
+                /**
+                 * The participant who added this option (poll creator for the initial options;
+                 * whoever added later ones). Null when unknown.
+                 */
+                creator_handle: Shared.ChatHandle;
+                option_id: string;
+                text: string;
+                voters: Array<Option.Voter>;
+            }
+            namespace Option {
+                interface Voter {
+                    handle: string;
+                    voted_at: string;
+                }
+            }
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.vote.added events
+ */
+export interface PollVoteAddedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.vote.added and poll.vote.removed (one option toggled).
+     */
+    data: PollVoteAddedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace PollVoteAddedWebhookEvent {
+    /**
+     * Payload for poll.vote.added and poll.vote.removed (one option toggled).
+     */
+    interface Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        chat: Data.Chat;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        option_id: string;
+        /**
+         * The voter — always present.
+         */
+        sender_handle: Shared.ChatHandle;
+        service: string;
+    }
+    namespace Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.vote.removed events
+ */
+export interface PollVoteRemovedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.vote.added and poll.vote.removed (one option toggled).
+     */
+    data: PollVoteRemovedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace PollVoteRemovedWebhookEvent {
+    /**
+     * Payload for poll.vote.added and poll.vote.removed (one option toggled).
+     */
+    interface Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        chat: Data.Chat;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        option_id: string;
+        /**
+         * The voter — always present.
+         */
+        sender_handle: Shared.ChatHandle;
+        service: string;
+    }
+    namespace Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.reaction.added events
+ */
+export interface PollReactionAddedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.reaction.added — a reaction on a poll message. Same shape as
+     * reaction.added; `message_id` is the poll-definition message's ID. Poll reactions
+     * are stickers, which iMessage cannot remove, so there is no removal counterpart.
+     */
+    data: ReactionEventBase;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+/**
+ * Complete webhook payload for participant.added events
+ */
+export interface ParticipantAddedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for participant.added webhook events
+     */
+    data: ParticipantAddedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace ParticipantAddedWebhookEvent {
+    /**
+     * Payload for participant.added webhook events
+     */
+    interface Data {
+        /**
+         * @deprecated DEPRECATED: Use participant instead. Handle (phone number or email
+         * address) of the added participant.
+         */
+        handle: string;
+        /**
+         * When the participant was added
+         */
+        added_at?: string;
+        /**
+         * Chat identifier (UUID) of the group chat
+         */
+        chat_id?: string;
+        /**
+         * The added participant as a full handle object
+         */
+        participant?: Shared.ChatHandle;
+    }
+}
+/**
+ * Complete webhook payload for participant.removed events
+ */
+export interface ParticipantRemovedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for participant.removed webhook events
+     */
+    data: ParticipantRemovedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace ParticipantRemovedWebhookEvent {
+    /**
+     * Payload for participant.removed webhook events
+     */
+    interface Data {
+        /**
+         * @deprecated DEPRECATED: Use participant instead. Handle (phone number or email
+         * address) of the removed participant.
+         */
+        handle: string;
+        /**
+         * Chat identifier (UUID) of the group chat
+         */
+        chat_id?: string;
+        /**
+         * The removed participant as a full handle object
+         */
+        participant?: Shared.ChatHandle;
+        /**
+         * When the participant was removed
+         */
+        removed_at?: string;
+    }
+}
+/**
+ * Complete webhook payload for chat.created events
+ */
+export interface ChatCreatedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for chat.created webhook events. Matches GET /v3/chats/{chatId}
+     * response.
+     */
+    data: ChatCreatedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace ChatCreatedWebhookEvent {
+    /**
+     * Payload for chat.created webhook events. Matches GET /v3/chats/{chatId}
+     * response.
+     */
+    interface Data {
+        /**
+         * Unique identifier for the chat
+         */
+        id: string;
+        /**
+         * When the chat was created
+         */
+        created_at: string;
+        /**
+         * Display name for the chat. Defaults to a comma-separated list of recipient
+         * handles. Can be updated for group chats.
+         */
+        display_name: string | null;
+        /**
+         * List of chat participants with full handle details. Always contains at least two
+         * handles (your phone number and the other participant).
+         */
+        handles: Array<Shared.ChatHandle>;
+        /**
+         * **[BETA]** Current health for a chat. Always present — chats start at `HEALTHY`
+         * and may shift based on engagement and delivery signals on the conversation. Many
+         * `AT_RISK` or `CRITICAL` chats on a single line increase the risk of line
+         * flagging.
+         *
+         * Switch on `status` to surface chat and line health in your UI — the enum is the
+         * long-term contract. Each status carries a `doc_url` that deep-links to the
+         * relevant section of the Chat Health guide. To gate a send, act on the response
+         * rather than the status: a `403` is the authoritative answer.
+         *
+         * See the [Chat Health guide](/guides/chats/chat-health) for what each status
+         * means and how to react.
+         */
+        health_status: Data.HealthStatus;
+        /**
+         * Whether this is a group chat
+         */
+        is_group: boolean;
+        /**
+         * When the chat was last updated
+         */
+        updated_at: string;
+        /**
+         * Messaging service type
+         */
+        service?: Shared.ServiceType | null;
+    }
+    namespace Data {
+        /**
+         * **[BETA]** Current health for a chat. Always present — chats start at `HEALTHY`
+         * and may shift based on engagement and delivery signals on the conversation. Many
+         * `AT_RISK` or `CRITICAL` chats on a single line increase the risk of line
+         * flagging.
+         *
+         * Switch on `status` to surface chat and line health in your UI — the enum is the
+         * long-term contract. Each status carries a `doc_url` that deep-links to the
+         * relevant section of the Chat Health guide. To gate a send, act on the response
+         * rather than the status: a `403` is the authoritative answer.
+         *
+         * See the [Chat Health guide](/guides/chats/chat-health) for what each status
+         * means and how to react.
+         */
+        interface HealthStatus {
+            /**
+             * Deep-link to the relevant section of the Chat Health guide for this status.
+             */
+            doc_url: string;
+            /**
+             * Current health bucket for the chat. See the
+             * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
+             * to react. `doc_url` deep-links to the relevant section.
+             *
+             * `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
+             * `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
+             * longer one: `STOP` counts, `please stop` does not. Most keywords must match
+             * exactly, including case. `OPT OUT` is the exception — it matches in any casing,
+             * with or without the space or a hyphen, so `opt out`, `Opt-Out` and `optout` all
+             * count. It clears as soon as they reply again: any later message from them that
+             * is not itself an opt-out keyword opts them back in immediately — a reply in any
+             * conversation with you counts, the same way the block does.
+             *
+             * `OPTED_OUT` marks only the conversation the keyword arrived in. The block below
+             * is wider than the mark, so a conversation still reading `HEALTHY` can be blocked
+             * as well — gate on the `403`, not on the status. Group threads are never marked
+             * and are never blocked.
+             *
+             * Linq enforces this: while a recipient is opted out, every send to them is
+             * rejected with `403` (error code `2024`) before the message is queued, across
+             * every chat and every line on your account. Nothing is delivered, including a
+             * final courtesy message — to send one, set `override_optout: true` on that single
+             * request.
+             */
+            status: 'HEALTHY' | 'AT_RISK' | 'CRITICAL' | 'OPTED_OUT';
+            /**
+             * When this status last changed.
+             */
+            updated_at: string;
+        }
+    }
+}
+/**
+ * Complete webhook payload for chat.group_name_updated events
+ */
+export interface ChatGroupNameUpdatedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for chat.group_name_updated webhook events
+     */
+    data: ChatGroupNameUpdatedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace ChatGroupNameUpdatedWebhookEvent {
+    /**
+     * Payload for chat.group_name_updated webhook events
+     */
+    interface Data {
+        /**
+         * Chat identifier (UUID) of the group chat
+         */
+        chat_id: string;
+        /**
+         * When the update occurred
+         */
+        updated_at: string;
+        /**
+         * The handle who made the change.
+         */
+        changed_by_handle?: Shared.ChatHandle | null;
+        /**
+         * New group name (null if the name was removed)
+         */
+        new_value?: string | null;
+        /**
+         * Previous group name (null if no previous name)
+         */
+        old_value?: string | null;
+    }
+}
+/**
+ * Complete webhook payload for chat.group_icon_updated events
+ */
+export interface ChatGroupIconUpdatedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for chat.group_icon_updated webhook events
+     */
+    data: ChatGroupIconUpdatedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace ChatGroupIconUpdatedWebhookEvent {
+    /**
+     * Payload for chat.group_icon_updated webhook events
+     */
+    interface Data {
+        /**
+         * Chat identifier (UUID) of the group chat
+         */
+        chat_id: string;
+        /**
+         * When the update occurred
+         */
+        updated_at: string;
+        /**
+         * The handle who made the change.
+         */
+        changed_by_handle?: Shared.ChatHandle | null;
+        /**
+         * New icon URL (null if the icon was removed)
+         */
+        new_value?: string | null;
+        /**
+         * Previous icon URL (null if no previous icon)
+         */
+        old_value?: string | null;
+    }
+}
+/**
+ * Complete webhook payload for chat.group_name_update_failed events
+ */
+export interface ChatGroupNameUpdateFailedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Error details for chat.group_name_update_failed webhook events. See
+     * [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error
+     * code reference.
+     */
+    data: ChatGroupNameUpdateFailedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace ChatGroupNameUpdateFailedWebhookEvent {
+    /**
+     * Error details for chat.group_name_update_failed webhook events. See
+     * [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error
+     * code reference.
+     */
+    interface Data {
+        /**
+         * Chat identifier (UUID) of the group chat
+         */
+        chat_id: string;
+        /**
+         * Error codes in webhook failure events. The possible set varies by event:
+         * message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or
+         * 4008; the group update failure events (chat.group_name_update_failed,
+         * chat.group_icon_update_failed) carry 3007 or 4001.
+         */
+        error_code: number;
+        /**
+         * When the failure was detected
+         */
+        failed_at: string;
+    }
+}
+/**
+ * Complete webhook payload for chat.group_icon_update_failed events
+ */
+export interface ChatGroupIconUpdateFailedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
      */
     created_at: string;
     /**
@@ -1703,8 +2538,8 @@ export declare namespace ChatGroupIconUpdateFailedWebhookEvent {
         chat_id: string;
         /**
          * Error codes in webhook failure events. The possible set varies by event:
-         * message.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group
-         * update failure events (chat.group_name_update_failed,
+         * message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or
+         * 4008; the group update failure events (chat.group_name_update_failed,
          * chat.group_icon_update_failed) carry 3007 or 4001.
          */
         error_code: number;
@@ -1822,6 +2657,113 @@ export declare namespace ChatTypingIndicatorStoppedWebhookEvent {
         chat_id: string;
     }
 }
+/**
+ * Complete webhook payload for chat.background_updated events
+ */
+export interface ChatBackgroundUpdatedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for chat.background_updated webhook events.
+     */
+    data: ChatBackgroundUpdatedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace ChatBackgroundUpdatedWebhookEvent {
+    /**
+     * Payload for chat.background_updated webhook events.
+     */
+    interface Data {
+        /**
+         * Chat information
+         */
+        chat: Data.Chat;
+        /**
+         * Who changed it. `is_me` is true when your own number set it.
+         */
+        actor_handle?: Shared.ChatHandle | null;
+        /**
+         * A chat transcript background. Fields are populated per `type`.
+         */
+        background?: Data.Background | null;
+    }
+    namespace Data {
+        /**
+         * Chat information
+         */
+        interface Chat {
+            /**
+             * Chat identifier
+             */
+            id: string;
+            /**
+             * Whether this is a group chat
+             */
+            is_group?: boolean | null;
+            /**
+             * Your phone number's handle. Always has is_me=true.
+             */
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        /**
+         * A chat transcript background. Fields are populated per `type`.
+         */
+        interface Background {
+            /**
+             * The background family.
+             */
+            type: 'color' | 'dynamic' | 'photo';
+            /**
+             * Photo: the image URL.
+             */
+            image_url?: string | null;
+            /**
+             * Color: the two gradient stops as hex, top then bottom.
+             */
+            shades?: Array<string> | null;
+            /**
+             * Dynamic: the animated style.
+             */
+            style?: 'sky' | 'water' | 'aurora' | 'glitter' | null;
+            /**
+             * Color: `custom` (the stored two colors) or a named swatch. Dynamic: the variant
+             * within the `style` (e.g. `sunrise`).
+             */
+            variant?: string | null;
+        }
+    }
+}
 /**
  * Complete webhook payload for phone_number.status_updated events
  */
@@ -1895,8 +2837,8 @@ export declare namespace PhoneNumberStatusUpdatedWebhookEvent {
 /**
  * Complete webhook payload for message.sent events (2026-02-03 format)
  */
-export type UnwrapWebhookEvent = MessageSentWebhookEvent | MessageReceivedWebhookEvent | MessageReadWebhookEvent | MessageDeliveredWebhookEvent | MessageFailedWebhookEvent | MessageEditedWebhookEvent | ReactionAddedWebhookEvent | ReactionRemovedWebhookEvent | ParticipantAddedWebhookEvent | ParticipantRemovedWebhookEvent | ChatCreatedWebhookEvent | ChatGroupNameUpdatedWebhookEvent | ChatGroupIconUpdatedWebhookEvent | ChatGroupNameUpdateFailedWebhookEvent | ChatGroupIconUpdateFailedWebhookEvent | ChatTypingIndicatorStartedWebhookEvent | ChatTypingIndicatorStoppedWebhookEvent | PhoneNumberStatusUpdatedWebhookEvent;
+export type UnwrapWebhookEvent = MessageSentWebhookEvent | MessageReceivedWebhookEvent | MessageReadWebhookEvent | MessageDeliveredWebhookEvent | MessageFailedWebhookEvent | MessageEditedWebhookEvent | ReactionAddedWebhookEvent | ReactionRemovedWebhookEvent | PollReceivedWebhookEvent | PollSentWebhookEvent | PollDeliveredWebhookEvent | PollReadWebhookEvent | PollUpdatedWebhookEvent | PollFailedWebhookEvent | PollVoteAddedWebhookEvent | PollVoteRemovedWebhookEvent | PollReactionAddedWebhookEvent | ParticipantAddedWebhookEvent | ParticipantRemovedWebhookEvent | ChatCreatedWebhookEvent | ChatGroupNameUpdatedWebhookEvent | ChatGroupIconUpdatedWebhookEvent | ChatGroupNameUpdateFailedWebhookEvent | ChatGroupIconUpdateFailedWebhookEvent | ChatTypingIndicatorStartedWebhookEvent | ChatTypingIndicatorStoppedWebhookEvent | ChatBackgroundUpdatedWebhookEvent | PhoneNumberStatusUpdatedWebhookEvent;
 export declare namespace Webhooks {
-    export { type MessageEventV2 as MessageEventV2, type MessagePayload as MessagePayload, type ReactionEventBase as ReactionEventBase, type SchemasMediaPartResponse as SchemasMediaPartResponse, type SchemasMessageEffect as SchemasMessageEffect, type SchemasTextPartResponse as SchemasTextPartResponse, type MessageSentWebhookEvent as MessageSentWebhookEvent, type MessageReceivedWebhookEvent as MessageReceivedWebhookEvent, type MessageReadWebhookEvent as MessageReadWebhookEvent, type MessageDeliveredWebhookEvent as MessageDeliveredWebhookEvent, type MessageFailedWebhookEvent as MessageFailedWebhookEvent, type MessageEditedWebhookEvent as MessageEditedWebhookEvent, type ReactionAddedWebhookEvent as ReactionAddedWebhookEvent, type ReactionRemovedWebhookEvent as ReactionRemovedWebhookEvent, type ParticipantAddedWebhookEvent as ParticipantAddedWebhookEvent, type ParticipantRemovedWebhookEvent as ParticipantRemovedWebhookEvent, type ChatCreatedWebhookEvent as ChatCreatedWebhookEvent, type ChatGroupNameUpdatedWebhookEvent as ChatGroupNameUpdatedWebhookEvent, type ChatGroupIconUpdatedWebhookEvent as ChatGroupIconUpdatedWebhookEvent, type ChatGroupNameUpdateFailedWebhookEvent as ChatGroupNameUpdateFailedWebhookEvent, type ChatGroupIconUpdateFailedWebhookEvent as ChatGroupIconUpdateFailedWebhookEvent, type ChatTypingIndicatorStartedWebhookEvent as ChatTypingIndicatorStartedWebhookEvent, type ChatTypingIndicatorStoppedWebhookEvent as ChatTypingIndicatorStoppedWebhookEvent, type PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent, type UnwrapWebhookEvent as UnwrapWebhookEvent, };
+    export { type MessageEventV2 as MessageEventV2, type MessagePayload as MessagePayload, type ReactionEventBase as ReactionEventBase, type SchemasMediaPartResponse as SchemasMediaPartResponse, type SchemasMessageEffect as SchemasMessageEffect, type SchemasTextPartResponse as SchemasTextPartResponse, type MessageSentWebhookEvent as MessageSentWebhookEvent, type MessageReceivedWebhookEvent as MessageReceivedWebhookEvent, type MessageReadWebhookEvent as MessageReadWebhookEvent, type MessageDeliveredWebhookEvent as MessageDeliveredWebhookEvent, type MessageFailedWebhookEvent as MessageFailedWebhookEvent, type MessageEditedWebhookEvent as MessageEditedWebhookEvent, type ReactionAddedWebhookEvent as ReactionAddedWebhookEvent, type ReactionRemovedWebhookEvent as ReactionRemovedWebhookEvent, type PollReceivedWebhookEvent as PollReceivedWebhookEvent, type PollSentWebhookEvent as PollSentWebhookEvent, type PollDeliveredWebhookEvent as PollDeliveredWebhookEvent, type PollReadWebhookEvent as PollReadWebhookEvent, type PollUpdatedWebhookEvent as PollUpdatedWebhookEvent, type PollFailedWebhookEvent as PollFailedWebhookEvent, type PollVoteAddedWebhookEvent as PollVoteAddedWebhookEvent, type PollVoteRemovedWebhookEvent as PollVoteRemovedWebhookEvent, type PollReactionAddedWebhookEvent as PollReactionAddedWebhookEvent, type ParticipantAddedWebhookEvent as ParticipantAddedWebhookEvent, type ParticipantRemovedWebhookEvent as ParticipantRemovedWebhookEvent, type ChatCreatedWebhookEvent as ChatCreatedWebhookEvent, type ChatGroupNameUpdatedWebhookEvent as ChatGroupNameUpdatedWebhookEvent, type ChatGroupIconUpdatedWebhookEvent as ChatGroupIconUpdatedWebhookEvent, type ChatGroupNameUpdateFailedWebhookEvent as ChatGroupNameUpdateFailedWebhookEvent, type ChatGroupIconUpdateFailedWebhookEvent as ChatGroupIconUpdateFailedWebhookEvent, type ChatTypingIndicatorStartedWebhookEvent as ChatTypingIndicatorStartedWebhookEvent, type ChatTypingIndicatorStoppedWebhookEvent as ChatTypingIndicatorStoppedWebhookEvent, type ChatBackgroundUpdatedWebhookEvent as ChatBackgroundUpdatedWebhookEvent, type PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent, type UnwrapWebhookEvent as UnwrapWebhookEvent, };
 }
 //# sourceMappingURL=webhooks.d.mts.map