sentdm 0.32.0 → 0.34.0

data/lib/sentdm/models/message_retrieve_status_response.rb

@@ -5,7 +5,12 @@ module Sentdm
     # @see Sentdm::Resources::Messages#retrieve_status
     class MessageRetrieveStatusResponse < Sentdm::Internal::Type::BaseModel
       # @!attribute data
-      #   Message response for v3 API — same shape as v2 with snake_case JSON conventions
+      #   Message response for v3 API — same shape as v2 with snake_case JSON conventions.
+      #
+      #   The shape of a message that was sent immediately: it never has a scheduled_at
+      #   key. A message that is or was held for a later instant is a
+      #   ScheduledMessageResponse, and the endpoint decides which of the two to answer
+      #   with. From always returns this type.
       #
       #   @return [Sentdm::Models::MessageRetrieveStatusResponse::Data, nil]
       optional :data, -> { Sentdm::Models::MessageRetrieveStatusResponse::Data }, nil?: true
@@ -29,9 +34,12 @@ module Sentdm
       optional :success, Sentdm::Internal::Type::Boolean
 
       # @!method initialize(data: nil, error: nil, meta: nil, success: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::MessageRetrieveStatusResponse} for more details.
+      #
       #   Standard API response envelope for all v3 endpoints
       #
-      #   @param data [Sentdm::Models::MessageRetrieveStatusResponse::Data, nil] Message response for v3 API — same shape as v2 with snake_case JSON conventions
+      #   @param data [Sentdm::Models::MessageRetrieveStatusResponse::Data, nil] Message response for v3 API — same shape as v2 with snake_case JSON conventions.
       #
       #   @param error [Sentdm::Models::ErrorDetail, nil] Error information
       #
@@ -85,7 +93,14 @@ module Sentdm
 
         # @!attribute message_body
         #   Structured message body format for database storage. Preserves channel-specific
-        #   components (header, body, footer, buttons).
+        #   components (header, header media, body, footer, buttons, MMS subject and media).
+        #
+        #   Persisted as the messageBody jsonb column on Messages. Every write path goes
+        #   through MessageUtils.MessageBodyJsonOptions, which writes nulls, so the envelope
+        #   shape is stable regardless of channel or status. Anything that rebuilds this
+        #   object field by field — the four IMessageBodyStrategy implementations and
+        #   MessageUtils.BuildSegmentBody — has to carry every member, or that member is
+        #   silently dropped on whichever path forgot it.
         #
         #   @return [Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody, nil]
         optional :message_body,
@@ -107,6 +122,24 @@ module Sentdm
         #   @return [Float, nil]
         optional :price, Float, nil?: true
 
+        # @!attribute reason
+        #   A human-readable sentence for reason_code, for example "Insufficient balance".
+        #   Omitted whenever reason_code is.
+        #
+        #   @return [String, nil]
+        optional :reason, String, nil?: true
+
+        # @!attribute reason_code
+        #   Why the message is at its current status, as a stable platform code such as
+        #   DELIVERY_007, BUSINESS_003 or DELIVERY_003. Present when the current status is
+        #   FAILED, FILTERED or BLOCKED and the lifecycle was loaded; omitted otherwise.
+        #   Switch on this rather than on reason: the code is stable, the wording may be
+        #   improved. It is the platform's classification of the outcome, never a carrier or
+        #   vendor code.
+        #
+        #   @return [String, nil]
+        optional :reason_code, String, nil?: true
+
         # @!attribute region_code
         #
         #   @return [String, nil]
@@ -132,11 +165,16 @@ module Sentdm
         #   @return [String, nil]
         optional :template_name, String, nil?: true
 
-        # @!method initialize(id: nil, active_contact_price: nil, channel: nil, contact_id: nil, created_at: nil, customer_id: nil, direction: nil, events: nil, message_body: nil, phone: nil, phone_international: nil, price: nil, region_code: nil, status: nil, template_category: nil, template_id: nil, template_name: nil)
+        # @!method initialize(id: nil, active_contact_price: nil, channel: nil, contact_id: nil, created_at: nil, customer_id: nil, direction: nil, events: nil, message_body: nil, phone: nil, phone_international: nil, price: nil, reason: nil, reason_code: nil, region_code: nil, status: nil, template_category: nil, template_id: nil, template_name: nil)
         #   Some parameter documentations has been truncated, see
         #   {Sentdm::Models::MessageRetrieveStatusResponse::Data} for more details.
         #
-        #   Message response for v3 API — same shape as v2 with snake_case JSON conventions
+        #   Message response for v3 API — same shape as v2 with snake_case JSON conventions.
+        #
+        #   The shape of a message that was sent immediately: it never has a scheduled_at
+        #   key. A message that is or was held for a later instant is a
+        #   ScheduledMessageResponse, and the endpoint decides which of the two to answer
+        #   with. From always returns this type.
         #
         #   @param id [String]
         #
@@ -162,6 +200,10 @@ module Sentdm
         #
         #   @param price [Float, nil]
         #
+        #   @param reason [String, nil] A human-readable sentence for reason_code, for example "Insufficient balance". O
+        #
+        #   @param reason_code [String, nil] Why the message is at its current status, as a stable platform code such as
+        #
         #   @param region_code [String]
         #
         #   @param status [String]
@@ -188,12 +230,37 @@ module Sentdm
           #   @return [String, nil]
           optional :description, String, nil?: true
 
-          # @!method initialize(status:, timestamp:, description: nil)
+          # @!attribute reason
+          #   A human-readable sentence for reason_code. Omitted whenever reason_code is.
+          #
+          #   @return [String, nil]
+          optional :reason, String, nil?: true
+
+          # @!attribute reason_code
+          #   Why the message reached this status, as a stable platform code such as
+          #   DELIVERY_007. Present on FAILED, FILTERED and BLOCKED events; omitted on every
+          #   status that needs no explanation. Same wire name and vocabulary as on the
+          #   activities list and the webhook.
+          #
+          #   @return [String, nil]
+          optional :reason_code, String, nil?: true
+
+          # @!method initialize(status:, timestamp:, description: nil, reason: nil, reason_code: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Sentdm::Models::MessageRetrieveStatusResponse::Data::Event} for more details.
+          #
           #   Represents a status change event in a message's lifecycle (v3)
           #
           #   @param status [String]
+          #
           #   @param timestamp [Time]
+          #
           #   @param description [String, nil]
+          #
+          #   @param reason [String, nil] A human-readable sentence for reason_code. Omitted whenever reason_code is.
+          #
+          #   @param reason_code [String, nil] Why the message reached this status, as a stable platform code such as
+          #   DELIVERY\_
         end
 
         # @see Sentdm::Models::MessageRetrieveStatusResponse::Data#message_body
@@ -220,14 +287,63 @@ module Sentdm
           #   @return [String, nil]
           optional :header, String, nil?: true
 
-          # @!method initialize(buttons: nil, content: nil, footer: nil, header: nil)
+          # @!attribute header_media
+          #   The media asset that rode a message's header, recorded as sent.
+          #
+          #   @return [Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::HeaderMedia, nil]
+          optional :header_media,
+                   -> { Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::HeaderMedia },
+                   api_name: :headerMedia,
+                   nil?: true
+
+          # @!attribute media
+          #   MMS attachments, as the publicly fetchable URLs handed to the carrier. Null on
+          #   every other channel.
+          #
+          #   Persisted rather than derived because a resend and a curfew release rebuild the
+          #   send from the stored row — MessageReplayCommandBuilder reads templateId and
+          #   templateVariables and nothing else — so media that lives only on the original
+          #   request would silently turn a replayed MMS into a text message.
+          #
+          #   @return [Array<Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Media>, nil]
+          optional :media,
+                   -> { Sentdm::Internal::Type::ArrayOf[Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Media] },
+                   nil?: true
+
+          # @!attribute subject
+          #   MMS subject line. Null on every other channel.
+          #
+          #   @return [String, nil]
+          optional :subject, String, nil?: true
+
+          # @!method initialize(buttons: nil, content: nil, footer: nil, header: nil, header_media: nil, media: nil, subject: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody} for more
+          #   details.
+          #
           #   Structured message body format for database storage. Preserves channel-specific
-          #   components (header, body, footer, buttons).
+          #   components (header, header media, body, footer, buttons, MMS subject and media).
+          #
+          #   Persisted as the messageBody jsonb column on Messages. Every write path goes
+          #   through MessageUtils.MessageBodyJsonOptions, which writes nulls, so the envelope
+          #   shape is stable regardless of channel or status. Anything that rebuilds this
+          #   object field by field — the four IMessageBodyStrategy implementations and
+          #   MessageUtils.BuildSegmentBody — has to carry every member, or that member is
+          #   silently dropped on whichever path forgot it.
           #
           #   @param buttons [Array<Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Button>, nil]
+          #
           #   @param content [String]
+          #
           #   @param footer [String, nil]
+          #
           #   @param header [String, nil]
+          #
+          #   @param header_media [Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::HeaderMedia, nil] The media asset that rode a message's header, recorded as sent.
+          #
+          #   @param media [Array<Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Media>, nil] MMS attachments, as the publicly fetchable URLs handed to the carrier. Null on e
+          #
+          #   @param subject [String, nil] MMS subject line. Null on every other channel.
 
           class Button < Sentdm::Internal::Type::BaseModel
             # @!attribute postback_data
@@ -256,6 +372,104 @@ module Sentdm
             #   @param type [String]
             #   @param value [String]
           end
+
+          # @see Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody#header_media
+          class HeaderMedia < Sentdm::Internal::Type::BaseModel
+            # @!attribute type
+            #   "image", "video" or "document" — taken from the header's media variable.
+            #
+            #   @return [String, nil]
+            optional :type, String
+
+            # @!attribute url
+            #   The https URL the caller supplied for this send. Never the template's stored
+            #   props.sample, which is Meta's expiring header_handle rather than what was
+            #   delivered.
+            #
+            #   @return [String, nil]
+            optional :url, String
+
+            # @!method initialize(type: nil, url: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::HeaderMedia}
+            #   for more details.
+            #
+            #   The media asset that rode a message's header, recorded as sent.
+            #
+            #   @param type [String] "image", "video" or "document" — taken from the header's media variable.
+            #
+            #   @param url [String] The https URL the caller supplied for this send. Never the template's stored
+          end
+
+          class Media < Sentdm::Internal::Type::BaseModel
+            # @!attribute media_type
+            #   One of MmsMediaTypes when the content type is known. Advisory — a reader should
+            #   trust the fetched object's own Content-Type.
+            #
+            #   @return [String, nil]
+            optional :media_type, String, api_name: :mediaType, nil?: true
+
+            # @!attribute mime_type
+            #   Content type as the provider declared it. Null when it declared none.
+            #
+            #   @return [String, nil]
+            optional :mime_type, String, api_name: :mimeType, nil?: true
+
+            # @!attribute size_bytes
+            #   Size as the provider declared it. Never measured here — nothing downloads the
+            #   file.
+            #
+            #   @return [Integer, nil]
+            optional :size_bytes, Integer, api_name: :sizeBytes, nil?: true
+
+            # @!attribute source_hash_sha256
+            #   Inbound only: the SHA-256 the provider declared alongside the attachment, when
+            #   it declared one. Relayed to the customer so they can verify what they fetch
+            #   matches what the carrier said it sent. It is the only integrity signal available
+            #   on an attachment nobody here has read.
+            #
+            #   @return [String, nil]
+            optional :source_hash_sha256, String, api_name: :sourceHashSha256, nil?: true
+
+            # @!attribute url
+            #   Where the file lives. Outbound: the URL the customer gave us and the carrier
+            #   fetched. Inbound: the URL the carrier hosts it at, relayed unchanged.
+            #
+            #   @return [String, nil]
+            optional :url, String, nil?: true
+
+            # @!method initialize(media_type: nil, mime_type: nil, size_bytes: nil, source_hash_sha256: nil, url: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Media} for
+            #   more details.
+            #
+            #   One attachment on a message, in either direction — and in both, a URL somebody
+            #   else hosts.
+            #
+            #   Outbound: the customer supplied a public URL and we handed it to the carrier.
+            #   Inbound: the carrier hosts the file and we record where. sent.dm never holds the
+            #   bytes, so there is no key, no expiry bookkeeping and nothing minted per read —
+            #   what is stored is what is served.
+            #
+            #   An inbound link expires on the carrier's own schedule and is unauthenticated.
+            #   That is the customer's to manage, and it is documented where they will see it
+            #   rather than only here — a recipient who needs an attachment to outlive that
+            #   window copies it on receipt.
+            #
+            #   Storing a presigned URL is the specific mistake this shape still avoids:
+            #   M260826130000 and M260826140000 exist because RCS assets were stored as signed
+            #   URLs and went stale. Nothing here is signed.
+            #
+            #   @param media_type [String, nil] One of MmsMediaTypes when the content type is known. Advisory — a reader should
+            #
+            #   @param mime_type [String, nil] Content type as the provider declared it. Null when it declared none.
+            #
+            #   @param size_bytes [Integer, nil] Size as the provider declared it. Never measured here — nothing downloads the fi
+            #
+            #   @param source_hash_sha256 [String, nil] Inbound only: the SHA-256 the provider declared alongside the attachment, when i
+            #
+            #   @param url [String, nil] Where the file lives. Outbound: the URL the customer gave us and the carrier fet
+          end
         end
       end
     end

data/lib/sentdm/models/message_send_params.rb

@@ -15,6 +15,25 @@ module Sentdm
       #   @return [Array<String>, nil]
       optional :channel, Sentdm::Internal::Type::ArrayOf[String], nil?: true
 
+      # @!attribute media_urls
+      #   Attachments for this send, as publicly fetchable https URLs. Used by the MMS
+      #   channel and ignored by every other one.
+      #
+      #   Supplying these replaces the media on the template's mms body rather than adding
+      #   to it, so a template can hold a default creative while a caller still sends
+      #   something recipient-specific.
+      #
+      #   Their presence is also what makes a message eligible for MMS on an auto-detect
+      #   send: a message with nothing attached is delivered as SMS, because an MMS with
+      #   no media is a more expensive text message.
+      #
+      #   The recipient's carrier fetches each URL after the send is accepted, so it must
+      #   stay publicly reachable — a link that expires, or one behind auth, arrives as a
+      #   failed message.
+      #
+      #   @return [Array<String>, nil]
+      optional :media_urls, Sentdm::Internal::Type::ArrayOf[String], nil?: true
+
       # @!attribute sandbox
       #   Sandbox flag - when true, the operation is simulated without side effects Useful
       #   for testing integrations without actual execution
@@ -22,6 +41,29 @@ module Sentdm
       #   @return [Boolean, nil]
       optional :sandbox, Sentdm::Internal::Type::Boolean
 
+      # @!attribute scheduled_at
+      #   Optional future send time as an ISO-8601 timestamp with an explicit UTC offset,
+      #   e.g. 2026-10-01T09:00:00+02:00 or 2026-10-01T07:00:00Z. A value without an
+      #   offset is rejected (400) rather than read in the server's zone. The offset only
+      #   fixes the instant: it is stored and echoed in UTC as scheduled_at. Omit to send
+      #   now. Must be at least one minute ahead and at most 30 days ahead. Accepted
+      #   messages report SCHEDULED and are released for delivery at this time. Quiet
+      #   hours, balance and template approval are evaluated at release, not at
+      #   acceptance: a message whose time falls inside a recipient's protected
+      #   quiet-hours window is moved to the next allowed time and a second
+      #   message.scheduled webhook reports the new scheduled_at.
+      #
+      #   @return [Time, nil]
+      optional :scheduled_at, Time, nil?: true
+
+      # @!attribute subject
+      #   Subject line for this send, overriding the template's. MMS only; ignored on
+      #   every other channel. Most handsets render it above the body, some ignore it
+      #   entirely.
+      #
+      #   @return [String, nil]
+      optional :subject, String, nil?: true
+
       # @!attribute template
       #   SDK-style template reference: resolve by ID or by name, with optional
       #   parameters.
@@ -51,14 +93,20 @@ module Sentdm
       #   @return [String, nil]
       optional :x_profile_id, String
 
-      # @!method initialize(channel: nil, sandbox: nil, template: nil, text: nil, to: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
+      # @!method initialize(channel: nil, media_urls: nil, sandbox: nil, scheduled_at: nil, subject: nil, template: nil, text: nil, to: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::MessageSendParams} for more details.
       #
       #   @param channel [Array<String>, nil] Channels to broadcast on, e.g. ["whatsapp", "sms"].
       #
+      #   @param media_urls [Array<String>, nil] Attachments for this send, as publicly fetchable https URLs. Used by the MMS cha
+      #
       #   @param sandbox [Boolean] Sandbox flag - when true, the operation is simulated without side effects
       #
+      #   @param scheduled_at [Time, nil] Optional future send time as an ISO-8601 timestamp with an explicit UTC offset,
+      #
+      #   @param subject [String, nil] Subject line for this send, overriding the template's. MMS only; ignored on ever
+      #
       #   @param template [Sentdm::Models::MessageSendParams::Template, nil] SDK-style template reference: resolve by ID or by name, with optional parameters
       #
       #   @param text [String, nil] Plain-text (free-form) message body. Provide either Template or this.
@@ -85,12 +133,28 @@ module Sentdm
         optional :name, String, nil?: true
 
         # @!attribute parameters
-        #   Template variable parameters for personalization
+        #   Template variable parameters for personalization, keyed by variable name.
+        #
+        #   Every variable the template declares is required; GET /v3/templates/{id} lists
+        #   them. Supplying a key the template does not declare is ignored.
+        #
+        #   Media headers. A template whose header is an image (designed in WhatsApp Manager
+        #   and imported into Sent) declares a reserved header_image key. Its value is a
+        #   publicly reachable https URL that Meta fetches at send time — Sent does not host
+        #   the asset, and the sample approved with the template is not reused. The key is
+        #   derived from the header's media type, so header_video and header_document follow
+        #   the same shape when those formats ship.
+        #
+        #   "parameters": { "header_image": "https://cdn.example.com/banner.jpg", "name":
+        #   "John Doe" }
         #
         #   @return [Hash{Symbol=>String}, nil]
         optional :parameters, Sentdm::Internal::Type::HashOf[String], nil?: true
 
         # @!method initialize(id: nil, name: nil, parameters: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Sentdm::Models::MessageSendParams::Template} for more details.
+        #
         #   SDK-style template reference: resolve by ID or by name, with optional
         #   parameters.
         #
@@ -98,7 +162,7 @@ module Sentdm
         #
         #   @param name [String, nil] Template name (mutually exclusive with id)
         #
-        #   @param parameters [Hash{Symbol=>String}, nil] Template variable parameters for personalization
+        #   @param parameters [Hash{Symbol=>String}, nil] Template variable parameters for personalization, keyed by variable name.
       end
     end
   end

data/lib/sentdm/models/message_send_response.rb

@@ -14,7 +14,9 @@ module Sentdm
       #   its result; this is what a caller sees, and the mapping between them is a
       #   decision the endpoint makes.
       #
-      #   The wire is unchanged by the move: same names, same values.
+      #   The shape of an immediate send: it never has a scheduled_at key. A send that
+      #   carried scheduled_at is a ScheduledSendMessageResponse, and the endpoint decides
+      #   which of the two to answer with. From always returns this type.
       #
       #   @return [Sentdm::Models::MessageSendResponse::Data, nil]
       optional :data, -> { Sentdm::Models::MessageSendResponse::Data }, nil?: true
@@ -60,7 +62,9 @@ module Sentdm
                  -> { Sentdm::Internal::Type::ArrayOf[Sentdm::Models::MessageSendResponse::Data::Recipient] }
 
         # @!attribute status
-        #   Overall status — QUEUED once the batch is accepted for delivery.
+        #   QUEUED: the batch is accepted. A request that carried scheduled_at is QUEUED
+        #   here too; each message moves to SCHEDULED once it is held, as GET
+        #   /v3/messages/{id} and the message.scheduled webhook report.
         #
         #   @return [String, nil]
         optional :status, String
@@ -76,6 +80,9 @@ module Sentdm
         optional :template_name, String
 
         # @!method initialize(recipients: nil, status: nil, template_id: nil, template_name: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Sentdm::Models::MessageSendResponse::Data} for more details.
+        #
         #   The result of a multi-recipient send.
         #
         #   Declared here rather than in the service layer. POST /v3/messages used to
@@ -85,11 +92,13 @@ module Sentdm
         #   its result; this is what a caller sees, and the mapping between them is a
         #   decision the endpoint makes.
         #
-        #   The wire is unchanged by the move: same names, same values.
+        #   The shape of an immediate send: it never has a scheduled_at key. A send that
+        #   carried scheduled_at is a ScheduledSendMessageResponse, and the endpoint decides
+        #   which of the two to answer with. From always returns this type.
         #
         #   @param recipients [Array<Sentdm::Models::MessageSendResponse::Data::Recipient>]
         #
-        #   @param status [String] Overall status — QUEUED once the batch is accepted for delivery.
+        #   @param status [String] QUEUED: the batch is accepted. A request that carried scheduled_at is QUEUED
         #
         #   @param template_id [String]
         #

data/lib/sentdm/models/template_body.rb

@@ -3,6 +3,18 @@
 module Sentdm
   module Models
     class TemplateBody < Sentdm::Internal::Type::BaseModel
+      # @!attribute mms
+      #   MMS-specific content — subject, text and attachments.
+      #
+      #   Like Rcs, an override that cannot stand on its own: a template still needs a
+      #   MultiChannel body or the Sms + Whatsapp pair to be deliverable at all. Unlike
+      #   Rcs, it has no fallback at send time — MMS with no media is a more expensive
+      #   SMS, so a template without this slot is deliberately not MMS-capable and never
+      #   produces an MMS route candidate.
+      #
+      #   @return [Sentdm::Models::TemplateBody::Mms, nil]
+      optional :mms, -> { Sentdm::TemplateBody::Mms }, nil?: true
+
       # @!attribute multi_channel
       #   The shared body, used for every channel. One half of the choice described above.
       #
@@ -29,7 +41,7 @@ module Sentdm
       #   @return [Sentdm::Models::TemplateBodyContent, nil]
       optional :whatsapp, -> { Sentdm::TemplateBodyContent }, nil?: true
 
-      # @!method initialize(multi_channel: nil, rcs: nil, sms: nil, whatsapp: nil)
+      # @!method initialize(mms: nil, multi_channel: nil, rcs: nil, sms: nil, whatsapp: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::TemplateBody} for more details.
       #
@@ -44,6 +56,8 @@ module Sentdm
       #   channel. rcs is the one true override: it may accompany either strategy to vary
       #   the copy, but cannot stand alone.
       #
+      #   @param mms [Sentdm::Models::TemplateBody::Mms, nil] MMS-specific content — subject, text and attachments.
+      #
       #   @param multi_channel [Sentdm::Models::TemplateBodyContent, nil] The shared body, used for every channel. One half of the choice described above.
       #
       #   @param rcs [Sentdm::Models::TemplateBodyContent, nil] RCS-specific copy that overrides the chosen strategy for RCS only. The one true
@@ -51,6 +65,73 @@ module Sentdm
       #   @param sms [Sentdm::Models::TemplateBodyContent, nil] The SMS body. It does not override multiChannel, it replaces it.
       #
       #   @param whatsapp [Sentdm::Models::TemplateBodyContent, nil] The WhatsApp body. It does not override multiChannel, it replaces it.
+
+      # @see Sentdm::Models::TemplateBody#mms
+      class Mms < Sentdm::Models::TemplateBodyContent
+        # @!attribute media
+        #   Attachments carried by every send on this template, in order. A per-send
+        #   media_urls on the request replaces this list rather than adding to it, so a
+        #   template can hold a default creative and a caller can still send something
+        #   recipient-specific.
+        #
+        #   @return [Array<Sentdm::Models::TemplateBody::Mms::Media>, nil]
+        optional :media, -> { Sentdm::Internal::Type::ArrayOf[Sentdm::TemplateBody::Mms::Media] }, nil?: true
+
+        # @!attribute subject
+        #   MMS subject line. Optional — most handsets render it above the body, some ignore
+        #   it entirely. Deliberately its own field rather than riding TemplateHeader: the
+        #   header is authored once and shared across every channel, and carries Meta's
+        #   60-character cap plus its no-newline, no-emoji text rules, none of which
+        #   describe an MMS subject.
+        #
+        #   @return [String, nil]
+        optional :subject, String, nil?: true
+
+        # @!method initialize(media: nil, subject: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Sentdm::Models::TemplateBody::Mms} for more details.
+        #
+        #   MMS-specific content — subject, text and attachments.
+        #
+        #   Like Rcs, an override that cannot stand on its own: a template still needs a
+        #   MultiChannel body or the Sms + Whatsapp pair to be deliverable at all. Unlike
+        #   Rcs, it has no fallback at send time — MMS with no media is a more expensive
+        #   SMS, so a template without this slot is deliberately not MMS-capable and never
+        #   produces an MMS route candidate.
+        #
+        #   @param media [Array<Sentdm::Models::TemplateBody::Mms::Media>, nil] Attachments carried by every send on this template, in order. A per-send media_u
+        #
+        #   @param subject [String, nil] MMS subject line. Optional — most handsets render it above the body, some ignore
+
+        class Media < Sentdm::Internal::Type::BaseModel
+          # @!attribute media_type
+          #   One of MmsMediaTypes. Advisory: the carrier reads the Content-Type off the
+          #   fetched object, not this field. It exists so an authoring UI can render the
+          #   right preview and so a reviewer can see what was intended.
+          #
+          #   @return [String, nil]
+          optional :media_type, String, api_name: :mediaType, nil?: true
+
+          # @!attribute url
+          #   Publicly fetchable https URL. The carrier's MMSC fetches this at send time, so
+          #   it has to stay reachable and unauthenticated for the life of the send —
+          #   including retries and a DLQ replay — which is why a presigned URL is not a valid
+          #   value here.
+          #
+          #   @return [String, nil]
+          optional :url, String
+
+          # @!method initialize(media_type: nil, url: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Sentdm::Models::TemplateBody::Mms::Media} for more details.
+          #
+          #   One attachment on an MMS template body.
+          #
+          #   @param media_type [String, nil] One of MmsMediaTypes. Advisory: the carrier reads the Content-Type off the
+          #
+          #   @param url [String] Publicly fetchable https URL. The carrier's MMSC fetches this at send time, so i
+        end
+      end
     end
   end
 end

data/lib/sentdm/models/template_create_params.rb

@@ -7,6 +7,14 @@ module Sentdm
       extend Sentdm::Internal::Type::RequestParameters::Converter
       include Sentdm::Internal::Type::RequestParameters
 
+      # @!attribute auto_create_for_sp
+      #   Create this template automatically on every sender profile of the organization,
+      #   now and in future (default: false). Accepted only from an organization that has
+      #   been enabled for it, and only at creation — it cannot be changed afterwards.
+      #
+      #   @return [Boolean, nil]
+      optional :auto_create_for_sp, Sentdm::Internal::Type::Boolean
+
       # @!attribute category
       #   Template category: MARKETING, UTILITY, AUTHENTICATION (optional, auto-detected
       #   if not provided)
@@ -56,10 +64,12 @@ module Sentdm
       #   @return [String, nil]
       optional :x_profile_id, String
 
-      # @!method initialize(category: nil, creation_source: nil, definition: nil, language: nil, sandbox: nil, submit_for_review: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
+      # @!method initialize(auto_create_for_sp: nil, category: nil, creation_source: nil, definition: nil, language: nil, sandbox: nil, submit_for_review: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::TemplateCreateParams} for more details.
       #
+      #   @param auto_create_for_sp [Boolean] Create this template automatically on every sender profile of the organization,
+      #
       #   @param category [String, nil] Template category: MARKETING, UTILITY, AUTHENTICATION (optional, auto-detected i
       #
       #   @param creation_source [String, nil] Source of template creation (default: from-api)