prelude-sdk 0.1.0 → 0.3.0

data/lib/prelude_sdk/models/notify_list_subscription_configs_response.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#list_subscription_configs
+    class NotifyListSubscriptionConfigsResponse < PreludeSDK::Internal::Type::BaseModel
+      # @!attribute configs
+      #   A list of subscription management configurations.
+      #
+      #   @return [Array<PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config>]
+      required :configs,
+               -> { PreludeSDK::Internal::Type::ArrayOf[PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config] }
+
+      # @!attribute next_cursor
+      #   Pagination cursor for the next page of results. Omitted if there are no more
+      #   pages.
+      #
+      #   @return [String, nil]
+      optional :next_cursor, String
+
+      # @!method initialize(configs:, next_cursor: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {PreludeSDK::Models::NotifyListSubscriptionConfigsResponse} for more details.
+      #
+      #   @param configs [Array<PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config>] A list of subscription management configurations.
+      #
+      #   @param next_cursor [String] Pagination cursor for the next page of results. Omitted if there are no more pag
+
+      class Config < PreludeSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The subscription configuration ID.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute callback_url
+        #   The URL to call when subscription status changes.
+        #
+        #   @return [String]
+        required :callback_url, String
+
+        # @!attribute created_at
+        #   The date and time when the configuration was created.
+        #
+        #   @return [Time]
+        required :created_at, Time
+
+        # @!attribute messages
+        #   The subscription messages configuration.
+        #
+        #   @return [PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config::Messages]
+        required :messages, -> { PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config::Messages }
+
+        # @!attribute name
+        #   The human-readable name for the subscription configuration.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute updated_at
+        #   The date and time when the configuration was last updated.
+        #
+        #   @return [Time]
+        required :updated_at, Time
+
+        # @!attribute mo_phone_numbers
+        #   A list of phone numbers for receiving inbound messages.
+        #
+        #   @return [Array<PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config::MoPhoneNumber>, nil]
+        optional :mo_phone_numbers,
+                 -> { PreludeSDK::Internal::Type::ArrayOf[PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config::MoPhoneNumber] }
+
+        # @!method initialize(id:, callback_url:, created_at:, messages:, name:, updated_at:, mo_phone_numbers: nil)
+        #   @param id [String] The subscription configuration ID.
+        #
+        #   @param callback_url [String] The URL to call when subscription status changes.
+        #
+        #   @param created_at [Time] The date and time when the configuration was created.
+        #
+        #   @param messages [PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config::Messages] The subscription messages configuration.
+        #
+        #   @param name [String] The human-readable name for the subscription configuration.
+        #
+        #   @param updated_at [Time] The date and time when the configuration was last updated.
+        #
+        #   @param mo_phone_numbers [Array<PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config::MoPhoneNumber>] A list of phone numbers for receiving inbound messages.
+
+        # @see PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config#messages
+        class Messages < PreludeSDK::Internal::Type::BaseModel
+          # @!attribute help_message
+          #   Message sent when user requests help.
+          #
+          #   @return [String, nil]
+          optional :help_message, String
+
+          # @!attribute start_message
+          #   Message sent when user subscribes.
+          #
+          #   @return [String, nil]
+          optional :start_message, String
+
+          # @!attribute stop_message
+          #   Message sent when user unsubscribes.
+          #
+          #   @return [String, nil]
+          optional :stop_message, String
+
+          # @!method initialize(help_message: nil, start_message: nil, stop_message: nil)
+          #   The subscription messages configuration.
+          #
+          #   @param help_message [String] Message sent when user requests help.
+          #
+          #   @param start_message [String] Message sent when user subscribes.
+          #
+          #   @param stop_message [String] Message sent when user unsubscribes.
+        end
+
+        class MoPhoneNumber < PreludeSDK::Internal::Type::BaseModel
+          # @!attribute country_code
+          #   The ISO 3166-1 alpha-2 country code.
+          #
+          #   @return [String]
+          required :country_code, String
+
+          # @!attribute phone_number
+          #   The phone number in E.164 format for long codes, or short code format for short
+          #   codes.
+          #
+          #   @return [String]
+          required :phone_number, String
+
+          # @!method initialize(country_code:, phone_number:)
+          #   Some parameter documentations has been truncated, see
+          #   {PreludeSDK::Models::NotifyListSubscriptionConfigsResponse::Config::MoPhoneNumber}
+          #   for more details.
+          #
+          #   @param country_code [String] The ISO 3166-1 alpha-2 country code.
+          #
+          #   @param phone_number [String] The phone number in E.164 format for long codes, or short code format for short
+        end
+      end
+    end
+  end
+end

data/lib/prelude_sdk/models/notify_list_subscription_phone_number_events_params.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#list_subscription_phone_number_events
+    class NotifyListSubscriptionPhoneNumberEventsParams < PreludeSDK::Internal::Type::BaseModel
+      extend PreludeSDK::Internal::Type::RequestParameters::Converter
+      include PreludeSDK::Internal::Type::RequestParameters
+
+      # @!attribute config_id
+      #
+      #   @return [String]
+      required :config_id, String
+
+      # @!attribute phone_number
+      #
+      #   @return [String]
+      required :phone_number, String
+
+      # @!attribute cursor
+      #   Pagination cursor from the previous response
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute limit
+      #   Maximum number of events to return per page
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!method initialize(config_id:, phone_number:, cursor: nil, limit: nil, request_options: {})
+      #   @param config_id [String]
+      #
+      #   @param phone_number [String]
+      #
+      #   @param cursor [String] Pagination cursor from the previous response
+      #
+      #   @param limit [Integer] Maximum number of events to return per page
+      #
+      #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/prelude_sdk/models/notify_list_subscription_phone_number_events_response.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#list_subscription_phone_number_events
+    class NotifyListSubscriptionPhoneNumberEventsResponse < PreludeSDK::Internal::Type::BaseModel
+      # @!attribute events
+      #   A list of subscription events (status changes) ordered by timestamp descending.
+      #
+      #   @return [Array<PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event>]
+      required :events,
+               -> { PreludeSDK::Internal::Type::ArrayOf[PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event] }
+
+      # @!attribute next_cursor
+      #   Pagination cursor for the next page of results. Omitted if there are no more
+      #   pages.
+      #
+      #   @return [String, nil]
+      optional :next_cursor, String
+
+      # @!method initialize(events:, next_cursor: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse} for more
+      #   details.
+      #
+      #   @param events [Array<PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event>] A list of subscription events (status changes) ordered by timestamp descending.
+      #
+      #   @param next_cursor [String] Pagination cursor for the next page of results. Omitted if there are no more pag
+
+      class Event < PreludeSDK::Internal::Type::BaseModel
+        # @!attribute config_id
+        #   The subscription configuration ID.
+        #
+        #   @return [String]
+        required :config_id, String
+
+        # @!attribute phone_number
+        #   The phone number in E.164 format.
+        #
+        #   @return [String]
+        required :phone_number, String
+
+        # @!attribute source
+        #   How the subscription state was changed:
+        #
+        #   - `MO_KEYWORD` - User sent a keyword (STOP/START)
+        #   - `API` - Changed via API
+        #   - `CSV_IMPORT` - Imported from CSV
+        #   - `CARRIER_DISCONNECT` - Automatically unsubscribed due to carrier disconnect
+        #
+        #   @return [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event::Source]
+        required :source,
+                 enum: -> { PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event::Source }
+
+        # @!attribute state
+        #   The subscription state after this event:
+        #
+        #   - `SUB` - Subscribed (user can receive marketing messages)
+        #   - `UNSUB` - Unsubscribed (user has opted out)
+        #
+        #   @return [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event::State]
+        required :state,
+                 enum: -> { PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event::State }
+
+        # @!attribute timestamp
+        #   The date and time when the event occurred.
+        #
+        #   @return [Time]
+        required :timestamp, Time
+
+        # @!attribute reason
+        #   Additional context about the state change (e.g., the keyword that was sent).
+        #
+        #   @return [String, nil]
+        optional :reason, String
+
+        # @!method initialize(config_id:, phone_number:, source:, state:, timestamp:, reason: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event} for
+        #   more details.
+        #
+        #   @param config_id [String] The subscription configuration ID.
+        #
+        #   @param phone_number [String] The phone number in E.164 format.
+        #
+        #   @param source [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event::Source] How the subscription state was changed:
+        #
+        #   @param state [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event::State] The subscription state after this event:
+        #
+        #   @param timestamp [Time] The date and time when the event occurred.
+        #
+        #   @param reason [String] Additional context about the state change (e.g., the keyword that was sent).
+
+        # How the subscription state was changed:
+        #
+        # - `MO_KEYWORD` - User sent a keyword (STOP/START)
+        # - `API` - Changed via API
+        # - `CSV_IMPORT` - Imported from CSV
+        # - `CARRIER_DISCONNECT` - Automatically unsubscribed due to carrier disconnect
+        #
+        # @see PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event#source
+        module Source
+          extend PreludeSDK::Internal::Type::Enum
+
+          MO_KEYWORD = :MO_KEYWORD
+          API = :API
+          CSV_IMPORT = :CSV_IMPORT
+          CARRIER_DISCONNECT = :CARRIER_DISCONNECT
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # The subscription state after this event:
+        #
+        # - `SUB` - Subscribed (user can receive marketing messages)
+        # - `UNSUB` - Unsubscribed (user has opted out)
+        #
+        # @see PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse::Event#state
+        module State
+          extend PreludeSDK::Internal::Type::Enum
+
+          SUB = :SUB
+          UNSUB = :UNSUB
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/prelude_sdk/models/notify_list_subscription_phone_numbers_params.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#list_subscription_phone_numbers
+    class NotifyListSubscriptionPhoneNumbersParams < PreludeSDK::Internal::Type::BaseModel
+      extend PreludeSDK::Internal::Type::RequestParameters::Converter
+      include PreludeSDK::Internal::Type::RequestParameters
+
+      # @!attribute config_id
+      #
+      #   @return [String]
+      required :config_id, String
+
+      # @!attribute cursor
+      #   Pagination cursor from the previous response
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute limit
+      #   Maximum number of phone numbers to return per page
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute state
+      #   Filter by subscription state
+      #
+      #   @return [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersParams::State, nil]
+      optional :state, enum: -> { PreludeSDK::NotifyListSubscriptionPhoneNumbersParams::State }
+
+      # @!method initialize(config_id:, cursor: nil, limit: nil, state: nil, request_options: {})
+      #   @param config_id [String]
+      #
+      #   @param cursor [String] Pagination cursor from the previous response
+      #
+      #   @param limit [Integer] Maximum number of phone numbers to return per page
+      #
+      #   @param state [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersParams::State] Filter by subscription state
+      #
+      #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
+
+      # Filter by subscription state
+      module State
+        extend PreludeSDK::Internal::Type::Enum
+
+        SUB = :SUB
+        UNSUB = :UNSUB
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/prelude_sdk/models/notify_list_subscription_phone_numbers_response.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#list_subscription_phone_numbers
+    class NotifyListSubscriptionPhoneNumbersResponse < PreludeSDK::Internal::Type::BaseModel
+      # @!attribute phone_numbers
+      #   A list of phone numbers and their subscription statuses.
+      #
+      #   @return [Array<PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber>]
+      required :phone_numbers,
+               -> { PreludeSDK::Internal::Type::ArrayOf[PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber] }
+
+      # @!attribute next_cursor
+      #   Pagination cursor for the next page of results. Omitted if there are no more
+      #   pages.
+      #
+      #   @return [String, nil]
+      optional :next_cursor, String
+
+      # @!method initialize(phone_numbers:, next_cursor: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse} for more
+      #   details.
+      #
+      #   @param phone_numbers [Array<PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber>] A list of phone numbers and their subscription statuses.
+      #
+      #   @param next_cursor [String] Pagination cursor for the next page of results. Omitted if there are no more pag
+
+      class PhoneNumber < PreludeSDK::Internal::Type::BaseModel
+        # @!attribute config_id
+        #   The subscription configuration ID.
+        #
+        #   @return [String]
+        required :config_id, String
+
+        # @!attribute phone_number
+        #   The phone number in E.164 format.
+        #
+        #   @return [String]
+        required :phone_number, String
+
+        # @!attribute source
+        #   How the subscription state was changed:
+        #
+        #   - `MO_KEYWORD` - User sent a keyword (STOP/START)
+        #   - `API` - Changed via API
+        #   - `CSV_IMPORT` - Imported from CSV
+        #   - `CARRIER_DISCONNECT` - Automatically unsubscribed due to carrier disconnect
+        #
+        #   @return [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber::Source]
+        required :source,
+                 enum: -> { PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber::Source }
+
+        # @!attribute state
+        #   The subscription state:
+        #
+        #   - `SUB` - Subscribed (user can receive marketing messages)
+        #   - `UNSUB` - Unsubscribed (user has opted out)
+        #
+        #   @return [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber::State]
+        required :state,
+                 enum: -> { PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber::State }
+
+        # @!attribute updated_at
+        #   The date and time when the subscription status was last updated.
+        #
+        #   @return [Time]
+        required :updated_at, Time
+
+        # @!attribute reason
+        #   Additional context about the state change (e.g., the keyword that was sent).
+        #
+        #   @return [String, nil]
+        optional :reason, String
+
+        # @!method initialize(config_id:, phone_number:, source:, state:, updated_at:, reason: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber}
+        #   for more details.
+        #
+        #   @param config_id [String] The subscription configuration ID.
+        #
+        #   @param phone_number [String] The phone number in E.164 format.
+        #
+        #   @param source [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber::Source] How the subscription state was changed:
+        #
+        #   @param state [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber::State] The subscription state:
+        #
+        #   @param updated_at [Time] The date and time when the subscription status was last updated.
+        #
+        #   @param reason [String] Additional context about the state change (e.g., the keyword that was sent).
+
+        # How the subscription state was changed:
+        #
+        # - `MO_KEYWORD` - User sent a keyword (STOP/START)
+        # - `API` - Changed via API
+        # - `CSV_IMPORT` - Imported from CSV
+        # - `CARRIER_DISCONNECT` - Automatically unsubscribed due to carrier disconnect
+        #
+        # @see PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber#source
+        module Source
+          extend PreludeSDK::Internal::Type::Enum
+
+          MO_KEYWORD = :MO_KEYWORD
+          API = :API
+          CSV_IMPORT = :CSV_IMPORT
+          CARRIER_DISCONNECT = :CARRIER_DISCONNECT
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # The subscription state:
+        #
+        # - `SUB` - Subscribed (user can receive marketing messages)
+        # - `UNSUB` - Unsubscribed (user has opted out)
+        #
+        # @see PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse::PhoneNumber#state
+        module State
+          extend PreludeSDK::Internal::Type::Enum
+
+          SUB = :SUB
+          UNSUB = :UNSUB
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/prelude_sdk/models/notify_send_batch_params.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#send_batch
+    class NotifySendBatchParams < PreludeSDK::Internal::Type::BaseModel
+      extend PreludeSDK::Internal::Type::RequestParameters::Converter
+      include PreludeSDK::Internal::Type::RequestParameters
+
+      # @!attribute template_id
+      #   The template identifier configured by your Customer Success team.
+      #
+      #   @return [String]
+      required :template_id, String
+
+      # @!attribute to
+      #   The list of recipients' phone numbers in E.164 format.
+      #
+      #   @return [Array<String>]
+      required :to, PreludeSDK::Internal::Type::ArrayOf[String]
+
+      # @!attribute callback_url
+      #   The URL where webhooks will be sent for delivery events.
+      #
+      #   @return [String, nil]
+      optional :callback_url, String
+
+      # @!attribute correlation_id
+      #   A user-defined identifier to correlate this request with your internal systems.
+      #
+      #   @return [String, nil]
+      optional :correlation_id, String
+
+      # @!attribute document
+      #   A document to attach to the message. Only supported on WhatsApp templates that
+      #   have a document header.
+      #
+      #   @return [PreludeSDK::Models::NotifySendBatchParams::Document, nil]
+      optional :document, -> { PreludeSDK::NotifySendBatchParams::Document }
+
+      # @!attribute expires_at
+      #   The message expiration date in RFC3339 format. Messages will not be sent after
+      #   this time.
+      #
+      #   @return [Time, nil]
+      optional :expires_at, Time
+
+      # @!attribute from
+      #   The Sender ID. Must be approved for your account.
+      #
+      #   @return [String, nil]
+      optional :from, String
+
+      # @!attribute locale
+      #   A BCP-47 formatted locale string.
+      #
+      #   @return [String, nil]
+      optional :locale, String
+
+      # @!attribute preferred_channel
+      #   Preferred channel for delivery. If unavailable, automatic fallback applies.
+      #
+      #   @return [Symbol, PreludeSDK::Models::NotifySendBatchParams::PreferredChannel, nil]
+      optional :preferred_channel, enum: -> { PreludeSDK::NotifySendBatchParams::PreferredChannel }
+
+      # @!attribute schedule_at
+      #   Schedule delivery in RFC3339 format. Marketing sends may be adjusted to comply
+      #   with local time windows.
+      #
+      #   @return [Time, nil]
+      optional :schedule_at, Time
+
+      # @!attribute variables
+      #   The variables to be replaced in the template.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :variables, PreludeSDK::Internal::Type::HashOf[String]
+
+      # @!method initialize(template_id:, to:, callback_url: nil, correlation_id: nil, document: nil, expires_at: nil, from: nil, locale: nil, preferred_channel: nil, schedule_at: nil, variables: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {PreludeSDK::Models::NotifySendBatchParams} for more details.
+      #
+      #   @param template_id [String] The template identifier configured by your Customer Success team.
+      #
+      #   @param to [Array<String>] The list of recipients' phone numbers in E.164 format.
+      #
+      #   @param callback_url [String] The URL where webhooks will be sent for delivery events.
+      #
+      #   @param correlation_id [String] A user-defined identifier to correlate this request with your internal systems.
+      #
+      #   @param document [PreludeSDK::Models::NotifySendBatchParams::Document] A document to attach to the message. Only supported on WhatsApp templates that h
+      #
+      #   @param expires_at [Time] The message expiration date in RFC3339 format. Messages will not be sent after t
+      #
+      #   @param from [String] The Sender ID. Must be approved for your account.
+      #
+      #   @param locale [String] A BCP-47 formatted locale string.
+      #
+      #   @param preferred_channel [Symbol, PreludeSDK::Models::NotifySendBatchParams::PreferredChannel] Preferred channel for delivery. If unavailable, automatic fallback applies.
+      #
+      #   @param schedule_at [Time] Schedule delivery in RFC3339 format. Marketing sends may be adjusted to comply w
+      #
+      #   @param variables [Hash{Symbol=>String}] The variables to be replaced in the template.
+      #
+      #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
+
+      class Document < PreludeSDK::Internal::Type::BaseModel
+        # @!attribute filename
+        #   The filename to display for the document.
+        #
+        #   @return [String]
+        required :filename, String
+
+        # @!attribute url
+        #   The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!method initialize(filename:, url:)
+        #   A document to attach to the message. Only supported on WhatsApp templates that
+        #   have a document header.
+        #
+        #   @param filename [String] The filename to display for the document.
+        #
+        #   @param url [String] The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+      end
+
+      # Preferred channel for delivery. If unavailable, automatic fallback applies.
+      module PreferredChannel
+        extend PreludeSDK::Internal::Type::Enum
+
+        SMS = :sms
+        WHATSAPP = :whatsapp
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end