sentdm 0.44.0 → 0.46.0

data/lib/sentdm/models/sender_profile_retrieve_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    # @see Sentdm::Resources::SenderProfiles#retrieve
+    class SenderProfileRetrieveParams < Sentdm::Internal::Type::BaseModel
+      extend Sentdm::Internal::Type::RequestParameters::Converter
+      include Sentdm::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
+      #   @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/sentdm/models/sender_profile_sms.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class SenderProfileSMS < Sentdm::Internal::Type::BaseModel
+      # @!attribute country
+      #   ISO 3166-1 alpha-2 country the sender operates in, e.g. US.
+      #
+      #   @return [String]
+      required :country, String
+
+      # @!attribute area_codes
+      #   The area codes to put this sender in, in your own order of preference, e.g.
+      #   ["415", "628"] for the US or ["20"] for London. Omit it and a number is claimed
+      #   anywhere in the country.
+      #
+      #   Ordered, and the order is the request. The claim tries each code in turn and
+      #   stops at the first that yields a number. Nothing sorts the list and a code
+      #   listed twice is refused.
+      #
+      #   One to fifty entries, each the area code as digits: 415, with the trunk prefix
+      #   as 020, or with the country's dialing prefix as +1415 (all are stored as the
+      #   bare code). A dialing prefix from a different country than country is refused.
+      #   Each code is checked against the country's numbering plan: it must start real
+      #   local or mobile numbers there, so toll-free and premium ranges, service codes
+      #   and another country's codes are refused with a reason.
+      #
+      #   LOCAL senders in any country, and US TEN_DLC senders. No other sender type has a
+      #   geographic area code, and the list is refused with one rather than accepted and
+      #   dropped.
+      #
+      #   Honoured exactly or not at all. Ask for 415 and you get a 415 number or you get
+      #   none, never a neighbouring code you did not name. A miss leaves the market with
+      #   no sender yet and the codes recorded on it, so it is filled when stock appears
+      #   rather than filled now from somewhere else. Many countries outside North America
+      #   require address or business documents before a local number can be bought, which
+      #   can delay or prevent the fill.
+      #
+      #   @return [Array<String>, nil]
+      optional :area_codes, Sentdm::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!attribute number_type
+      #   Sender type: LOCAL, MOBILE, TEN_DLC, TOLL_FREE, SHORT_CODE or ALPHANUMERIC.
+      #   10DLC is accepted as a synonym of TEN_DLC. Availability varies by country.
+      #
+      #   @return [String, nil]
+      optional :number_type, String, nil?: true
+
+      # @!attribute numbers
+      #   The numbers to assign, one entry per area code, e.g. [{"area_code": "212",
+      #   "quantity": 2}, {"area_code": "415"}, {"quantity": 1}]: two numbers in 212, one
+      #   in 415 and one in any area code. quantity defaults to 1, and an entry without
+      #   area_code means any area code. Omit numbers for one number.
+      #
+      #   Only with LOCAL or TEN_DLC, and not together with area_codes. Each area code is
+      #   validated against country the same way area_codes is and may appear once, and at
+      #   most one entry may leave area_code out. US TEN_DLC numbers are assigned when the
+      #   campaign is approved, not at request time. Not available when the profile
+      #   inherits the organization's campaign.
+      #
+      #   @return [Array<Sentdm::Models::Channels::SMSNumberRequest>, nil]
+      optional :numbers,
+               -> {
+                 Sentdm::Internal::Type::ArrayOf[Sentdm::Channels::SMSNumberRequest]
+               },
+               nil?: true
+
+      # @!attribute sender_value
+      #   The sender's identity, where the caller chooses it rather than the carrier
+      #   assigning it. Required when number_type is ALPHANUMERIC; omit for
+      #   carrier-assigned types and one is provisioned.
+      #
+      #   @return [String, nil]
+      optional :sender_value, String, nil?: true
+
+      # @!method initialize(country:, area_codes: nil, number_type: nil, numbers: nil, sender_value: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::SenderProfileSMS} for more details.
+      #
+      #   One SMS market a profile sends in — a country and a sender type.
+      #
+      #   A profile may have several. It is a tenant, not a market: a business sending to
+      #   two countries is one customer of yours, and forcing it into two profiles would
+      #   give it two API keys, two inboxes and two contact lists for one business. The
+      #   platform already assumes many — CustomerChannelProviders is unique on (customer,
+      #   channel, iso, number).
+      #
+      #   No mode: a sender is the profile's own or it has none. Listing a market is the
+      #   request for one.
+      #
+      #   Also the discriminator for everything else: the compliance catalog is keyed on
+      #   (country, number type), and that pair decides which fields brand accepts and
+      #   what compliance is asked for.
+      #
+      #   @param country [String] ISO 3166-1 alpha-2 country the sender operates in, e.g. US.
+      #
+      #   @param area_codes [Array<String>, nil] The area codes to put this sender in, in your own order of preference, e.g. ["41
+      #
+      #   @param number_type [String, nil] Sender type: LOCAL, MOBILE, TEN_DLC, TOLL_FREE, SHORT_CODE or
+      #
+      #   @param numbers [Array<Sentdm::Models::Channels::SMSNumberRequest>, nil] The numbers to assign, one entry per area code, e.g.
+      #
+      #   @param sender_value [String, nil] The sender's identity, where the caller chooses it rather than the carrier assig
+    end
+  end
+end

data/lib/sentdm/models/sender_profile_update_params.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    # @see Sentdm::Resources::SenderProfiles#update
+    class SenderProfileUpdateParams < Sentdm::Internal::Type::BaseModel
+      extend Sentdm::Internal::Type::RequestParameters::Converter
+      include Sentdm::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute description
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute name
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!attribute notifications
+      #   Who is notified about this profile's events: ORGANIZATION, SENDER_PROFILE, or
+      #   ORGANIZATION_AND_SENDER_PROFILE. Cannot be cleared — a supplied value must be
+      #   one of those.
+      #
+      #   @return [String, nil]
+      optional :notifications, String, nil?: true
+
+      # @!attribute sandbox
+      #   Sandbox flag - when true, the operation is simulated without side effects Useful
+      #   for testing integrations without actual execution
+      #
+      #   @return [Boolean, nil]
+      optional :sandbox, Sentdm::Internal::Type::Boolean
+
+      # @!attribute short_name
+      #
+      #   @return [String, nil]
+      optional :short_name, String, nil?: true
+
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!method initialize(id:, description: nil, name: nil, notifications: nil, sandbox: nil, short_name: nil, idempotency_key: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::SenderProfileUpdateParams} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param description [String, nil]
+      #
+      #   @param name [String]
+      #
+      #   @param notifications [String, nil] Who is notified about this profile's events: ORGANIZATION, SENDER_PROFILE, or
+      #
+      #   @param sandbox [Boolean] Sandbox flag - when true, the operation is simulated without side effects
+      #
+      #   @param short_name [String, nil]
+      #
+      #   @param idempotency_key [String]
+      #
+      #   @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/sentdm/models/sender_profile_whatsapp.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class SenderProfileWhatsapp < Sentdm::Internal::Type::BaseModel
+      # @!attribute phone_number_id
+      #   The Meta phone-number id this profile sends from. Must already be registered
+      #   under WabaId.
+      #
+      #   Optional. Omit it to attach the account now and settle the number later: the
+      #   channel reads as ACTION_NEEDED with CHANNEL_007, and the profile's WhatsApp
+      #   messages fail until a number is named. They do not fall back to the
+      #   organization's account. Nothing picks one on your behalf.
+      #
+      #   @return [String, nil]
+      optional :phone_number_id, String, nil?: true
+
+      # @!attribute waba_id
+      #   WhatsApp Business Account id — one of the accounts shared into your
+      #   organization. Required: the organization holds one per client, and nothing but
+      #   the caller says which belongs to this profile.
+      #
+      #   @return [String, nil]
+      optional :waba_id, String, nil?: true
+
+      # @!method initialize(phone_number_id: nil, waba_id: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::SenderProfileWhatsapp} for more details.
+      #
+      #   The profile's own WhatsApp Business Account, named by the two identifiers the
+      #   organization cannot answer for you.
+      #
+      #   No mode: a profile's WABA is its own or it has none. Sharing the organization's
+      #   would mean sharing its inbox and its throughput, which makes the two
+      #   indistinguishable to a recipient — so inheriting is not offered rather than
+      #   refused.
+      #
+      #   Everything derivable is derived. Whenever this block is present, the solution
+      #   the account arrived through, the client business portfolio that owns it, the
+      #   access token and that token's expiry are all resolved from the organization by
+      #   IPartnerSolutionService.ResolveAccountCredentialsAsync — the first two off the
+      #   org's shared-account listing, the token minted against the org's own solution.
+      #   They were previously asked for and are no longer accepted: solution_id and
+      #   owner_business_id are Meta's answer about provenance, so taking them from the
+      #   caller let a request assert a partnership Meta disagreed with, and the listing
+      #   has to be consulted regardless because it is what proves the account is one this
+      #   organization may reach.
+      #
+      #   No access token, and there never was one here: it is minted per client business
+      #   portfolio and rotates roughly every sixty days, so a pasted value would be stale
+      #   before it was useful. Asking a customer to mint a System User token in Meta
+      #   Business Manager is skilled work in a console they were never meant to see, and
+      #   it would say nothing about which solution the account came from or when it is
+      #   revoked.
+      #
+      #   @param phone_number_id [String, nil] The Meta phone-number id this profile sends from. Must already be registered und
+      #
+      #   @param waba_id [String, nil] WhatsApp Business Account id — one of the accounts shared into your organization
+    end
+  end
+end

data/lib/sentdm/models/sender_profiles_list.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class SenderProfilesList < Sentdm::Internal::Type::BaseModel
+      # @!attribute pagination
+      #   Pagination metadata for list responses
+      #
+      #   @return [Sentdm::Models::PaginationMeta, nil]
+      optional :pagination, -> { Sentdm::PaginationMeta }
+
+      # @!attribute sender_profiles
+      #   The sender_profiles on this page.
+      #
+      #   @return [Array<Sentdm::Models::SenderProfile>, nil]
+      optional :sender_profiles, -> { Sentdm::Internal::Type::ArrayOf[Sentdm::SenderProfile] }
+
+      # @!method initialize(pagination: nil, sender_profiles: nil)
+      #   A paginated list of sender profiles.
+      #
+      #   @param pagination [Sentdm::Models::PaginationMeta] Pagination metadata for list responses
+      #
+      #   @param sender_profiles [Array<Sentdm::Models::SenderProfile>] The sender_profiles on this page.
+    end
+  end
+end

data/lib/sentdm/models/tcr_brand_identity_status.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    module TcrBrandIdentityStatus
+      extend Sentdm::Internal::Type::Enum
+
+      SELF_DECLARED = :SELF_DECLARED
+      UNVERIFIED = :UNVERIFIED
+      VERIFIED = :VERIFIED
+      VETTED_VERIFIED = :VETTED_VERIFIED
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/sentdm/models/tcr_brand_status.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    module TcrBrandStatus
+      extend Sentdm::Internal::Type::Enum
+
+      ACTIVE = :ACTIVE
+      INACTIVE = :INACTIVE
+      SUSPENDED = :SUSPENDED
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/sentdm/models/tcr_campaign_status.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    module TcrCampaignStatus
+      extend Sentdm::Internal::Type::Enum
+
+      SENT_CREATED = :SENT_CREATED
+      ACTIVE = :ACTIVE
+      EXPIRED = :EXPIRED
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/sentdm/models/template_body.rb

@@ -12,8 +12,8 @@ module Sentdm
       #   MMS-specific copy, a subject or attachments. When present it replaces that body
       #   on MMS rather than adding to it.
       #
-      #   @return [Sentdm::Models::TemplateBody::Mms, nil]
-      optional :mms, -> { Sentdm::TemplateBody::Mms }, nil?: true
+      #   @return [Sentdm::Models::TemplateMmsBodyContent, nil]
+      optional :mms, -> { Sentdm::TemplateMmsBodyContent }, nil?: true
 
       # @!attribute multi_channel
       #   The shared body, used for every channel. One half of the choice described above.
@@ -56,7 +56,7 @@ 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 mms [Sentdm::Models::TemplateMmsBodyContent, 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.
       #
@@ -65,73 +65,6 @@ 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. Without
-        #   this slot MMS renders the shared or SMS body, so it is only needed for
-        #   MMS-specific copy, a subject or attachments. When present it replaces that body
-        #   on MMS rather than adding to it.
-        #
-        #   @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

@@ -41,6 +41,14 @@ module Sentdm
       #   @return [String, nil]
       optional :language, String, nil?: true
 
+      # @!attribute name
+      #   Template display name (optional). When omitted or blank, a name is generated
+      #   from the template's content. It can be changed afterwards with PUT
+      #   /v3/templates/{id}.
+      #
+      #   @return [String, nil]
+      optional :name, String, nil?: true
+
       # @!attribute sandbox
       #   Sandbox flag - when true, the operation is simulated without side effects Useful
       #   for testing integrations without actual execution
@@ -64,7 +72,7 @@ module Sentdm
       #   @return [String, nil]
       optional :x_profile_id, String
 
-      # @!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: {})
+      # @!method initialize(auto_create_for_sp: nil, category: nil, creation_source: nil, definition: nil, language: nil, name: 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.
       #
@@ -78,6 +86,8 @@ module Sentdm
       #
       #   @param language [String, nil] Template language code (e.g., en_US) (optional, auto-detected if not provided)
       #
+      #   @param name [String, nil] Template display name (optional). When omitted or blank, a name is generated fro
+      #
       #   @param sandbox [Boolean] Sandbox flag - when true, the operation is simulated without side effects
       #
       #   @param submit_for_review [Boolean] Whether to submit the template for review after creation (default: false)

data/lib/sentdm/models/template_header.rb

@@ -32,8 +32,8 @@ module Sentdm
       #   for Sent: a preview, and the default a StaticResource header falls back to at
       #   send.
       #
-      #   @return [Sentdm::Models::TemplateHeader::Location, nil]
-      optional :location, -> { Sentdm::TemplateHeader::Location }, nil?: true
+      #   @return [Sentdm::Models::TemplateHeaderLocation, nil]
+      optional :location, -> { Sentdm::TemplateHeaderLocation }, nil?: true
 
       # @!attribute static_resource
       #   Whether the asset registered at creation is reused when a caller omits the
@@ -80,47 +80,13 @@ module Sentdm
       #
       #   @param example_url [String, nil] Request-only. The s.dm URL of the asset Meta's reviewers see — https://s.dm/s/{I
       #
-      #   @param location [Sentdm::Models::TemplateHeader::Location, nil] The map pin a location header drops. Meta wants none of this at creation — the c
+      #   @param location [Sentdm::Models::TemplateHeaderLocation, nil] The map pin a location header drops. Meta wants none of this at creation — the c
       #
       #   @param static_resource [Boolean] Whether the asset registered at creation is reused when a caller omits the heade
       #
       #   @param type [String, nil] The kind of header. One of:
       #
       #   @param variables [Array<Sentdm::Models::TemplateVariable>, nil] List of variables used in the header template
-
-      # @see Sentdm::Models::TemplateHeader#location
-      class Location < Sentdm::Internal::Type::BaseModel
-        # @!attribute address
-        #
-        #   @return [String]
-        required :address, String
-
-        # @!attribute latitude
-        #
-        #   @return [String]
-        required :latitude, String
-
-        # @!attribute longitude
-        #
-        #   @return [String]
-        required :longitude, String
-
-        # @!attribute name
-        #
-        #   @return [String]
-        required :name, String
-
-        # @!method initialize(address:, latitude:, longitude:, name:)
-        #   The map pin a location header drops. Meta wants none of this at creation — the
-        #   component is just {"type":"header","format":"location"} — so these values exist
-        #   for Sent: a preview, and the default a StaticResource header falls back to at
-        #   send.
-        #
-        #   @param address [String]
-        #   @param latitude [String]
-        #   @param longitude [String]
-        #   @param name [String]
-      end
     end
   end
 end

data/lib/sentdm/models/template_header_location.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class TemplateHeaderLocation < Sentdm::Internal::Type::BaseModel
+      # @!attribute address
+      #
+      #   @return [String]
+      required :address, String
+
+      # @!attribute latitude
+      #
+      #   @return [String]
+      required :latitude, String
+
+      # @!attribute longitude
+      #
+      #   @return [String]
+      required :longitude, String
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!method initialize(address:, latitude:, longitude:, name:)
+      #   The map pin a location header drops. Meta wants none of this at creation — the
+      #   component is just {"type":"header","format":"location"} — so these values exist
+      #   for Sent: a preview, and the default a StaticResource header falls back to at
+      #   send.
+      #
+      #   @param address [String]
+      #   @param latitude [String]
+      #   @param longitude [String]
+      #   @param name [String]
+    end
+  end
+end

data/lib/sentdm/models/template_media_item.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class TemplateMediaItem < 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::TemplateMediaItem} 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

data/lib/sentdm/models/template_mms_body_content.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class TemplateMmsBodyContent < 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::TemplateMediaItem>, nil]
+      optional :media, -> { Sentdm::Internal::Type::ArrayOf[Sentdm::TemplateMediaItem] }, 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::TemplateMmsBodyContent} for more details.
+      #
+      #   MMS-specific body content.
+      #
+      #   Why MMS needs its own type when the other channels share one: it is the only
+      #   channel with a subject line and the only one with attachments. Every other
+      #   channel's body is text and variables, which is exactly what TemplateBodyContent
+      #   already is. Putting Subject and Media on the shared type instead would give sms,
+      #   whatsapp and rcs two members none of them can ever use.
+      #
+      #   Derives from TemplateBodyContent so that every existing consumer of a body slot
+      #   — MessageUtils.ConvertVariableToReadable,
+      #   TemplateDefinition.GetRequiredVariables,
+      #   TemplateDefinitionValidator.ApplyBodyContentRules — reads it with no change. The
+      #   two extra members are what the MMS strategy and the provider request need on
+      #   top.
+      #
+      #   @param media [Array<Sentdm::Models::TemplateMediaItem>, 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
+    end
+  end
+end