sentdm 0.32.0 → 0.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5dab566c65206bbd97b0e29e8660f25932a22d58359db63e20c4d4ba9cbd8dec
-  data.tar.gz: 5e097f125343b76d26132686ff963dcfba40c316b6e9a8a4b13dc0fd493014aa
+  metadata.gz: 88e9bb540faf8a7261b5e38bb2b040df80d8f02124ae52f313d7d0019fe84042
+  data.tar.gz: 52b07edc509cd9c60d586cffede3b951ba9e8f8de1b34776c1b9d86655dd2dfc
 SHA512:
-  metadata.gz: a47bec3101129a85381094c226cf6be44786562b5a882683bcc6c40dbeeb40d6da8ef8dd4a47254a7f6dc09cefea91655170baa7495755a54d922d127f0d6e56
-  data.tar.gz: a5239a8ae31862ca952d547205f9fd35b909f3bf43320f45afbed14f881110de646b5697a2f247b43bc91861ef5df95f43b5f6353becce01a133086bf844bb6b
+  metadata.gz: 83049b88e719812408bf187ebb7d8723c45368fc89ff7d21dce6cdd2cdd2c74f892da306081d5b9af50df59668a69160b91a11bd6796d978560738bbfd3a0fc5
+  data.tar.gz: 95eb98fb732c34e1ce224cfdfec45193477bd8aae18e5daf6d5da3bee50a3018c712304da29fbf146b2f92c330d512d617a82fbeb77dd4f1a25f4752c2566929

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.33.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.32.0...v0.33.0) (2026-09-30)
+
+
+### Features
+
+* **api:** sync generated SDKs from the committed spec ([c68607e](https://github.com/sentdm/sent-dm-ruby/commit/c68607ed78d4a03f1c3c03d36440985cd5eedceb))
+* **api:** sync OpenAPI spec from production ([ceb47d9](https://github.com/sentdm/sent-dm-ruby/commit/ceb47d9ddc2d46144e5f81b0ef4bc7693b1f435f))
+* **api:** sync OpenAPI spec from production ([8c92eb5](https://github.com/sentdm/sent-dm-ruby/commit/8c92eb52bff195424d14d09eff8f131edc640918))
+
 ## [0.32.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.31.0...v0.32.0) (2026-09-18)
 
 

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "sentdm", "~> 0.32.0"
+gem "sentdm", "~> 0.33.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/sentdm/client.rb

@@ -83,6 +83,12 @@ module Sentdm
     # **A message needs a sender.** What you can send, where, and at what cost is
     # decided by the markets under **Channels** — so a recipient in a country you hold
     # no sender for is refused here rather than queued.
+    #
+    # **A message can be resent on its id.** `POST /v3/messages/{id}/resend` puts a
+    # finished message — typically one BLOCKED for insufficient balance — back through
+    # the send pipeline. It is a new attempt, not a free retry: every policy runs
+    # again, the message is billed again, and its status webhooks fire again. A
+    # FILTERED message is never resendable.
     # @return [Sentdm::Resources::Messages]
     attr_reader :messages
 

data/lib/sentdm/models/channel_event_payload.rb

@@ -16,7 +16,9 @@ module Sentdm
       #   The account whose market this is, named as on every other family. When an
       #   organization receives an event for one of its sender profiles this is the
       #   profile, so a reseller compares it with its own id and anything different is one
-      #   of its profiles.
+      #   of its profiles. Matches customer_id on GET /v3/channels and the sender
+      #   profile's id. Together with channel, country, and number_type, it identifies the
+      #   market.
       #
       #   @return [String, nil]
       optional :account_id, String
@@ -29,6 +31,28 @@ module Sentdm
       #   @return [String, nil]
       optional :channel, String
 
+      # @!attribute compliance
+      #   What a market has been given: the identity it registers under, its programme,
+      #   and any documents attached.
+      #
+      #   What it does not carry is what the market asks for. That is the subject of GET
+      #   /v3/compliance/requirements, and it is the same answer for every caller — a
+      #   description of what a compliance regime wants, not a record of one customer's
+      #   progress through it. It was reported here as well for a while, which put the
+      #   same array in six response shapes and left a caller deciding which of two
+      #   sources to believe.
+      #
+      #   Present on a list read for markets that register (carrying brand and campaign),
+      #   but with documents absent — documents are not fetched for a list, because a
+      #   catalog lookup and a document read per market would multiply across a page.
+      #   Absent documents is distinct from an empty list: absent says they were not
+      #   fetched; empty says the market has been given none. The parent object is null
+      #   only when the market registers with nobody and compliance was not computed —
+      #   nothing to show at all.
+      #
+      #   @return [Sentdm::Models::ChannelEventPayload::Compliance, nil]
+      optional :compliance, -> { Sentdm::ChannelEventPayload::Compliance }, nil?: true
+
       # @!attribute number_type
       #   The kind of sender the market uses, for example TEN_DLC, LOCAL, or ALPHANUMERIC.
       #   Omitted when the subject has no sender type of its own.
@@ -83,7 +107,7 @@ module Sentdm
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(country:, account_id: nil, channel: nil, number_type: nil, reason: nil, sender_value: nil, status: nil, updated_at: nil)
+      # @!method initialize(country:, account_id: nil, channel: nil, compliance: nil, number_type: nil, reason: nil, sender_value: nil, status: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::ChannelEventPayload} for more details.
       #
@@ -114,6 +138,8 @@ module Sentdm
       #
       #   @param channel [String] The channel this market belongs to: sms, whatsapp, or rcs. Never
       #
+      #   @param compliance [Sentdm::Models::ChannelEventPayload::Compliance, nil] What a market has been given: the identity it registers under, its programme, an
+      #
       #   @param number_type [String, nil] The kind of sender the market uses, for example TEN_DLC, LOCAL, or
       #
       #   @param reason [String, nil] Why the market reached this state, when a reason was given — a correction explai
@@ -123,6 +149,117 @@ module Sentdm
       #   @param status [String] Where the market stands: PENDING_REVIEW, ACTION_NEEDED, PROVISIONING,
       #
       #   @param updated_at [String] When the transition happened, in UTC (yyyy-MM-ddTHH:mm:ssZ).
+
+      # @see Sentdm::Models::ChannelEventPayload#compliance
+      class Compliance < Sentdm::Internal::Type::BaseModel
+        # @!attribute brand
+        #   The identity this market registers under, with inherit saying whose it is.
+        #
+        #   Reported here rather than on the profile because it belongs to the registration
+        #   this market files, and only one market files one. It was a top-level block for a
+        #   while, which put a per-registration value beside a list of markets and left a
+        #   caller to work out which market it belonged to.
+        #
+        #   Absent for a market that registers with nobody — such a market asks for no
+        #   identity, so there is none to report. Absent and null mean different things:
+        #   absent says this market does not ask, null would say it asks and nothing was
+        #   supplied.
+        #
+        #   Untyped, like the request side, because its members are declared by the market's
+        #   own schema rather than by a C# class. A typed pair here would be a second
+        #   definition of what a market wants, free to drift from the one that validates.
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :brand, Sentdm::Internal::Type::HashOf[Sentdm::Internal::Type::Unknown], nil?: true
+
+        # @!attribute campaign
+        #   The programme this market registers, with inherit saying whose it is.
+        #
+        #   One, not a list. TcrCampaigns permits several and an account built on the admin
+        #   side may hold them, but this surface offers one — which is what lets the
+        #   market's PATCH be an upsert rather than a collection with an addressable create
+        #   behind it. An account holding several is reported as its first and refused on
+        #   write, rather than half-edited.
+        #
+        #   Carries no id. Nothing addresses a campaign, and an undeclared key would be
+        #   refused if the caller sent this object back — which it is meant to be able to
+        #   do.
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :campaign, Sentdm::Internal::Type::HashOf[Sentdm::Internal::Type::Unknown], nil?: true
+
+        # @!attribute documents
+        #   What has been supplied for this market.
+        #
+        #   Files, not values — the declared halves above carry the values. A document
+        #   cannot be a JSON value, so it is sent as multipart on the channel call and
+        #   reported here as a reference.
+        #
+        #   Absent on a list read, which fetches identity but does not compute compliance
+        #   documents per market. Absent and empty mean different things: absent says the
+        #   documents were not fetched; empty says the market has been given none.
+        #
+        #   @return [Array<Sentdm::Models::ChannelEventPayload::Compliance::Document>, nil]
+        optional :documents,
+                 -> { Sentdm::Internal::Type::ArrayOf[Sentdm::ChannelEventPayload::Compliance::Document] },
+                 nil?: true
+
+        # @!method initialize(brand: nil, campaign: nil, documents: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Sentdm::Models::ChannelEventPayload::Compliance} for more details.
+        #
+        #   What a market has been given: the identity it registers under, its programme,
+        #   and any documents attached.
+        #
+        #   What it does not carry is what the market asks for. That is the subject of GET
+        #   /v3/compliance/requirements, and it is the same answer for every caller — a
+        #   description of what a compliance regime wants, not a record of one customer's
+        #   progress through it. It was reported here as well for a while, which put the
+        #   same array in six response shapes and left a caller deciding which of two
+        #   sources to believe.
+        #
+        #   Present on a list read for markets that register (carrying brand and campaign),
+        #   but with documents absent — documents are not fetched for a list, because a
+        #   catalog lookup and a document read per market would multiply across a page.
+        #   Absent documents is distinct from an empty list: absent says they were not
+        #   fetched; empty says the market has been given none. The parent object is null
+        #   only when the market registers with nobody and compliance was not computed —
+        #   nothing to show at all.
+        #
+        #   @param brand [Hash{Symbol=>Object}, nil] The identity this market registers under, with inherit saying whose it is.
+        #
+        #   @param campaign [Hash{Symbol=>Object}, nil] The programme this market registers, with inherit saying whose it is.
+        #
+        #   @param documents [Array<Sentdm::Models::ChannelEventPayload::Compliance::Document>, nil] What has been supplied for this market.
+
+        class Document < Sentdm::Internal::Type::BaseModel
+          # @!attribute document_id
+          #   Identifier of the upload, for fetching it back through the documents endpoints.
+          #
+          #   @return [String, nil]
+          optional :document_id, String, nil?: true
+
+          # @!attribute file_name
+          #
+          #   @return [String, nil]
+          optional :file_name, String, nil?: true
+
+          # @!attribute key
+          #   The catalog's name for this document, matching the requirement it satisfies.
+          #
+          #   @return [String, nil]
+          optional :key, String
+
+          # @!method initialize(document_id: nil, file_name: nil, key: nil)
+          #   A document a market asked for and has been given.
+          #
+          #   @param document_id [String, nil] Identifier of the upload, for fetching it back through the documents endpoints.
+          #
+          #   @param file_name [String, nil]
+          #
+          #   @param key [String] The catalog's name for this document, matching the requirement it satisfies.
+        end
+      end
     end
   end
 end

data/lib/sentdm/models/contact_event.rb

@@ -19,17 +19,25 @@ module Sentdm
       optional :field, String
 
       # @!attribute payload
-      #   Body of a contact.opt_in, contact.opt_out or contact.help event. Delivered when
-      #   a contact signals a consent change or asks for help.
+      #   Body of a contact.opt_in, contact.opt_out, contact.help or
+      #   contact.custom_keyword event. Delivered when a contact signals a consent change,
+      #   asks for help, or sends one of your own auto-reply keywords.
       #
       #   These events state the signal outright, so you do not have to recognise keywords
       #   in the text of a message.received event. They also cover cases that produce no
       #   inbound message at all, such as a network handling an opt-out on your behalf.
       #
-      #   Fields are ordered identity → resulting state → provenance → join key. Nothing
-      #   here restates the envelope: which of the three signals occurred is the
-      #   envelope's event, and when it was emitted is its timestamp. Retries carry the
-      #   same X-Webhook-Event-ID header, which is what to deduplicate on.
+      #   Two of the four change consent and two do not: contact.help and
+      #   contact.custom_keyword report the state the contact already had. Read opt_out
+      #   for the state and the envelope's event for what happened, rather than inferring
+      #   one from the other.
+      #
+      #   Fields are ordered identity → resulting state → provenance → join keys. The two
+      #   parties are from and to. Note that the message family has not moved to those
+      #   names yet — message.received still calls the same two parties inbound_number and
+      #   outbound_number. Nothing here restates the envelope: which signal occurred is
+      #   the envelope's event, and when it was emitted is its timestamp. Retries carry
+      #   the same X-Webhook-Event-ID header, which is what to deduplicate on.
       #
       #   @return [Sentdm::Models::ContactEventPayload, nil]
       optional :payload, -> { Sentdm::ContactEventPayload }, nil?: true
@@ -59,7 +67,7 @@ module Sentdm
       #
       #   @param field [String] The event family, for example message, templates or contact. Route on
       #
-      #   @param payload [Sentdm::Models::ContactEventPayload, nil] Body of a contact.opt_in, contact.opt_out or contact.help event. Delivered
+      #   @param payload [Sentdm::Models::ContactEventPayload, nil] Body of a contact.opt_in, contact.opt_out, contact.help or
       #
       #   @param request_id [String, nil] The event-specific body.
       #

data/lib/sentdm/models/contact_event_payload.rb

@@ -5,8 +5,9 @@ module Sentdm
     class ContactEventPayload < Sentdm::Internal::Type::BaseModel
       # @!attribute opt_out
       #   Whether the contact is opted out after this signal — the state to write to your
-      #   own record. Same meaning as opt_out on the contact resource. On contact.help
-      #   this reports the contact's existing state, which help does not change.
+      #   own record. Same meaning as opt_out on the contact resource. On contact.help and
+      #   contact.custom_keyword this reports the contact's existing state, which neither
+      #   changes.
       #
       #   Two signals from the same contact can arrive out of order, because each one is
       #   queued on its own rather than against the contact. Compare the envelope's
@@ -33,6 +34,18 @@ module Sentdm
       #   @return [String, nil]
       optional :account_id, String
 
+      # @!attribute agent_id
+      #   The RCS agent the signal reached, when it reached one.
+      #
+      #   Omitted entirely on channels that have no agent, rather than sent as null — an
+      #   SMS or WhatsApp payload does not carry this key at all. On RCS it is the
+      #   counterpart to To: a contact reaches an agent rather than a number, so exactly
+      #   one of the two is populated and never both. If you run more than one agent, this
+      #   is what tells you which of them the contact acted on.
+      #
+      #   @return [String, nil]
+      optional :agent_id, String, nil?: true
+
       # @!attribute channel
       #   The channel the signal arrived on, for example sms or whatsapp.
       #
@@ -41,12 +54,20 @@ module Sentdm
 
       # @!attribute contact_id
       #   The contact who raised the signal. Always populated, including for contact.help
-      #   from a number you have not messaged before — the contact is created if it does
-      #   not exist yet, so this identifier is always resolvable against the contacts API.
+      #   or contact.custom_keyword from a number you have not messaged before — the
+      #   contact is created if it does not exist yet, so this identifier is always
+      #   resolvable against the contacts API.
       #
       #   @return [String, nil]
       optional :contact_id, String
 
+      # @!attribute from
+      #   The contact's number, in E.164 format with the leading + — who raised the
+      #   signal. The same party message.received publishes as inbound_number.
+      #
+      #   @return [String, nil]
+      optional :from, String
+
       # @!attribute message_id
       #   The inbound message that carried the signal, matching message_id on the
       #   corresponding message.received event so the two can be joined.
@@ -60,12 +81,21 @@ module Sentdm
       #   @return [String, nil]
       optional :message_id, String, nil?: true
 
-      # @!attribute phone_number
-      #   The contact's number in E.164 format. Same value as phone_number on the contact
-      #   resource.
+      # @!attribute template_id
+      #   The auto-reply template whose keyword the contact matched, joinable against the
+      #   templates API.
+      #
+      #   This is what identifies which signal arrived on contact.custom_keyword: every
+      #   custom template reports the same event name, so the event alone cannot tell your
+      #   booking keyword from your opening-hours one. One template holds as many keywords
+      #   as you configured, so this is steadier to switch on than text.
+      #
+      #   Populated on the compliance sub-types too, where it names the template that
+      #   replied. Sent as null when no template was involved — a network-reported opt-out
+      #   matches no keyword. The field is always present, so read it and check for null.
       #
       #   @return [String, nil]
-      optional :phone_number, String
+      optional :template_id, String, nil?: true
 
       # @!attribute text
       #   The text the contact sent, for example STOP or UNSUBSCRIBE. Sent as null when
@@ -75,21 +105,46 @@ module Sentdm
       #   @return [String, nil]
       optional :text, String, nil?: true
 
-      # @!method initialize(opt_out:, source:, account_id: nil, channel: nil, contact_id: nil, message_id: nil, phone_number: nil, text: nil)
+      # @!attribute to
+      #   The number of yours that received the signal, in E.164 format with the leading
+      #   +. Tells a multi-number account which of its senders the contact acted on, which
+      #   nothing else on this payload answers.
+      #
+      #   This is your number, not the contact's. That is the opposite of what to means on
+      #   POST /v3/messages, where it is the list of recipients you are sending to. Reply
+      #   to From, not to this field, or the message goes back to yourself.
+      #
+      #   Sent as null when the signal did not arrive at a number of yours — an RCS signal
+      #   terminates at an agent rather than a number, and a provider-reported opt-out may
+      #   name no receiving number at all. The field is always present, so read it and
+      #   check for null rather than checking whether the key exists.
+      #
+      #   @return [String, nil]
+      optional :to, String, nil?: true
+
+      # @!method initialize(opt_out:, source:, account_id: nil, agent_id: nil, channel: nil, contact_id: nil, from: nil, message_id: nil, template_id: nil, text: nil, to: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::ContactEventPayload} for more details.
       #
-      #   Body of a contact.opt_in, contact.opt_out or contact.help event. Delivered when
-      #   a contact signals a consent change or asks for help.
+      #   Body of a contact.opt_in, contact.opt_out, contact.help or
+      #   contact.custom_keyword event. Delivered when a contact signals a consent change,
+      #   asks for help, or sends one of your own auto-reply keywords.
       #
       #   These events state the signal outright, so you do not have to recognise keywords
       #   in the text of a message.received event. They also cover cases that produce no
       #   inbound message at all, such as a network handling an opt-out on your behalf.
       #
-      #   Fields are ordered identity → resulting state → provenance → join key. Nothing
-      #   here restates the envelope: which of the three signals occurred is the
-      #   envelope's event, and when it was emitted is its timestamp. Retries carry the
-      #   same X-Webhook-Event-ID header, which is what to deduplicate on.
+      #   Two of the four change consent and two do not: contact.help and
+      #   contact.custom_keyword report the state the contact already had. Read opt_out
+      #   for the state and the envelope's event for what happened, rather than inferring
+      #   one from the other.
+      #
+      #   Fields are ordered identity → resulting state → provenance → join keys. The two
+      #   parties are from and to. Note that the message family has not moved to those
+      #   names yet — message.received still calls the same two parties inbound_number and
+      #   outbound_number. Nothing here restates the envelope: which signal occurred is
+      #   the envelope's event, and when it was emitted is its timestamp. Retries carry
+      #   the same X-Webhook-Event-ID header, which is what to deduplicate on.
       #
       #   @param opt_out [Boolean] Whether the contact is opted out after this signal — the state to write to your
       #
@@ -97,15 +152,21 @@ module Sentdm
       #
       #   @param account_id [String] The account the contact belongs to. Present so one endpoint can serve several ac
       #
+      #   @param agent_id [String, nil] The RCS agent the signal reached, when it reached one.
+      #
       #   @param channel [String] The channel the signal arrived on, for example sms or whatsapp.
       #
       #   @param contact_id [String] The contact who raised the signal. Always populated, including for contact.help
       #
+      #   @param from [String] The contact's number, in E.164 format with the leading + — who raised the signal
+      #
       #   @param message_id [String, nil] The inbound message that carried the signal, matching message_id on the
       #
-      #   @param phone_number [String] The contact's number in E.164 format. Same value as phone_number on the contact
+      #   @param template_id [String, nil] The auto-reply template whose keyword the contact matched, joinable against the
       #
       #   @param text [String, nil] The text the contact sent, for example STOP or UNSUBSCRIBE. Sent as
+      #
+      #   @param to [String, nil] The number of yours that received the signal, in E.164 format with the leading +
     end
   end
 end

data/lib/sentdm/models/conversation_messages_list.rb

@@ -67,7 +67,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::ConversationMessagesList::Message::MessageBody, nil]
         optional :message_body, -> { Sentdm::ConversationMessagesList::Message::MessageBody }, nil?: true
@@ -116,7 +123,12 @@ module Sentdm
         #   Some parameter documentations has been truncated, see
         #   {Sentdm::Models::ConversationMessagesList::Message} 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]
         #
@@ -202,14 +214,65 @@ 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::ConversationMessagesList::Message::MessageBody::HeaderMedia, nil]
+          optional :header_media,
+                   -> { Sentdm::ConversationMessagesList::Message::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::ConversationMessagesList::Message::MessageBody::Media>, nil]
+          optional :media,
+                   -> {
+                     Sentdm::Internal::Type::ArrayOf[Sentdm::ConversationMessagesList::Message::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::ConversationMessagesList::Message::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::ConversationMessagesList::Message::MessageBody::Button>, nil]
+          #
           #   @param content [String]
+          #
           #   @param footer [String, nil]
+          #
           #   @param header [String, nil]
+          #
+          #   @param header_media [Sentdm::Models::ConversationMessagesList::Message::MessageBody::HeaderMedia, nil] The media asset that rode a message's header, recorded as sent.
+          #
+          #   @param media [Array<Sentdm::Models::ConversationMessagesList::Message::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
@@ -238,6 +301,64 @@ module Sentdm
             #   @param type [String]
             #   @param value [String]
           end
+
+          # @see Sentdm::Models::ConversationMessagesList::Message::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::ConversationMessagesList::Message::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 Constants.MmsMediaTypes when known. Advisory — the carrier reads the
+            #   fetched object's Content-Type, not this.
+            #
+            #   @return [String, nil]
+            optional :media_type, String, api_name: :mediaType, nil?: true
+
+            # @!attribute url
+            #
+            #   @return [String, nil]
+            optional :url, String
+
+            # @!method initialize(media_type: nil, url: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Sentdm::Models::ConversationMessagesList::Message::MessageBody::Media} for more
+            #   details.
+            #
+            #   One attachment on a message: a customer-supplied public URL handed to the
+            #   carrier as-is.
+            #
+            #                A URL and nothing else. sent.dm never takes custody of MMS media — the customer hosts it and we
+            #                pass the link through at send time — so there is no storage key, size or expiry to record. If we ever
+            #                do host attachments, that belongs with the change that introduces the hosting, not here.
+            #
+            #   @param media_type [String, nil] One of Constants.MmsMediaTypes when known. Advisory — the carrier reads the
+            #
+            #   @param url [String]
+          end
         end
       end
     end

data/lib/sentdm/models/message_event_payload.rb

@@ -51,6 +51,21 @@ module Sentdm
       #   @return [String, nil]
       optional :outbound_number, String
 
+      # @!attribute schedule_reason
+      #   message.scheduled only: why the message is held, either because you scheduled it
+      #   or because the recipient is inside a protected quiet-hours window. Omitted on
+      #   every other event.
+      #
+      #   @return [String, nil]
+      optional :schedule_reason, String, nil?: true
+
+      # @!attribute scheduled_at
+      #   message.scheduled only: when the held message will be released for delivery, in
+      #   UTC (yyyy-MM-ddTHH:mm:ssZ). Omitted on every other event.
+      #
+      #   @return [String, nil]
+      optional :scheduled_at, String, nil?: true
+
       # @!attribute template_id
       #   The template the message was sent from, when it was sent from one.
       #
@@ -70,7 +85,7 @@ module Sentdm
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(message_status:, account_id: nil, agent_id: nil, body: nil, channel: nil, message_id: nil, outbound_number: nil, template_id: nil, template_name: nil, updated_at: nil)
+      # @!method initialize(message_status:, account_id: nil, agent_id: nil, body: nil, channel: nil, message_id: nil, outbound_number: nil, schedule_reason: nil, scheduled_at: nil, template_id: nil, template_name: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::MessageEventPayload} for more details.
       #
@@ -92,6 +107,10 @@ module Sentdm
       #
       #   @param outbound_number [String] The recipient's number in E.164 format.
       #
+      #   @param schedule_reason [String, nil] message.scheduled only: why the message is held, either because you scheduled it
+      #
+      #   @param scheduled_at [String, nil] message.scheduled only: when the held message will be released for delivery, in
+      #
       #   @param template_id [String, nil] The template the message was sent from, when it was sent from one.
       #
       #   @param template_name [String, nil] Name of the template the message was sent from. Omitted when the message wasn't