sendblue 3.15.0 → 3.16.1

package/resources/messages/messages.d.ts

@@ -0,0 +1,1071 @@
+import { APIResource } from "../../core/resource.js";
+import * as V2API from "./v2/v2.js";
+import { V2 } from "./v2/v2.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Operations for sending and managing messages
+ */
+export declare class Messages extends APIResource {
+    v2: V2API.V2;
+    /**
+     * Retrieve details of a specific message by its ID
+     *
+     * @example
+     * ```ts
+     * const message = await client.messages.retrieve(
+     *   'msg_abc123def456',
+     * );
+     * ```
+     */
+    retrieve(messageID: string, options?: RequestOptions): APIPromise<MessageRetrieveResponse>;
+    /**
+     * Retrieve a list of messages for the authenticated account with comprehensive
+     * filtering capabilities. Rate limited to 100 requests per 10 seconds per account.
+     *
+     * ## Common Use Cases
+     *
+     * **Polling for inbound messages (no webhooks):**
+     *
+     * ```
+     * GET /api/v2/messages?is_outbound=false&sendblue_number=+16292925296&order_by=createdAt&order_direction=desc&limit=50
+     * ```
+     *
+     * Track processed message IDs to avoid duplicates.
+     *
+     * **Get conversation with a specific contact:**
+     *
+     * ```
+     * GET /api/v2/messages?number=+15551234567&order_by=createdAt&order_direction=desc
+     * ```
+     *
+     * @example
+     * ```ts
+     * const messages = await client.messages.list();
+     * ```
+     */
+    list(query?: MessageListParams | null | undefined, options?: RequestOptions): APIPromise<MessageListResponse>;
+    /**
+     * Retrieve the current status of a message using its message handle. Useful for
+     * resolving pending message statuses and avoiding duplicate messages.
+     *
+     * @example
+     * ```ts
+     * const messageResponse = await client.messages.getStatus({
+     *   handle: 'msg_abc123def456',
+     * });
+     * ```
+     */
+    getStatus(query: MessageGetStatusParams, options?: RequestOptions): APIPromise<MessageResponse>;
+    /**
+     * Send an iMessage, SMS, MMS, or Sendblue App Card to a single recipient
+     *
+     * @example
+     * ```ts
+     * const messageResponse = await client.messages.send({
+     *   from_number: '+19998887777',
+     *   number: '+19998887777',
+     * });
+     * ```
+     */
+    send(body: MessageSendParams, options?: RequestOptions): APIPromise<MessageResponse>;
+    /**
+     * Continues an existing App Card by sending a new Apple message in the same
+     * iMessage session, from the same sender line and inline-reply context. The
+     * continuation receives its own message handle and delivery/read status updates.
+     *
+     * @example
+     * ```ts
+     * const messageResponse = await client.messages.updateAppCard(
+     *   'message_handle',
+     * );
+     * ```
+     */
+    updateAppCard(messageHandle: string, body: MessageUpdateAppCardParams, options?: RequestOptions): APIPromise<MessageResponse>;
+}
+export interface MessageContent {
+    /**
+     * Email of the account
+     */
+    account_email?: string;
+    /**
+     * Message content
+     */
+    content?: string;
+    /**
+     * When the message was created
+     */
+    date_created?: string;
+    /**
+     * When the message was sent
+     */
+    date_sent?: string;
+    /**
+     * When the message was last updated
+     */
+    date_updated?: string;
+    /**
+     * Sender phone number
+     */
+    from_number?: string;
+    /**
+     * Whether this is an outbound message
+     */
+    is_outbound?: boolean;
+    /**
+     * URL of attached media
+     */
+    media_url?: string;
+    /**
+     * Unique message identifier
+     */
+    message_handle?: string;
+    /**
+     * Immediate parent of an iMessage inline reply. The target must belong to the same
+     * account, conversation, and sending line.
+     */
+    reply_to?: MessageContent.ReplyTo;
+    /**
+     * UUID of the seat that sent the message. Present when `seat_id` was provided on
+     * send, or for dashboard-originated group messages.
+     */
+    seat_id?: string | null;
+    send_style?: 'celebration' | 'shooting_star' | 'fireworks' | 'lasers' | 'love' | 'confetti' | 'balloons' | 'spotlight' | 'echo' | 'invisible' | 'gentle' | 'loud' | 'slam';
+    /**
+     * Email of the seat (user) that sent the message. Auto-populated when a `seat_id`
+     * is provided on send. `null` for messages sent without a `seat_id`.
+     */
+    sender_email?: string | null;
+    status?: 'QUEUED' | 'SENT' | 'DELIVERED' | 'ERROR' | 'RECEIVED';
+    /**
+     * Message that originated an iMessage inline-reply thread.
+     */
+    thread_originator?: MessageContent.ThreadOriginator;
+    /**
+     * Recipient phone number
+     */
+    to_number?: string;
+}
+export declare namespace MessageContent {
+    /**
+     * Immediate parent of an iMessage inline reply. The target must belong to the same
+     * account, conversation, and sending line.
+     */
+    interface ReplyTo {
+        /**
+         * Public handle of the immediate parent message
+         */
+        message_handle: string;
+        /**
+         * Advanced override for a known part of a multipart target. Omit this in normal
+         * reply requests and never guess it; requests default to 0. When replying to an
+         * attachment represented by its own webhook, use that webhook's `message_handle`
+         * and omit `part_index` so Sendblue can use the stored authoritative part.
+         * Responses omit it when no authoritative immediate-parent part is available.
+         */
+        part_index?: number;
+    }
+    /**
+     * Message that originated an iMessage inline-reply thread.
+     */
+    interface ThreadOriginator {
+        /**
+         * Public handle of the thread's root message
+         */
+        message_handle: string;
+        /**
+         * Opaque Apple thread-originator part descriptor
+         */
+        part?: string;
+    }
+}
+export interface MessageResponse {
+    /**
+     * Email of the account that sent the message
+     */
+    account_email?: string;
+    /**
+     * App Card data sent or received with this message.
+     */
+    app_card?: MessageResponse.AppCard | MessageResponse.InboundAppCard;
+    /**
+     * Message content
+     */
+    content?: string;
+    /**
+     * When the message was created
+     */
+    date_created?: string;
+    /**
+     * When the message was last updated
+     */
+    date_updated?: string;
+    /**
+     * Numeric error code if message failed
+     */
+    error_code?: number;
+    /**
+     * Error message if message failed
+     */
+    error_message?: string;
+    /**
+     * Sending phone number
+     */
+    from_number?: string;
+    /**
+     * Whether this is an outbound message
+     */
+    is_outbound?: boolean;
+    /**
+     * Decoded Find My location share coordinates.
+     */
+    location?: MessageResponse.Location;
+    /**
+     * URL of attached media
+     */
+    media_url?: string;
+    /**
+     * Unique identifier for tracking the message
+     */
+    message_handle?: string;
+    message_type?: 'message' | 'group' | 'location';
+    /**
+     * Recipient phone number
+     */
+    number?: string;
+    /**
+     * Immediate parent of an iMessage inline reply. The target must belong to the same
+     * account, conversation, and sending line.
+     */
+    reply_to?: MessageResponse.ReplyTo;
+    /**
+     * UUID of the seat that sent the message. Present when `seat_id` was provided on
+     * send, or for dashboard-originated group messages.
+     */
+    seat_id?: string | null;
+    /**
+     * The iMessage expressive message style
+     */
+    send_style?: 'celebration' | 'shooting_star' | 'fireworks' | 'lasers' | 'love' | 'confetti' | 'balloons' | 'spotlight' | 'echo' | 'invisible' | 'gentle' | 'loud' | 'slam';
+    /**
+     * Email of the seat (user) that sent the message. Auto-populated when a `seat_id`
+     * is provided on send. `null` for messages sent without a `seat_id`.
+     */
+    sender_email?: string | null;
+    status?: 'QUEUED' | 'SENT' | 'DELIVERED' | 'ERROR';
+    /**
+     * Message that originated an iMessage inline-reply thread.
+     */
+    thread_originator?: MessageResponse.ThreadOriginator;
+}
+export declare namespace MessageResponse {
+    /**
+     * A Sendblue App Card rendered with Apple's Messages framework. App Cards require
+     * a V2 Mac line and an iMessage-capable recipient; they never fall back to SMS.
+     * The URL is delivered to the identified Messages extension when the recipient
+     * taps the card. An initial App Card may include `reply_to` to create an inline
+     * reply. Later state changes use the update endpoint, which sends a new Apple
+     * message in the same App Card session. The feature is unavailable on the free
+     * plan.
+     */
+    interface AppCard {
+        appName: string;
+        extensionBundleId: string;
+        /**
+         * Visible card fields mirroring Apple's MSMessageTemplateLayout.
+         */
+        layout: AppCard.Layout;
+        teamId: string;
+        /**
+         * URL delivered to the iMessage extension on tap. HTTPS URLs are limited to 2048
+         * characters; data URLs carrying inline app state are limited to 16384.
+         */
+        url: string;
+        /**
+         * Optional numeric App Store ID for recipients without the extension.
+         */
+        appStoreId?: number;
+        /**
+         * Fallback text for notifications and surfaces that cannot render the card.
+         */
+        fallbackText?: string;
+        /**
+         * Use Apple's live layout when the extension is installed; false always sends the
+         * static template layout.
+         */
+        interactive?: boolean;
+        /**
+         * Optional caller-supplied App Card session UUID. Generated automatically when
+         * omitted.
+         */
+        sessionIdentifier?: string;
+        /**
+         * Original message handle for an App Card continuation returned by the update
+         * endpoint.
+         */
+        updateMessageHandle?: string;
+    }
+    namespace AppCard {
+        /**
+         * Visible card fields mirroring Apple's MSMessageTemplateLayout.
+         */
+        interface Layout {
+            caption?: string;
+            /**
+             * Secondary text overlaid on the preview image. Requires imageUrl.
+             */
+            imageSubtitle?: string;
+            /**
+             * Text overlaid on the preview image. Requires imageUrl.
+             */
+            imageTitle?: string;
+            /**
+             * HTTPS preview image fetched by the worker and sent as a hidden card attachment.
+             * JPEG, PNG, HEIC, HEIF, and WebP are supported up to 10 MB.
+             */
+            imageUrl?: string;
+            subcaption?: string;
+            /**
+             * Fallback text used in notifications and non-rendering surfaces.
+             */
+            summary?: string;
+            trailingCaption?: string;
+            trailingSubcaption?: string;
+        }
+    }
+    /**
+     * App Card session metadata received from an iMessage contact.
+     */
+    interface InboundAppCard {
+        balloonBundleId: string;
+        extensionBundleId: string;
+        /**
+         * Retry-stable occurrence revision assigned to this inbound App Card state.
+         */
+        revision: number;
+        sessionIdentifier: string;
+        teamId: string;
+        url: string;
+    }
+    /**
+     * Decoded Find My location share coordinates.
+     */
+    interface Location {
+        latitude: number;
+        longitude: number;
+        /**
+         * Horizontal accuracy in meters
+         */
+        accuracy?: number;
+        /**
+         * Altitude in meters
+         */
+        altitude?: number;
+        /**
+         * Share duration selected by the recipient
+         */
+        duration?: string;
+        timestamp?: string;
+    }
+    /**
+     * Immediate parent of an iMessage inline reply. The target must belong to the same
+     * account, conversation, and sending line.
+     */
+    interface ReplyTo {
+        /**
+         * Public handle of the immediate parent message
+         */
+        message_handle: string;
+        /**
+         * Advanced override for a known part of a multipart target. Omit this in normal
+         * reply requests and never guess it; requests default to 0. When replying to an
+         * attachment represented by its own webhook, use that webhook's `message_handle`
+         * and omit `part_index` so Sendblue can use the stored authoritative part.
+         * Responses omit it when no authoritative immediate-parent part is available.
+         */
+        part_index?: number;
+    }
+    /**
+     * Message that originated an iMessage inline-reply thread.
+     */
+    interface ThreadOriginator {
+        /**
+         * Public handle of the thread's root message
+         */
+        message_handle: string;
+        /**
+         * Opaque Apple thread-originator part descriptor
+         */
+        part?: string;
+    }
+}
+export interface MessageRetrieveResponse {
+    data?: MessageRetrieveResponse.Data;
+    status?: string;
+}
+export declare namespace MessageRetrieveResponse {
+    interface Data {
+        /**
+         * Email of the account
+         */
+        accountEmail?: string;
+        /**
+         * Message content
+         */
+        content?: string;
+        /**
+         * When the message was sent
+         */
+        date_sent?: string;
+        /**
+         * When the message was last updated
+         */
+        date_updated?: string;
+        /**
+         * Numeric error code if message failed
+         */
+        error_code?: number | null;
+        /**
+         * Detailed error information
+         */
+        error_detail?: string | null;
+        /**
+         * Error message if message failed
+         */
+        error_message?: string | null;
+        /**
+         * Error reason if message failed
+         */
+        error_reason?: string | null;
+        /**
+         * Sender phone number
+         */
+        from_number?: string;
+        /**
+         * Display name for group messages
+         */
+        group_display_name?: string | null;
+        /**
+         * Group ID for group messages
+         */
+        group_id?: string | null;
+        /**
+         * Whether this is an outbound message
+         */
+        is_outbound?: boolean;
+        /**
+         * Decoded Find My location share coordinates.
+         */
+        location?: Data.Location;
+        /**
+         * URL of attached media
+         */
+        media_url?: string | null;
+        /**
+         * Unique message identifier
+         */
+        message_handle?: string;
+        message_type?: 'message' | 'group' | 'location';
+        /**
+         * Primary phone number (to_number for outbound, from_number for inbound)
+         */
+        number?: string;
+        /**
+         * Whether the recipient has opted out
+         */
+        opted_out?: boolean;
+        /**
+         * List of participants for group messages
+         */
+        participants?: Array<string>;
+        /**
+         * Account plan used for this message
+         */
+        plan?: string;
+        /**
+         * Immediate parent of an iMessage inline reply. The target must belong to the same
+         * account, conversation, and sending line.
+         */
+        reply_to?: Data.ReplyTo;
+        /**
+         * UUID of the seat that sent the message. Present when `seat_id` was provided on
+         * send, or for dashboard-originated group messages.
+         */
+        seat_id?: string | null;
+        /**
+         * The iMessage expressive message style
+         */
+        send_style?: 'celebration' | 'shooting_star' | 'fireworks' | 'lasers' | 'love' | 'confetti' | 'balloons' | 'spotlight' | 'echo' | 'invisible' | 'gentle' | 'loud' | 'slam';
+        /**
+         * Sendblue phone number used
+         */
+        sendblue_number?: string | null;
+        /**
+         * Email of the seat (user) that sent the message. Auto-populated when a `seat_id`
+         * is provided on send. `null` for messages sent without a `seat_id`.
+         */
+        sender_email?: string | null;
+        /**
+         * The messaging service used
+         */
+        service?: 'iMessage' | 'SMS' | 'RCS';
+        status?: 'REGISTERED' | 'PENDING' | 'SENT' | 'DELIVERED' | 'RECEIVED' | 'QUEUED' | 'ERROR' | 'DECLINED' | 'ACCEPTED' | 'SUCCESS';
+        /**
+         * Message that originated an iMessage inline-reply thread.
+         */
+        thread_originator?: Data.ThreadOriginator;
+        /**
+         * Recipient phone number
+         */
+        to_number?: string;
+        /**
+         * Whether the message was downgraded from iMessage to SMS
+         */
+        was_downgraded?: boolean;
+    }
+    namespace Data {
+        /**
+         * Decoded Find My location share coordinates.
+         */
+        interface Location {
+            latitude: number;
+            longitude: number;
+            /**
+             * Horizontal accuracy in meters
+             */
+            accuracy?: number;
+            /**
+             * Altitude in meters
+             */
+            altitude?: number;
+            /**
+             * Share duration selected by the recipient
+             */
+            duration?: string;
+            timestamp?: string;
+        }
+        /**
+         * Immediate parent of an iMessage inline reply. The target must belong to the same
+         * account, conversation, and sending line.
+         */
+        interface ReplyTo {
+            /**
+             * Public handle of the immediate parent message
+             */
+            message_handle: string;
+            /**
+             * Advanced override for a known part of a multipart target. Omit this in normal
+             * reply requests and never guess it; requests default to 0. When replying to an
+             * attachment represented by its own webhook, use that webhook's `message_handle`
+             * and omit `part_index` so Sendblue can use the stored authoritative part.
+             * Responses omit it when no authoritative immediate-parent part is available.
+             */
+            part_index?: number;
+        }
+        /**
+         * Message that originated an iMessage inline-reply thread.
+         */
+        interface ThreadOriginator {
+            /**
+             * Public handle of the thread's root message
+             */
+            message_handle: string;
+            /**
+             * Opaque Apple thread-originator part descriptor
+             */
+            part?: string;
+        }
+    }
+}
+export interface MessageListResponse {
+    data?: Array<MessageListResponse.Data>;
+    pagination?: MessageListResponse.Pagination;
+    status?: string;
+}
+export declare namespace MessageListResponse {
+    interface Data {
+        /**
+         * Email of the account
+         */
+        accountEmail?: string;
+        /**
+         * Message content
+         */
+        content?: string;
+        /**
+         * When the message was sent
+         */
+        date_sent?: string;
+        /**
+         * When the message was last updated
+         */
+        date_updated?: string;
+        /**
+         * Numeric error code if message failed
+         */
+        error_code?: number | null;
+        /**
+         * Detailed error information
+         */
+        error_detail?: string | null;
+        /**
+         * Error message if message failed
+         */
+        error_message?: string | null;
+        /**
+         * Error reason if message failed
+         */
+        error_reason?: string | null;
+        /**
+         * Sender phone number
+         */
+        from_number?: string;
+        /**
+         * Display name for group messages
+         */
+        group_display_name?: string | null;
+        /**
+         * Group ID for group messages
+         */
+        group_id?: string | null;
+        /**
+         * Whether this is an outbound message
+         */
+        is_outbound?: boolean;
+        /**
+         * Decoded Find My location share coordinates.
+         */
+        location?: Data.Location;
+        /**
+         * URL of attached media
+         */
+        media_url?: string | null;
+        /**
+         * Unique message identifier
+         */
+        message_handle?: string;
+        message_type?: 'message' | 'group' | 'location';
+        /**
+         * Primary phone number (to_number for outbound, from_number for inbound)
+         */
+        number?: string;
+        /**
+         * Whether the recipient has opted out
+         */
+        opted_out?: boolean;
+        /**
+         * List of participants for group messages
+         */
+        participants?: Array<string>;
+        /**
+         * Account plan used for this message
+         */
+        plan?: string;
+        /**
+         * Immediate parent of an iMessage inline reply. The target must belong to the same
+         * account, conversation, and sending line.
+         */
+        reply_to?: Data.ReplyTo;
+        /**
+         * UUID of the seat that sent the message. Present when `seat_id` was provided on
+         * send, or for dashboard-originated group messages.
+         */
+        seat_id?: string | null;
+        /**
+         * The iMessage expressive message style
+         */
+        send_style?: 'celebration' | 'shooting_star' | 'fireworks' | 'lasers' | 'love' | 'confetti' | 'balloons' | 'spotlight' | 'echo' | 'invisible' | 'gentle' | 'loud' | 'slam';
+        /**
+         * Sendblue phone number used
+         */
+        sendblue_number?: string | null;
+        /**
+         * Email of the seat (user) that sent the message. Auto-populated when a `seat_id`
+         * is provided on send. `null` for messages sent without a `seat_id`.
+         */
+        sender_email?: string | null;
+        /**
+         * The messaging service used
+         */
+        service?: 'iMessage' | 'SMS' | 'RCS';
+        status?: 'REGISTERED' | 'PENDING' | 'SENT' | 'DELIVERED' | 'RECEIVED' | 'QUEUED' | 'ERROR' | 'DECLINED' | 'ACCEPTED' | 'SUCCESS';
+        /**
+         * Message that originated an iMessage inline-reply thread.
+         */
+        thread_originator?: Data.ThreadOriginator;
+        /**
+         * Recipient phone number
+         */
+        to_number?: string;
+        /**
+         * Whether the message was downgraded from iMessage to SMS
+         */
+        was_downgraded?: boolean;
+    }
+    namespace Data {
+        /**
+         * Decoded Find My location share coordinates.
+         */
+        interface Location {
+            latitude: number;
+            longitude: number;
+            /**
+             * Horizontal accuracy in meters
+             */
+            accuracy?: number;
+            /**
+             * Altitude in meters
+             */
+            altitude?: number;
+            /**
+             * Share duration selected by the recipient
+             */
+            duration?: string;
+            timestamp?: string;
+        }
+        /**
+         * Immediate parent of an iMessage inline reply. The target must belong to the same
+         * account, conversation, and sending line.
+         */
+        interface ReplyTo {
+            /**
+             * Public handle of the immediate parent message
+             */
+            message_handle: string;
+            /**
+             * Advanced override for a known part of a multipart target. Omit this in normal
+             * reply requests and never guess it; requests default to 0. When replying to an
+             * attachment represented by its own webhook, use that webhook's `message_handle`
+             * and omit `part_index` so Sendblue can use the stored authoritative part.
+             * Responses omit it when no authoritative immediate-parent part is available.
+             */
+            part_index?: number;
+        }
+        /**
+         * Message that originated an iMessage inline-reply thread.
+         */
+        interface ThreadOriginator {
+            /**
+             * Public handle of the thread's root message
+             */
+            message_handle: string;
+            /**
+             * Opaque Apple thread-originator part descriptor
+             */
+            part?: string;
+        }
+    }
+    interface Pagination {
+        /**
+         * Whether there are more messages available
+         */
+        hasMore?: boolean;
+        /**
+         * Number of messages returned in this request
+         */
+        limit?: number;
+        /**
+         * Number of messages skipped
+         */
+        offset?: number;
+        /**
+         * Total number of messages matching the filters
+         */
+        total?: number;
+    }
+}
+export interface MessageListParams {
+    /**
+     * Filter by account email
+     */
+    account_email?: string;
+    /**
+     * Filter messages created after this date (ISO 8601 format)
+     */
+    created_at_gte?: string;
+    /**
+     * Filter messages created before this date (ISO 8601 format)
+     */
+    created_at_lte?: string;
+    /**
+     * Filter by sender phone number
+     */
+    from_number?: string;
+    /**
+     * Filter by group ID
+     */
+    group_id?: string;
+    /**
+     * Filter by message direction. Use `false` to get inbound messages (messages sent
+     * TO your Sendblue number).
+     *
+     * **To get inbound messages for polling:** Use `is_outbound=false` combined with
+     * `sendblue_number` or `to_number` set to your Sendblue phone number.
+     *
+     * Note: Do NOT use `message_type=inbound` - that parameter only accepts `message`
+     * or `group` values.
+     */
+    is_outbound?: 'true' | 'false';
+    /**
+     * Maximum number of messages to return
+     */
+    limit?: number;
+    /**
+     * Filter by message type (1:1 vs group chat). Only accepts `message` or `group`.
+     *
+     * **Common mistake:** This is NOT for filtering inbound vs outbound messages. Use
+     * `is_outbound` parameter instead.
+     */
+    message_type?: 'message' | 'group';
+    /**
+     * Filter by any phone number (from or to)
+     */
+    number?: string;
+    /**
+     * Number of messages to skip
+     */
+    offset?: number;
+    /**
+     * Field to order messages by
+     */
+    order_by?: 'createdAt' | 'updatedAt' | 'sentAt';
+    /**
+     * Sort order
+     */
+    order_direction?: 'asc' | 'desc';
+    /**
+     * Filter by Sendblue phone number
+     */
+    sendblue_number?: string;
+    /**
+     * Filter messages sent after this date (ISO 8601 format)
+     */
+    sent_at_gte?: string;
+    /**
+     * Filter messages sent before this date (ISO 8601 format)
+     */
+    sent_at_lte?: string;
+    /**
+     * Filter by service type
+     */
+    service?: 'iMessage' | 'SMS' | 'RCS';
+    /**
+     * Filter by message status
+     */
+    status?: 'REGISTERED' | 'PENDING' | 'SENT' | 'DELIVERED' | 'RECEIVED' | 'QUEUED' | 'ERROR' | 'DECLINED' | 'ACCEPTED' | 'SUCCESS';
+    /**
+     * Filter by recipient phone number
+     */
+    to_number?: string;
+    /**
+     * Filter messages updated after this date (ISO 8601 format)
+     */
+    updated_at_gte?: string;
+    /**
+     * Filter messages updated before this date (ISO 8601 format)
+     */
+    updated_at_lte?: string;
+    /**
+     * Filter by worker ID (Admin only)
+     */
+    worker_id?: string;
+}
+export interface MessageGetStatusParams {
+    /**
+     * The message handle of the message you want to check status for
+     */
+    handle: string;
+}
+export interface MessageSendParams {
+    /**
+     * **REQUIRED** - The phone number to send from. Must be one of your registered
+     * Sendblue phone numbers in E.164 format. Without this parameter, the message will
+     * fail to send.
+     */
+    from_number: string;
+    /**
+     * Recipient phone number in E.164 format
+     */
+    number: string;
+    /**
+     * A Sendblue App Card rendered with Apple's Messages framework. App Cards require
+     * a V2 Mac line and an iMessage-capable recipient; they never fall back to SMS.
+     * The URL is delivered to the identified Messages extension when the recipient
+     * taps the card. An initial App Card may include `reply_to` to create an inline
+     * reply. Later state changes use the update endpoint, which sends a new Apple
+     * message in the same App Card session. The feature is unavailable on the free
+     * plan.
+     */
+    app_card?: MessageSendParams.AppCard;
+    /**
+     * Message text content. Optional when `media_url` or `app_card` is provided.
+     */
+    content?: string;
+    /**
+     * URL of media file to send (images, videos, etc.)
+     */
+    media_url?: string;
+    /**
+     * Optional inline-reply target. This may be combined with `app_card`; the
+     * resulting App Card is sent as an inline reply to the target.
+     */
+    reply_to?: MessageSendParams.ReplyTo;
+    /**
+     * Optional. Identifies the seat (user) sending the message so the message is
+     * attributed to a specific rep. Accepts either the seat UUID or the Firebase Auth
+     * subject. When provided, `sender_email` is auto-populated on the message record
+     * and webhook payloads. Returns 400 if the seat is not found.
+     */
+    seat_id?: string;
+    /**
+     * The iMessage expressive message style
+     */
+    send_style?: 'celebration' | 'shooting_star' | 'fireworks' | 'lasers' | 'love' | 'confetti' | 'balloons' | 'spotlight' | 'echo' | 'invisible' | 'gentle' | 'loud' | 'slam';
+    /**
+     * Webhook URL for message status updates
+     */
+    status_callback?: string;
+}
+export declare namespace MessageSendParams {
+    /**
+     * A Sendblue App Card rendered with Apple's Messages framework. App Cards require
+     * a V2 Mac line and an iMessage-capable recipient; they never fall back to SMS.
+     * The URL is delivered to the identified Messages extension when the recipient
+     * taps the card. An initial App Card may include `reply_to` to create an inline
+     * reply. Later state changes use the update endpoint, which sends a new Apple
+     * message in the same App Card session. The feature is unavailable on the free
+     * plan.
+     */
+    interface AppCard {
+        appName: string;
+        extensionBundleId: string;
+        /**
+         * Visible card fields mirroring Apple's MSMessageTemplateLayout.
+         */
+        layout: AppCard.Layout;
+        teamId: string;
+        /**
+         * URL delivered to the iMessage extension on tap. HTTPS URLs are limited to 2048
+         * characters; data URLs carrying inline app state are limited to 16384.
+         */
+        url: string;
+        /**
+         * Optional numeric App Store ID for recipients without the extension.
+         */
+        appStoreId?: number;
+        /**
+         * Fallback text for notifications and surfaces that cannot render the card.
+         */
+        fallbackText?: string;
+        /**
+         * Use Apple's live layout when the extension is installed; false always sends the
+         * static template layout.
+         */
+        interactive?: boolean;
+        /**
+         * Optional caller-supplied App Card session UUID. Generated automatically when
+         * omitted.
+         */
+        sessionIdentifier?: string;
+    }
+    namespace AppCard {
+        /**
+         * Visible card fields mirroring Apple's MSMessageTemplateLayout.
+         */
+        interface Layout {
+            caption?: string;
+            /**
+             * Secondary text overlaid on the preview image. Requires imageUrl.
+             */
+            imageSubtitle?: string;
+            /**
+             * Text overlaid on the preview image. Requires imageUrl.
+             */
+            imageTitle?: string;
+            /**
+             * HTTPS preview image fetched by the worker and sent as a hidden card attachment.
+             * JPEG, PNG, HEIC, HEIF, and WebP are supported up to 10 MB.
+             */
+            imageUrl?: string;
+            subcaption?: string;
+            /**
+             * Fallback text used in notifications and non-rendering surfaces.
+             */
+            summary?: string;
+            trailingCaption?: string;
+            trailingSubcaption?: string;
+        }
+    }
+    /**
+     * Optional inline-reply target. This may be combined with `app_card`; the
+     * resulting App Card is sent as an inline reply to the target.
+     */
+    interface ReplyTo {
+        /**
+         * Public handle of the immediate parent message
+         */
+        message_handle: string;
+        /**
+         * Advanced override for a known part of a multipart target. Omit this in normal
+         * reply requests and never guess it; requests default to 0. When replying to an
+         * attachment represented by its own webhook, use that webhook's `message_handle`
+         * and omit `part_index` so Sendblue can use the stored authoritative part.
+         * Responses omit it when no authoritative immediate-parent part is available.
+         */
+        part_index?: number;
+    }
+}
+export interface MessageUpdateAppCardParams {
+    /**
+     * Replacement fallback text for notifications and non-rendering surfaces.
+     */
+    fallback_text?: string;
+    /**
+     * Reusing this key for the same App Card target returns the original update
+     * instead of sending again.
+     */
+    idempotency_key?: string;
+    interactive?: boolean;
+    /**
+     * Visible card fields mirroring Apple's MSMessageTemplateLayout.
+     */
+    layout?: MessageUpdateAppCardParams.Layout;
+    /**
+     * The iMessage expressive message style for this update.
+     */
+    send_style?: 'celebration' | 'shooting_star' | 'fireworks' | 'lasers' | 'love' | 'confetti' | 'balloons' | 'spotlight' | 'echo' | 'invisible' | 'gentle' | 'loud' | 'slam';
+    url?: string;
+}
+export declare namespace MessageUpdateAppCardParams {
+    /**
+     * Visible card fields mirroring Apple's MSMessageTemplateLayout.
+     */
+    interface Layout {
+        caption?: string;
+        /**
+         * Secondary text overlaid on the preview image. Requires imageUrl.
+         */
+        imageSubtitle?: string;
+        /**
+         * Text overlaid on the preview image. Requires imageUrl.
+         */
+        imageTitle?: string;
+        /**
+         * HTTPS preview image fetched by the worker and sent as a hidden card attachment.
+         * JPEG, PNG, HEIC, HEIF, and WebP are supported up to 10 MB.
+         */
+        imageUrl?: string;
+        subcaption?: string;
+        /**
+         * Fallback text used in notifications and non-rendering surfaces.
+         */
+        summary?: string;
+        trailingCaption?: string;
+        trailingSubcaption?: string;
+    }
+}
+export declare namespace Messages {
+    export { type MessageContent as MessageContent, type MessageResponse as MessageResponse, type MessageRetrieveResponse as MessageRetrieveResponse, type MessageListResponse as MessageListResponse, type MessageListParams as MessageListParams, type MessageGetStatusParams as MessageGetStatusParams, type MessageSendParams as MessageSendParams, type MessageUpdateAppCardParams as MessageUpdateAppCardParams, };
+    export { V2 as V2 };
+}
+//# sourceMappingURL=messages.d.ts.map