sentdm 0.26.0 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebdb5fd6a174b30850e1b33607c0c7acaa61fecae6564e0567d1f5ef1e957cc8
-  data.tar.gz: 830ae5cb38a33f35ff78031b19d31dac59f280a5fd48275e660d93fa4f54a457
+  metadata.gz: b1fe0d0bd33cc0f7333bc39ef8e8dad0e38b2c1d3452a443bb16f7de1b4c14fc
+  data.tar.gz: 2aff81314575ca55fb4ba7f39e9ea9370c6ad389f89aa4ef7bd51723a3f51a03
 SHA512:
-  metadata.gz: 37b4f50c8af9746b8c2c1cd498715ce6f7dce3d765a60926a6cfcff9a43952045cb8c2938d0880968d803709f19751eb4f25baf5c8df83f949b1e56f9222d54e
-  data.tar.gz: 616928315abcb21dfcb69ba3011d1a61b0583982c552d8102d5a0812a0482e6ed75fcd0073586a666ff95fbfd4bba8ad86895766b21c5f2a68208b0b3d37a26a
+  metadata.gz: 91b34527619316f7093d7716bc75d24f7e6df54b992f8e1bf302d9646f2e5909a7ef0f318976ca22fad58947a70d4f0c3f1f75a3101af185256769e82afc020a
+  data.tar.gz: c839bc5eedae76bfc24e8601d0da3ed4ca8bfbe25473e36d6b794ecdb9a7f13636974b581acc2e6d219668a5c196f27b334dd84a2a5b4b11fdde78d40744c884

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [0.27.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.26.0...v0.27.0) (2026-08-17)
+
+
+### Highlights
+
+Webhook payloads are now typed. The events Sent POSTs to your endpoint — `MessageEvent`, `InboundMessageEvent` and `TemplateEvent`, each with its own payload type — are generated types you can deserialize into, instead of a shape you had to hand-write from the docs.
+
+The webhook delivery log is typed too. `event_data` on `GET /v3/webhooks/{id}/events` returns the exact envelope that was delivered, and now describes itself as one of those three rather than an opaque object.
+
+Also in this release:
+
+- `csp_id` on the brand object is deprecated and will be removed in a later release. It identifies the Campaign Service Provider that registered the brand, which is Sent, so the value is the same for every account. There is no replacement. Your own TCR identifiers, `tcr_brand_id` and `universal_ein`, are unaffected.
+- Corrected descriptions for blocked sends, which now name the cases that gate a send before any delivery attempt: insufficient balance, a template not approved for sending, and free-form content with no open conversation.
+- `campaign.volume` documents what an omitted value does. Leave it out and the campaign registers as standard, the higher-fee tier, with no error.
+
+### Features
+
+* **api:** sync OpenAPI spec from production ([3913d60](https://github.com/sentdm/sent-dm-ruby/commit/3913d6099298feaa278b76ac8a44f7809e13e815))
+* **api:** sync OpenAPI spec from production ([cb9fb87](https://github.com/sentdm/sent-dm-ruby/commit/cb9fb87ae298bc8c33adcc9f3960102215502d47))
+* **api:** sync OpenAPI spec from production ([8690f90](https://github.com/sentdm/sent-dm-ruby/commit/8690f905c974d5c45da6f6b1c9b0883b550c871f))
+* **sdk:** expose the delivered webhook payloads as models ([4b43f3f](https://github.com/sentdm/sent-dm-ruby/commit/4b43f3f16729ec3ee3736149308ffc7ada08480a))
+
+
+### Chores
+
+* add eager seal-dispatch workflow ([c005db3](https://github.com/sentdm/sent-dm-ruby/commit/c005db35357a408367f76e964e00912f5fc83116))
+
 ## [0.26.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.25.0...v0.26.0) (2026-08-08)
 
 

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

data/lib/sentdm/models/inbound_message_event.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+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.
+      #
+      #   @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.
+      #
+      #   @return [String, nil]
+      optional :field, String
+
+      # @!attribute payload
+      #   Body of a message.received event. Delivered when a contact messages one of your
+      #   numbers.
+      #
+      #   @return [Sentdm::Models::InboundMessageEventPayload, nil]
+      optional :payload, -> { Sentdm::InboundMessageEventPayload }, 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, 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 field [String] The event family, for example message or templates. Route on this first, then
+      #
+      #   @param payload [Sentdm::Models::InboundMessageEventPayload, nil] Body of a message.received event. Delivered when a contact messages one of your
+      #
+      #   @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/inbound_message_event_payload.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class InboundMessageEventPayload < Sentdm::Internal::Type::BaseModel
+      # @!attribute account_id
+      #   The account the message belongs to.
+      #
+      #   @return [String, nil]
+      optional :account_id, String
+
+      # @!attribute channel
+      #   The channel the message arrived on, for example sms or whatsapp.
+      #
+      #   @return [String, nil]
+      optional :channel, String
+
+      # @!attribute inbound_number
+      #   The contact's number in E.164 format, meaning the number the message came from.
+      #
+      #   @return [String, nil]
+      optional :inbound_number, String
+
+      # @!attribute message_id
+      #   The inbound message.
+      #
+      #   @return [String, nil]
+      optional :message_id, String
+
+      # @!attribute outbound_number
+      #   Your number in E.164 format, meaning the number the message was addressed to.
+      #
+      #   @return [String, nil]
+      optional :outbound_number, String
+
+      # @!attribute received_at
+      #   When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ).
+      #
+      #   @return [String, nil]
+      optional :received_at, String
+
+      # @!attribute text
+      #   The message body. Sent as null when the inbound message carried no text, for
+      #   example a media-only message. 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
+
+      # @!attribute updated_at
+      #   When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ). Same value as
+      #   ReceivedAt, kept for envelope consistency with outbound events.
+      #
+      #   @return [String, nil]
+      optional :updated_at, String
+
+      # @!method initialize(account_id: nil, channel: nil, inbound_number: nil, message_id: nil, outbound_number: nil, received_at: nil, text: nil, updated_at: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::InboundMessageEventPayload} for more details.
+      #
+      #   Body of a message.received event. Delivered when a contact messages one of your
+      #   numbers.
+      #
+      #   @param account_id [String] The account the message belongs to.
+      #
+      #   @param channel [String] The channel the message arrived on, for example sms or whatsapp.
+      #
+      #   @param inbound_number [String] The contact's number in E.164 format, meaning the number the message came from.
+      #
+      #   @param message_id [String] The inbound message.
+      #
+      #   @param outbound_number [String] Your number in E.164 format, meaning the number the message was addressed to.
+      #
+      #   @param received_at [String] When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ).
+      #
+      #   @param text [String, nil] The message body. Sent as null when the inbound message carried no text, for
+      #
+      #   @param updated_at [String] When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ). Same value as
+    end
+  end
+end

data/lib/sentdm/models/message_event.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+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.
+      #
+      #   @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.
+      #
+      #   @return [String, nil]
+      optional :field, String
+
+      # @!attribute payload
+      #   Body of an outbound message lifecycle event. Delivered once per status change,
+      #   so a single message produces several of these as it moves toward a terminal
+      #   status.
+      #
+      #   @return [Sentdm::Models::MessageEventPayload, nil]
+      optional :payload, -> { Sentdm::MessageEventPayload }, 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, 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 field [String] The event family, for example message or templates. Route on this first, then
+      #
+      #   @param payload [Sentdm::Models::MessageEventPayload, nil] Body of an outbound message lifecycle event. Delivered once per status change, s
+      #
+      #   @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/message_event_payload.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class MessageEventPayload < Sentdm::Internal::Type::BaseModel
+      # @!attribute account_id
+      #   The account the message belongs to.
+      #
+      #   @return [String, nil]
+      optional :account_id, String
+
+      # @!attribute agent_id
+      #   The agent attributed to the send, when the send was attributed to one.
+      #
+      #   @return [String, nil]
+      optional :agent_id, 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.
+      #
+      #   @return [String, nil]
+      optional :channel, String
+
+      # @!attribute message_id
+      #   The message this event describes. Stable across every event in the message's
+      #   lifecycle, so use it to correlate them.
+      #
+      #   @return [String, nil]
+      optional :message_id, String
+
+      # @!attribute message_status
+      #   The status the message just reached, for example SENT, DELIVERED, or FAILED.
+      #   Sent means dispatched and delivered means confirmed, so treat them as distinct
+      #   outcomes.
+      #
+      #   @return [String, nil]
+      optional :message_status, String
+
+      # @!attribute outbound_number
+      #   The recipient's number in E.164 format.
+      #
+      #   @return [String, nil]
+      optional :outbound_number, String
+
+      # @!attribute template_id
+      #   The template the message was sent from, when it was sent from one.
+      #
+      #   @return [String, nil]
+      optional :template_id, String, nil?: true
+
+      # @!attribute template_name
+      #   Name of the template the message was sent from. Omitted when the message wasn't
+      #   template-based.
+      #
+      #   @return [String, nil]
+      optional :template_name, String, nil?: true
+
+      # @!attribute updated_at
+      #   When the message reached MessageStatus, in UTC (yyyy-MM-ddTHH:mm:ssZ).
+      #
+      #   @return [String, nil]
+      optional :updated_at, String
+
+      # @!method initialize(account_id: nil, agent_id: nil, channel: nil, message_id: nil, message_status: 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.
+      #
+      #   Body of an outbound message lifecycle event. Delivered once per status change,
+      #   so a single message produces several of these as it moves toward a terminal
+      #   status.
+      #
+      #   @param account_id [String] The account the message belongs to.
+      #
+      #   @param agent_id [String, nil] The agent attributed to the send, when the send was attributed to one.
+      #
+      #   @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
+      #
+      #   @param message_status [String] The status the message just reached, for example SENT, DELIVERED, or
+      #
+      #   @param outbound_number [String] The recipient's number in E.164 format.
+      #
+      #   @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
+      #
+      #   @param updated_at [String] When the message reached MessageStatus, in UTC
+    end
+  end
+end

data/lib/sentdm/models/profile_detail.rb

@@ -276,7 +276,12 @@ module Sentdm
         optional :created_at, Time
 
         # @!attribute csp_id
-        #   CSP (Campaign Service Provider) ID
+        #   @deprecated
+        #
+        #   Deprecated and scheduled for removal. Identifies the Campaign Service Provider
+        #   that registered the brand, which is Sent, so the value is the same for every
+        #   brand and every account. Nothing on your side can act on it and there is no
+        #   replacement. Stop reading it.
         #
         #   @return [String, nil]
         optional :csp_id, String, nil?: true
@@ -328,6 +333,9 @@ module Sentdm
         optional :updated_at, Time, nil?: true
 
         # @!method initialize(id: nil, business: nil, compliance: nil, contact: nil, created_at: nil, csp_id: nil, identity_status: nil, is_inherited: nil, status: nil, submitted_at: nil, submitted_to_tcr: nil, tcr_brand_id: nil, universal_ein: nil, updated_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Sentdm::Models::ProfileDetail::Brand} for more details.
+        #
         #   Brand response with nested contact, business, and compliance sections — mirrors
         #   the request structure.
         #
@@ -341,7 +349,7 @@ module Sentdm
         #
         #   @param created_at [Time] When the brand was created
         #
-        #   @param csp_id [String, nil] CSP (Campaign Service Provider) ID
+        #   @param csp_id [String, nil] Deprecated and scheduled for removal. Identifies the Campaign Service Provider t
         #
         #   @param identity_status [Symbol, Sentdm::Models::ProfileDetail::Brand::IdentityStatus, nil]
         #

data/lib/sentdm/models/profiles/campaign_data.rb

@@ -86,7 +86,7 @@ module Sentdm
 
         # @!attribute volume
         #   Expected messaging volume for this campaign. Numeric string (e.g. "1999",
-        #   "5000"); values below 2000 bill at the low-volume tier.
+        #   "5000"). Values below 2000 bill at the low-volume tier.
         #
         #   @return [String, nil]
         optional :volume, String, nil?: true

data/lib/sentdm/models/template_event.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class TemplateEvent < 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.
+      #
+      #   @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.
+      #
+      #   @return [String, nil]
+      optional :field, String
+
+      # @!attribute payload
+      #   Body of a template status event. Delivered when a template's review outcome
+      #   changes, so you can react without polling.
+      #
+      #   @return [Sentdm::Models::TemplateEventPayload, nil]
+      optional :payload, -> { Sentdm::TemplateEventPayload }, 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, timestamp: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::TemplateEvent} 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 field [String] The event family, for example message or templates. Route on this first, then
+      #
+      #   @param payload [Sentdm::Models::TemplateEventPayload, nil] Body of a template status event. Delivered when a template's review outcome chan
+      #
+      #   @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/template_event_payload.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class TemplateEventPayload < Sentdm::Internal::Type::BaseModel
+      # @!attribute account_id
+      #   The account the template belongs to.
+      #
+      #   @return [String, nil]
+      optional :account_id, String
+
+      # @!attribute category
+      #   The template's category, for example UTILITY, MARKETING, or AUTHENTICATION.
+      #
+      #   @return [String, nil]
+      optional :category, String
+
+      # @!attribute channel
+      #   The channel the template applies to.
+      #
+      #   @return [String, nil]
+      optional :channel, String
+
+      # @!attribute language
+      #   The template's language code, for example en_US.
+      #
+      #   @return [String, nil]
+      optional :language, String
+
+      # @!attribute reason
+      #   Why the template reached Status, when a reason was given. Populated on a
+      #   rejection.
+      #
+      #   @return [String, nil]
+      optional :reason, String, nil?: true
+
+      # @!attribute status
+      #   The review status the template just reached, for example APPROVED or REJECTED.
+      #
+      #   @return [String, nil]
+      optional :status, String
+
+      # @!attribute template_id
+      #   The template in Sent.
+      #
+      #   @return [String, nil]
+      optional :template_id, String
+
+      # @!attribute template_name
+      #   The template's display name.
+      #
+      #   @return [String, nil]
+      optional :template_name, String
+
+      # @!attribute whatsapp_template_id
+      #   The template's identifier with Meta, assigned when the template is submitted for
+      #   review.
+      #
+      #   @return [String, nil]
+      optional :whatsapp_template_id, String
+
+      # @!method initialize(account_id: nil, category: nil, channel: nil, language: nil, reason: nil, status: nil, template_id: nil, template_name: nil, whatsapp_template_id: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::TemplateEventPayload} for more details.
+      #
+      #   Body of a template status event. Delivered when a template's review outcome
+      #   changes, so you can react without polling.
+      #
+      #   @param account_id [String] The account the template belongs to.
+      #
+      #   @param category [String] The template's category, for example UTILITY, MARKETING, or
+      #
+      #   @param channel [String] The channel the template applies to.
+      #
+      #   @param language [String] The template's language code, for example en_US.
+      #
+      #   @param reason [String, nil] Why the template reached Status, when a reason was given. Populated on a
+      #
+      #   @param status [String] The review status the template just reached, for example APPROVED or
+      #
+      #   @param template_id [String] The template in Sent.
+      #
+      #   @param template_name [String] The template's display name.
+      #
+      #   @param whatsapp_template_id [String] The template's identifier with Meta, assigned when the template is submitted for
+    end
+  end
+end

data/lib/sentdm/models/webhook_list_events_response.rb

@@ -87,9 +87,13 @@ module Sentdm
           optional :error_message, String, nil?: true
 
           # @!attribute event_data
+          #   The exact event body that was delivered, or attempted, for this record. One of
+          #   the three webhook envelopes: a message status change, an inbound message, or a
+          #   template status change. Read field and event to tell which, the same way your
+          #   endpoint does.
           #
-          #   @return [Object, nil]
-          optional :event_data, Sentdm::Internal::Type::Unknown
+          #   @return [Sentdm::Models::MessageEvent, Sentdm::Models::InboundMessageEvent, Sentdm::Models::TemplateEvent, nil]
+          optional :event_data, union: -> { Sentdm::Models::WebhookListEventsResponse::Data::Event::EventData }
 
           # @!attribute event_type
           #
@@ -117,17 +121,55 @@ module Sentdm
           optional :response_body, String, nil?: true
 
           # @!method initialize(id: nil, created_at: nil, delivery_attempts: nil, delivery_status: nil, error_message: nil, event_data: nil, event_type: nil, http_status_code: nil, processing_completed_at: nil, processing_started_at: nil, response_body: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Sentdm::Models::WebhookListEventsResponse::Data::Event} for more details.
+          #
           #   @param id [String]
+          #
           #   @param created_at [Time]
+          #
           #   @param delivery_attempts [Integer]
+          #
           #   @param delivery_status [String]
+          #
           #   @param error_message [String, nil]
-          #   @param event_data [Object]
+          #
+          #   @param event_data [Sentdm::Models::MessageEvent, Sentdm::Models::InboundMessageEvent, Sentdm::Models::TemplateEvent] The exact event body that was delivered, or attempted, for this record. One of t
+          #
           #   @param event_type [String]
+          #
           #   @param http_status_code [Integer, nil]
+          #
           #   @param processing_completed_at [Time, nil]
+          #
           #   @param processing_started_at [Time, nil]
+          #
           #   @param response_body [String, nil]
+
+          # The exact event body that was delivered, or attempted, for this record. One of
+          # the three webhook envelopes: a message status change, an inbound message, or a
+          # template status change. Read field and event to tell which, the same way your
+          # endpoint does.
+          #
+          # @see Sentdm::Models::WebhookListEventsResponse::Data::Event#event_data
+          module EventData
+            extend Sentdm::Internal::Type::Union
+
+            # The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares this shape and
+            # varies only in Payload.
+            variant -> { Sentdm::MessageEvent }
+
+            # The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares this shape and
+            # varies only in Payload.
+            variant -> { Sentdm::InboundMessageEvent }
+
+            # The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares this shape and
+            # varies only in Payload.
+            variant -> { Sentdm::TemplateEvent }
+
+            # @!method self.variants
+            #   @return [Array(Sentdm::Models::MessageEvent, Sentdm::Models::InboundMessageEvent, Sentdm::Models::TemplateEvent)]
+          end
         end
       end
     end

data/lib/sentdm/models.rb

@@ -93,8 +93,16 @@ module Sentdm
 
   ErrorDetail = Sentdm::Models::ErrorDetail
 
+  InboundMessageEvent = Sentdm::Models::InboundMessageEvent
+
+  InboundMessageEventPayload = Sentdm::Models::InboundMessageEventPayload
+
   MeRetrieveParams = Sentdm::Models::MeRetrieveParams
 
+  MessageEvent = Sentdm::Models::MessageEvent
+
+  MessageEventPayload = Sentdm::Models::MessageEventPayload
+
   MessageRetrieveActivitiesParams = Sentdm::Models::MessageRetrieveActivitiesParams
 
   MessageRetrieveStatusParams = Sentdm::Models::MessageRetrieveStatusParams
@@ -147,6 +155,10 @@ module Sentdm
 
   TemplateDeleteParams = Sentdm::Models::TemplateDeleteParams
 
+  TemplateEvent = Sentdm::Models::TemplateEvent
+
+  TemplateEventPayload = Sentdm::Models::TemplateEventPayload
+
   TemplateFooter = Sentdm::Models::TemplateFooter
 
   TemplateHeader = Sentdm::Models::TemplateHeader

data/lib/sentdm/resources/messages.rb

@@ -67,10 +67,12 @@ module Sentdm
       # multi-channel broadcast — when multiple channels are specified (e.g. ["sms",
       # "whatsapp"]), a separate message is created for each (recipient, channel) pair.
       # Returns immediately with per-recipient message IDs for async tracking via
-      # webhooks or the GET /messages/{id} endpoint. Account-level preconditions such as
-      # insufficient balance do not reject the request: the send is accepted with 202
-      # and the affected messages are reported as BLOCKED on GET /messages/{id} and the
-      # message status webhook.
+      # webhooks or the GET /messages/{id} endpoint. Sends gated before any delivery
+      # attempt do not reject the request — an account-level precondition such as
+      # insufficient balance, a template not approved for sending, or free-form content
+      # with no open conversation with the contact. The send is accepted with 202 and
+      # the affected messages are reported as BLOCKED on GET /messages/{id} and the
+      # message.blocked webhook.
       #
       # @overload send_(channel: nil, sandbox: nil, template: nil, text: nil, to: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #

data/lib/sentdm/resources/profiles.rb

@@ -113,7 +113,7 @@ module Sentdm
       #
       # @overload retrieve(profile_id, x_profile_id: nil, request_options: {})
       #
-      # @param profile_id [String]
+      # @param profile_id [String] Profile ID from route parameter
       #
       # @param x_profile_id [String] Profile UUID to scope the request to a child profile. Only organization API keys
       #
@@ -157,7 +157,7 @@ module Sentdm
       #
       # @overload update(profile_id, allow_contact_sharing: nil, allow_number_change_during_onboarding: nil, allow_template_sharing: nil, billing_contact: nil, billing_model: nil, brand: nil, description: nil, icon: nil, inherit_contacts: nil, inherit_tcr_brand: nil, inherit_tcr_campaign: nil, inherit_templates: nil, name: nil, payment_details: nil, sandbox: nil, sending_phone_number: nil, sending_phone_number_profile_id: nil, sending_whatsapp_number_profile_id: nil, short_name: nil, whatsapp_phone_number: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #
-      # @param profile_id [String] Path param
+      # @param profile_id [String] Path param: Profile ID from route parameter
       #
       # @param allow_contact_sharing [Boolean, nil] Body param: Whether contacts are shared across profiles (optional)
       #
@@ -257,7 +257,7 @@ module Sentdm
       #
       # @overload delete(profile_id, sandbox: nil, x_profile_id: nil, request_options: {})
       #
-      # @param profile_id [String] Path param
+      # @param profile_id [String] Path param: Profile ID from route parameter
       #
       # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
       #