sentdm 0.31.0 → 0.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc53282fa9d44937f4eca7cd2519066c9230dd80c07e757976aaf19ed84bc4cd
-  data.tar.gz: ae37ec96f9bbd5415b93931e5f5b45f86bf2cfd9aa5496c3e48a4e4cf55c601c
+  metadata.gz: 5dab566c65206bbd97b0e29e8660f25932a22d58359db63e20c4d4ba9cbd8dec
+  data.tar.gz: 5e097f125343b76d26132686ff963dcfba40c316b6e9a8a4b13dc0fd493014aa
 SHA512:
-  metadata.gz: ad4d72570b0f014b5c0ae8ed154c6eda9cbf18fe6b765bd2159ac2468474c85dfba17e0d662f38c987ea0330eceb7e77d33137ebbb7df2591c65bae1f5415342
-  data.tar.gz: 6c941c5ce504b94a154865c6d1fa3ddcfcf90f58889e0514c0f74c89c324eb0c3312b55cd8ad4f5a32274b8ac28e8d65805496be73ad757621fd1a5a19e30c2e
+  metadata.gz: a47bec3101129a85381094c226cf6be44786562b5a882683bcc6c40dbeeb40d6da8ef8dd4a47254a7f6dc09cefea91655170baa7495755a54d922d127f0d6e56
+  data.tar.gz: a5239a8ae31862ca952d547205f9fd35b909f3bf43320f45afbed14f881110de646b5697a2f247b43bc91861ef5df95f43b5f6353becce01a133086bf844bb6b

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.32.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.31.0...v0.32.0) (2026-09-18)
+
+
+### Features
+
+* **api:** sync OpenAPI spec from production ([d1e2524](https://github.com/sentdm/sent-dm-ruby/commit/d1e2524bd0002641b5466b2eaf1ba189c9d80acf))
+
 ## [0.31.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.30.0...v0.31.0) (2026-09-10)
 
 

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.31.0"
+gem "sentdm", "~> 0.32.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/sentdm/models/channel_event.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class ChannelEvent < Sentdm::Internal::Type::BaseModel
+      # @!attribute event
+      #   The specific event within the family, for example message.delivered,
+      #   message.received or contact.opt_out. Absent on events that have no subtype, so
+      #   treat it as optional.
+      #
+      #   @return [String, nil]
+      optional :event, String, nil?: true
+
+      # @!attribute field
+      #   The event family, for example message, templates or contact. Route on this
+      #   first, then on event for the specific change.
+      #
+      #   @return [String, nil]
+      optional :field, String
+
+      # @!attribute payload
+      #   Body of a channel event: where one of the customer's channels stands in
+      #   provisioning and compliance. Delivered when a milestone moves — a registration
+      #   filed, a verdict returned, a resubmission asked for, a sender gone live — so a
+      #   customer's own onboarding UI does not have to poll GET /v3/channels.
+      #
+      #   The subject is one item, never the account. A customer's "SMS channel" has no
+      #   status; a market does. Country, NumberType and SenderValue name which one, so a
+      #   customer terminating only to Kosovo never receives an event about US 10DLC.
+      #
+      #   Status is the stable half of the contract. It is the same four-value set GET
+      #   /v3/channels publishes, computed through the same code, so an event and a read
+      #   of the same market cannot disagree. A subscriber that reads nothing but the
+      #   status and the subject fields is a correct subscriber. The sub-type on the
+      #   envelope names the specific milestone and is additive — that vocabulary comes
+      #   from registries and carriers, which are parties Sent does not control.
+      #
+      #   Status means provisioning and compliance are complete, not that a send will
+      #   succeed right now. An account can be suspended, or a destination blocked by a
+      #   routing rule, without either showing up here. Those are separate surfaces and
+      #   deliberately not modelled on this payload.
+      #
+      #   @return [Sentdm::Models::ChannelEventPayload, nil]
+      optional :payload, -> { Sentdm::ChannelEventPayload }, nil?: true
+
+      # @!attribute request_id
+      #   The event-specific body.
+      #
+      #   @return [String, nil]
+      optional :request_id, String, nil?: true
+
+      # @!attribute timestamp
+      #   When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
+      #   time, not the time the underlying change happened. Use the timestamp inside the
+      #   payload for the latter.
+      #
+      #   @return [String, nil]
+      optional :timestamp, String
+
+      # @!method initialize(event: nil, field: nil, payload: nil, request_id: nil, timestamp: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::ChannelEvent} for more details.
+      #
+      #   The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
+      #   this shape and varies only in Payload.
+      #
+      #   @param event [String, nil] The specific event within the family, for example message.delivered,
+      #
+      #   @param field [String] The event family, for example message, templates or contact. Route on
+      #
+      #   @param payload [Sentdm::Models::ChannelEventPayload, nil] Body of a channel event: where one of the customer's channels stands in provisio
+      #
+      #   @param request_id [String, nil] The event-specific body.
+      #
+      #   @param timestamp [String] When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
+    end
+  end
+end

data/lib/sentdm/models/channel_event_payload.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class ChannelEventPayload < Sentdm::Internal::Type::BaseModel
+      # @!attribute country
+      #   The market's destination country as an ISO 3166-1 alpha-2 code, for example XK.
+      #   Always present, and the property that identifies this payload among the
+      #   delivered envelopes — see DeliveredWebhookEvents. Every event in this family
+      #   reports one market, and a market has a country.
+      #
+      #   @return [String]
+      required :country, String
+
+      # @!attribute account_id
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :account_id, String
+
+      # @!attribute channel
+      #   The channel this market belongs to: sms, whatsapp, or rcs. Never sent — that
+      #   value belongs to message events, where it names the smart-routing brand rather
+      #   than a channel that can be provisioned.
+      #
+      #   @return [String, nil]
+      optional :channel, String
+
+      # @!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.
+      #
+      #   @return [String, nil]
+      optional :number_type, String, nil?: true
+
+      # @!attribute reason
+      #   Why the market reached this state, when a reason was given — a correction
+      #   explained, or a campaign lapse. Free text, passed through from the registry or
+      #   carrier that wrote it, so treat it as a message to show a human rather than a
+      #   value to branch on.
+      #
+      #   @return [String, nil]
+      optional :reason, String, nil?: true
+
+      # @!attribute sender_value
+      #   The sender itself — a number in E.164, or an alphanumeric sender ID.
+      #
+      #   Always present, and null until a sender exists. The key is on every delivery so
+      #   a subscriber reads one shape rather than branching on whether the field arrived
+      #   — the same choice template_id makes on the message payload.
+      #
+      #   It can carry a value at any point in the lifecycle, not only once the market is
+      #   live: a number ordered and not yet active at the carrier is already known during
+      #   PROVISIONING, and an alphanumeric sender the customer chose themselves is known
+      #   before anything is filed. It is null while the market is still waiting on a
+      #   number, which for a US 10DLC registration is every event up to
+      #   channel.activated.
+      #
+      #   @return [String, nil]
+      optional :sender_value, String, nil?: true
+
+      # @!attribute status
+      #   Where the market stands: PENDING_REVIEW, ACTION_NEEDED, PROVISIONING, ACTIVE or
+      #   INACTIVE. PENDING_REVIEW means a registry or a carrier holds it and the wait is
+      #   theirs; ACTION_NEEDED means it is yours; PROVISIONING means the verdict is in
+      #   and Sent is acquiring the sender; INACTIVE means it had a working sender and no
+      #   longer does.
+      #
+      #   Each event name is the transition into one of these, but the two are separate
+      #   fields and may legitimately differ. A resubmission filed against a market whose
+      #   sender is already live is channel.submitted carrying ACTIVE: a correction is
+      #   with the registry and the sender keeps working. Read both.
+      #
+      #   @return [String, nil]
+      optional :status, String
+
+      # @!attribute updated_at
+      #   When the transition happened, in UTC (yyyy-MM-ddTHH:mm:ssZ).
+      #
+      #   @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)
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::ChannelEventPayload} for more details.
+      #
+      #   Body of a channel event: where one of the customer's channels stands in
+      #   provisioning and compliance. Delivered when a milestone moves — a registration
+      #   filed, a verdict returned, a resubmission asked for, a sender gone live — so a
+      #   customer's own onboarding UI does not have to poll GET /v3/channels.
+      #
+      #   The subject is one item, never the account. A customer's "SMS channel" has no
+      #   status; a market does. Country, NumberType and SenderValue name which one, so a
+      #   customer terminating only to Kosovo never receives an event about US 10DLC.
+      #
+      #   Status is the stable half of the contract. It is the same four-value set GET
+      #   /v3/channels publishes, computed through the same code, so an event and a read
+      #   of the same market cannot disagree. A subscriber that reads nothing but the
+      #   status and the subject fields is a correct subscriber. The sub-type on the
+      #   envelope names the specific milestone and is additive — that vocabulary comes
+      #   from registries and carriers, which are parties Sent does not control.
+      #
+      #   Status means provisioning and compliance are complete, not that a send will
+      #   succeed right now. An account can be suspended, or a destination blocked by a
+      #   routing rule, without either showing up here. Those are separate surfaces and
+      #   deliberately not modelled on this payload.
+      #
+      #   @param country [String] The market's destination country as an ISO 3166-1 alpha-2 code, for example XK.
+      #
+      #   @param account_id [String] The account whose market this is, named as on every other family. When an organi
+      #
+      #   @param channel [String] The channel this market belongs to: sms, whatsapp, or rcs. Never
+      #
+      #   @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
+      #
+      #   @param sender_value [String, nil] The sender itself — a number in E.164, or an alphanumeric sender ID.
+      #
+      #   @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).
+    end
+  end
+end

data/lib/sentdm/models/contact_event.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class ContactEvent < Sentdm::Internal::Type::BaseModel
+      # @!attribute event
+      #   The specific event within the family, for example message.delivered,
+      #   message.received or contact.opt_out. Absent on events that have no subtype, so
+      #   treat it as optional.
+      #
+      #   @return [String, nil]
+      optional :event, String, nil?: true
+
+      # @!attribute field
+      #   The event family, for example message, templates or contact. Route on this
+      #   first, then on event for the specific change.
+      #
+      #   @return [String, nil]
+      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.
+      #
+      #   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.
+      #
+      #   @return [Sentdm::Models::ContactEventPayload, nil]
+      optional :payload, -> { Sentdm::ContactEventPayload }, nil?: true
+
+      # @!attribute request_id
+      #   The event-specific body.
+      #
+      #   @return [String, nil]
+      optional :request_id, String, nil?: true
+
+      # @!attribute timestamp
+      #   When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
+      #   time, not the time the underlying change happened. Use the timestamp inside the
+      #   payload for the latter.
+      #
+      #   @return [String, nil]
+      optional :timestamp, String
+
+      # @!method initialize(event: nil, field: nil, payload: nil, request_id: nil, timestamp: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::ContactEvent} for more details.
+      #
+      #   The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
+      #   this shape and varies only in Payload.
+      #
+      #   @param event [String, nil] The specific event within the family, for example message.delivered,
+      #
+      #   @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 request_id [String, nil] The event-specific body.
+      #
+      #   @param timestamp [String] When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
+    end
+  end
+end

data/lib/sentdm/models/contact_event_payload.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    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.
+      #
+      #   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
+      #   timestamp before you overwrite a newer state with an older one. That timestamp
+      #   is second-precision, so treat two signals stamped in the same second as
+      #   unordered and read the contact resource to settle them.
+      #
+      #   @return [Boolean]
+      required :opt_out, Sentdm::Internal::Type::Boolean
+
+      # @!attribute source
+      #   How the signal reached us. INBOUND_KEYWORD means the contact sent a message
+      #   whose text matched one of the keywords; PROVIDER_SIGNAL means the network
+      #   reported it. A provider signal usually carries no message_id or text, so read
+      #   both for null rather than inferring them from this field.
+      #
+      #   @return [String]
+      required :source, String
+
+      # @!attribute account_id
+      #   The account the contact belongs to. Present so one endpoint can serve several
+      #   accounts.
+      #
+      #   @return [String, nil]
+      optional :account_id, String
+
+      # @!attribute channel
+      #   The channel the signal arrived on, for example sms or whatsapp.
+      #
+      #   @return [String, nil]
+      optional :channel, String
+
+      # @!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.
+      #
+      #   @return [String, nil]
+      optional :contact_id, 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.
+      #
+      #   Sent as null when the signal did not arrive as a message — for example when a
+      #   network processed an opt-out on your behalf — and also when the message belongs
+      #   to a different account than this event, which can happen on a shared WhatsApp
+      #   number. The field is always present, so read it and check for null rather than
+      #   checking whether the key exists.
+      #
+      #   @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.
+      #
+      #   @return [String, nil]
+      optional :phone_number, String
+
+      # @!attribute text
+      #   The text the contact sent, for example STOP or UNSUBSCRIBE. Sent as null when
+      #   the signal did not arrive as text. The field is always present, so read it and
+      #   check for null rather than checking whether the key exists.
+      #
+      #   @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)
+      #   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.
+      #
+      #   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.
+      #
+      #   @param opt_out [Boolean] Whether the contact is opted out after this signal — the state to write to your
+      #
+      #   @param source [String] How the signal reached us. INBOUND_KEYWORD means the contact sent a message whos
+      #
+      #   @param account_id [String] The account the contact belongs to. Present so one endpoint can serve several ac
+      #
+      #   @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 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 text [String, nil] The text the contact sent, for example STOP or UNSUBSCRIBE. Sent as
+    end
+  end
+end

data/lib/sentdm/models/inbound_message_event.rb

@@ -4,16 +4,16 @@ module Sentdm
   module Models
     class InboundMessageEvent < Sentdm::Internal::Type::BaseModel
       # @!attribute event
-      #   The specific event within the family, for example message.delivered or
-      #   message.received. Absent on events that have no subtype, so treat it as
-      #   optional.
+      #   The specific event within the family, for example message.delivered,
+      #   message.received or contact.opt_out. Absent on events that have no subtype, so
+      #   treat it as optional.
       #
       #   @return [String, nil]
       optional :event, String, nil?: true
 
       # @!attribute field
-      #   The event family, for example message or templates. Route on this first, then on
-      #   event for the specific change.
+      #   The event family, for example message, templates or contact. Route on this
+      #   first, then on event for the specific change.
       #
       #   @return [String, nil]
       optional :field, String
@@ -25,6 +25,12 @@ module Sentdm
       #   @return [Sentdm::Models::InboundMessageEventPayload, nil]
       optional :payload, -> { Sentdm::InboundMessageEventPayload }, nil?: true
 
+      # @!attribute request_id
+      #   The event-specific body.
+      #
+      #   @return [String, nil]
+      optional :request_id, String, nil?: true
+
       # @!attribute timestamp
       #   When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
       #   time, not the time the underlying change happened. Use the timestamp inside the
@@ -33,19 +39,21 @@ module Sentdm
       #   @return [String, nil]
       optional :timestamp, String
 
-      # @!method initialize(event: nil, field: nil, payload: nil, timestamp: nil)
+      # @!method initialize(event: nil, field: nil, payload: nil, request_id: nil, timestamp: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::InboundMessageEvent} for more details.
       #
       #   The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
       #   this shape and varies only in Payload.
       #
-      #   @param event [String, nil] The specific event within the family, for example message.delivered or
+      #   @param event [String, nil] The specific event within the family, for example message.delivered,
       #
-      #   @param field [String] The event family, for example message or templates. Route on this first, then
+      #   @param field [String] The event family, for example message, templates or contact. Route on
       #
       #   @param payload [Sentdm::Models::InboundMessageEventPayload, nil] Body of a message.received event. Delivered when a contact messages one of your
       #
+      #   @param request_id [String, nil] The event-specific body.
+      #
       #   @param timestamp [String] When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
     end
   end

data/lib/sentdm/models/message_event.rb

@@ -4,16 +4,16 @@ module Sentdm
   module Models
     class MessageEvent < Sentdm::Internal::Type::BaseModel
       # @!attribute event
-      #   The specific event within the family, for example message.delivered or
-      #   message.received. Absent on events that have no subtype, so treat it as
-      #   optional.
+      #   The specific event within the family, for example message.delivered,
+      #   message.received or contact.opt_out. Absent on events that have no subtype, so
+      #   treat it as optional.
       #
       #   @return [String, nil]
       optional :event, String, nil?: true
 
       # @!attribute field
-      #   The event family, for example message or templates. Route on this first, then on
-      #   event for the specific change.
+      #   The event family, for example message, templates or contact. Route on this
+      #   first, then on event for the specific change.
       #
       #   @return [String, nil]
       optional :field, String
@@ -26,6 +26,12 @@ module Sentdm
       #   @return [Sentdm::Models::MessageEventPayload, nil]
       optional :payload, -> { Sentdm::MessageEventPayload }, nil?: true
 
+      # @!attribute request_id
+      #   The event-specific body.
+      #
+      #   @return [String, nil]
+      optional :request_id, String, nil?: true
+
       # @!attribute timestamp
       #   When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
       #   time, not the time the underlying change happened. Use the timestamp inside the
@@ -34,19 +40,21 @@ module Sentdm
       #   @return [String, nil]
       optional :timestamp, String
 
-      # @!method initialize(event: nil, field: nil, payload: nil, timestamp: nil)
+      # @!method initialize(event: nil, field: nil, payload: nil, request_id: nil, timestamp: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::MessageEvent} for more details.
       #
       #   The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
       #   this shape and varies only in Payload.
       #
-      #   @param event [String, nil] The specific event within the family, for example message.delivered or
+      #   @param event [String, nil] The specific event within the family, for example message.delivered,
       #
-      #   @param field [String] The event family, for example message or templates. Route on this first, then
+      #   @param field [String] The event family, for example message, templates or contact. Route on
       #
       #   @param payload [Sentdm::Models::MessageEventPayload, nil] Body of an outbound message lifecycle event. Delivered once per status change, s
       #
+      #   @param request_id [String, nil] The event-specific body.
+      #
       #   @param timestamp [String] When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
     end
   end

data/lib/sentdm/models/message_event_payload.rb

@@ -23,6 +23,14 @@ module Sentdm
       #   @return [String, nil]
       optional :agent_id, String, nil?: true
 
+      # @!attribute body
+      #   The rendered message body, as plain text. Sent as null when we aren't asserting
+      #   a body for this event. The field is always present, so read it and check for
+      #   null rather than checking whether the key exists. Truncated to 3072 characters.
+      #
+      #   @return [String, nil]
+      optional :body, String, nil?: true
+
       # @!attribute channel
       #   The channel the message went out on, for example sms or whatsapp. A message that
       #   falls back to another channel reports the channel actually used.
@@ -62,7 +70,7 @@ module Sentdm
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(message_status:, account_id: nil, agent_id: 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, template_id: nil, template_name: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::MessageEventPayload} for more details.
       #
@@ -76,6 +84,8 @@ module Sentdm
       #
       #   @param agent_id [String, nil] The agent attributed to the send, when the send was attributed to one.
       #
+      #   @param body [String, nil] The rendered message body, as plain text. Sent as null when we aren't asserting
+      #
       #   @param channel [String] The channel the message went out on, for example sms or whatsapp. A message
       #
       #   @param message_id [String] The message this event describes. Stable across every event in the message's lif

data/lib/sentdm/models/template.rb

@@ -17,6 +17,23 @@ module Sentdm
       #   @return [String, nil]
       optional :id, String
 
+      # @!attribute auto_reply_action
+      #   Which consent keyword this template answers, when it is one of Sent's
+      #   auto-replies: OPT_IN, OPT_OUT, HELP, or OTHER for a customer-defined keyword.
+      #   Null for an ordinary template, and omitted from the response, so its presence is
+      #   the answer to "is this an auto-reply".
+      #
+      #   Deliberately not required, unlike CustomerId, even though the same "no single
+      #   mapper" argument applies: NJsonSchema publishes a C# required member in the
+      #   schema's required array, so the contract would have advertised a field this
+      #   response omits for every ordinary template, and a generated client could refuse
+      #   the common case. A compile-time guard is not worth a wrong published contract.
+      #   Every mapping site sets it explicitly, and TemplateResponseSchemaTests pins the
+      #   field as optional so it cannot be reintroduced.
+      #
+      #   @return [String, nil]
+      optional :auto_reply_action, String, nil?: true
+
       # @!attribute category
       #   Template category: MARKETING, UTILITY, AUTHENTICATION
       #
@@ -24,7 +41,18 @@ module Sentdm
       optional :category, String
 
       # @!attribute channels
-      #   Supported channels: sms, whatsapp
+      #   The channels this template's definition can render on, in canonical order: sms,
+      #   whatsapp, rcs.
+      #
+      #   Derived from the definition's body, mirroring each channel's send-time fallback
+      #   chain, so a channel is listed only when a real body would be produced for it:
+      #   SMS reads sms ?? multiChannel, WhatsApp reads whatsapp ?? multiChannel, and RCS
+      #   reads rcs ?? multiChannel ?? sms. A multiChannel body therefore reports all
+      #   three, and the extra SMS fallback on RCS is why an sms/whatsapp pair reports RCS
+      #   too.
+      #
+      #   This says what the content can render on, not what may be sent: sending also
+      #   needs the template approved for that channel.
       #
       #   @return [Array<String>, nil]
       optional :channels, Sentdm::Internal::Type::ArrayOf[String], nil?: true
@@ -54,7 +82,8 @@ module Sentdm
       optional :name, String
 
       # @!attribute status
-      #   Template status: APPROVED, PENDING, REJECTED
+      #   Template status: DRAFT, PENDING, APPROVED, REJECTED. A template created with
+      #   submit_for_review: false starts as DRAFT and stays there until it is submitted.
       #
       #   @return [String, nil]
       optional :status, String
@@ -71,7 +100,7 @@ module Sentdm
       #   @return [Array<String>, nil]
       optional :variables, Sentdm::Internal::Type::ArrayOf[String], nil?: true
 
-      # @!method initialize(customer_id:, id: nil, category: nil, channels: nil, created_at: nil, is_published: nil, language: nil, name: nil, status: nil, updated_at: nil, variables: nil)
+      # @!method initialize(customer_id:, id: nil, auto_reply_action: nil, category: nil, channels: nil, created_at: nil, is_published: nil, language: nil, name: nil, status: nil, updated_at: nil, variables: nil)
       #   Some parameter documentations has been truncated, see {Sentdm::Models::Template}
       #   for more details.
       #
@@ -81,9 +110,11 @@ module Sentdm
       #
       #   @param id [String] Unique template identifier
       #
+      #   @param auto_reply_action [String, nil] Which consent keyword this template answers, when it is one of Sent's auto-repli
+      #
       #   @param category [String] Template category: MARKETING, UTILITY, AUTHENTICATION
       #
-      #   @param channels [Array<String>, nil] Supported channels: sms, whatsapp
+      #   @param channels [Array<String>, nil] The channels this template's definition can render on, in canonical order: sms,
       #
       #   @param created_at [Time] When the template was created
       #
@@ -93,7 +124,7 @@ module Sentdm
       #
       #   @param name [String] Template display name
       #
-      #   @param status [String] Template status: APPROVED, PENDING, REJECTED
+      #   @param status [String] Template status: DRAFT, PENDING, APPROVED, REJECTED. A template created with
       #
       #   @param updated_at [Time, nil] When the template was last updated
       #