rcs 2.0.15 → 2.0.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3edce2029ee0605b95569ddf5681f98c17041bb376e2d480487cac489f7a3373
-  data.tar.gz: c8ab3851d9d26d7502df2c3183c35525d7aed0b18831fbbf100b158f001cb3a8
+  metadata.gz: af1df4309329865c8db83166a625b88da9d2247b9657cbce4964e260a8cef0d2
+  data.tar.gz: edaebb702d60e2e0d2cefaca64210f518641ed5d4c7455cda0f87abd3409c33a
 SHA512:
-  metadata.gz: 2bde1ac9823654bb075fafb0fee86d1b7874fc6f9b161021efbf11ae1cdbc465e1db7791c0e87fd15d9c01693f2994946156485f9ba40e318a1968174852ed6c
-  data.tar.gz: eca831fdf06ad136fa518a08bd5fe00782d2e86c512a433af37dd7a741148d1bc3762c22a873cf9061a68eeb7c3044e7ca865fa717985f615e4b5739a65a46c7
+  metadata.gz: 518bb3cb3e93e4f69310e5ed0a4556756544746c740d15aa4fe3b888db72d6979c5ccf03eaa71d5c46d0aaf2deb5ebf5aabf4ee1f95d9ae6fbf4a1c0ddc88bc8
+  data.tar.gz: b20e523cdc367b741b4b20c2d3bb7b6c2481891540670b06fe4ba8b5a2f2442608fc51e0f518333d77b5ceb9e1cf1d099c25f53f9a1de46ae5a51ea49a608a51

data/.fern/metadata.json

@@ -1,5 +1,5 @@
 {
-  "cliVersion": "3.51.3",
+  "cliVersion": "4.58.0",
   "generatorName": "fernapi/fern-ruby-sdk",
   "generatorVersion": "1.0.0-rc85",
   "generatorConfig": {
@@ -7,5 +7,6 @@
     "flattenModuleStructure": true,
     "useProvidedDefaults": true
   },
-  "sdkVersion": "2.0.15"
+  "originGitCommit": "fbc56cbecaab985e0a6ae7ecc7de124c3d4d57d8",
+  "sdkVersion": "2.0.16"
 }

data/.rubocop.yml

@@ -58,3 +58,22 @@ Minitest/MultipleAssertions:
 
 Minitest/UselessAssertion:
   Enabled: false
+
+# The generator emits bare `value` expressions as the fall-through result
+# of `case` blocks; rubocop flags these as void. Excluded here so the
+# suppressions survive Fern regeneration.
+Lint/Void:
+  Exclude:
+    - 'lib/pinnacle/internal/types/boolean.rb'
+    - 'lib/pinnacle/internal/types/utils.rb'
+
+# `Union.member?` is not a collection `include?`; the Minitest cops
+# don't distinguish them. Excluded for the union test file so Fern
+# regeneration doesn't need to preserve inline disables.
+Minitest/AssertIncludes:
+  Exclude:
+    - 'test/unit/internal/types/test_union.rb'
+
+Minitest/RefuteIncludes:
+  Exclude:
+    - 'test/unit/internal/types/test_union.rb'

data/lib/pinnacle/client.rb

@@ -10,7 +10,7 @@ module Pinnacle
       @raw_client = Pinnacle::Internal::Http::RawClient.new(
         base_url: base_url || Pinnacle::Environment::DEFAULT,
         headers: {
-          "User-Agent" => "rcs/2.0.15",
+          "User-Agent" => "rcs/2.0.16",
           "X-Fern-Language" => "Ruby",
           "PINNACLE-API-KEY" => api_key.to_s
         }

data/lib/pinnacle/internal/types/boolean.rb

@@ -17,7 +17,7 @@ module Pinnacle
         def self.coerce(value, strict: strict?)
           case value
           when TrueClass, FalseClass
-            return value
+            value
           when Integer
             return value == 1
           when String

data/lib/pinnacle/internal/types/utils.rb

@@ -81,10 +81,10 @@ module Pinnacle
                }
               return type.coerce(value, strict: strict)
             else
-              return value
+              value
             end
           else
-            return value
+            value
           end
 
           raise Errors::TypeError, "cannot coerce value of type `#{value.class}` to `#{target}`" if strict

data/lib/pinnacle/messages/client.rb

@@ -146,6 +146,11 @@ module Pinnacle
       def blasts
         @blasts ||= Pinnacle::Messages::Blasts::Client.new(client: @client)
       end
+
+      # @return [Pinnacle::Simulate::Client]
+      def simulate
+        @simulate ||= Pinnacle::Messages::Simulate::Client.new(client: @client)
+      end
     end
   end
 end

data/lib/pinnacle/messages/simulate/client.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Simulate
+      class Client
+        # @param client [Pinnacle::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Simulate inbound messages and button presses from a user.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Types::SimulateUserParams]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        #
+        # @return [Pinnacle::Types::SimulateUserResponse]
+        def user(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "messages/simulate/user",
+            body: Pinnacle::Types::SimulateUserParams.new(params).to_h,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Pinnacle::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            Pinnacle::Types::SimulateUserResponse.load(response.body)
+          else
+            error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/types/attach_webhook_response_webhook.rb

@@ -7,6 +7,7 @@ module Pinnacle
       field :name, -> { String }, optional: false, nullable: false
       field :url, -> { String }, optional: false, nullable: false
       field :secret, -> { String }, optional: false, nullable: false
+      field :headers, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
     end
   end
 end

data/lib/pinnacle/types/extended_brand_with_vetting.rb

@@ -3,8 +3,8 @@
 module Pinnacle
   module Types
     class ExtendedBrandWithVetting < Internal::Types::Model
-      field :last_tcr_vetting_date, -> { String }, optional: false, nullable: true, api_name: "lastTcrVettingDate"
-      field :tcr_feedback, -> { Internal::Types::Array[Pinnacle::Types::VettingFeedback] }, optional: false, nullable: true, api_name: "tcrFeedback"
+      field :last_tcr_vetting_date, -> { String }, optional: false, nullable: false, api_name: "lastTcrVettingDate"
+      field :tcr_feedback, -> { Internal::Types::Array[Pinnacle::Types::VettingFeedback] }, optional: false, nullable: false, api_name: "tcrFeedback"
       field :vetting_history, -> { Internal::Types::Array[Pinnacle::Types::VettingHistory] }, optional: false, nullable: false, api_name: "vettingHistory"
     end
   end

data/lib/pinnacle/types/rcs_cards_content.rb

@@ -7,7 +7,7 @@ module Pinnacle
     # See (supported file types)[https://app.pinnacle.sh/supported-file-types?type=RCS-CARD].
     class RcsCardsContent < Internal::Types::Model
       field :cards, -> { Internal::Types::Array[Pinnacle::Types::RcsCardsContentCardsItem] }, optional: false, nullable: false
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
     end
   end
 end

data/lib/pinnacle/types/rcs_cards_content_cards_item.rb

@@ -4,7 +4,7 @@ module Pinnacle
   module Types
     # Individual card containing title, optional media, and action buttons.
     class RcsCardsContentCardsItem < Internal::Types::Model
-      field :buttons, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false
+      field :buttons, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false
       field :media, -> { Pinnacle::Types::RcsMediaDetailsContent }, optional: true, nullable: false
       field :subtitle, -> { String }, optional: true, nullable: false
       field :title, -> { String }, optional: false, nullable: false

data/lib/pinnacle/types/rcs_media_content.rb

@@ -7,7 +7,7 @@ module Pinnacle
     # See (supported file types)[https://app.pinnacle.sh/supported-file-types?type=RCS-MEDIA].
     class RcsMediaContent < Internal::Types::Model
       field :media, -> { Pinnacle::Types::RcsMediaDetailsContent }, optional: false, nullable: false
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
     end
   end
 end

data/lib/pinnacle/types/rcs_validate_content_media.rb

@@ -7,7 +7,7 @@ module Pinnacle
     # See [supported media types](https://app.pinnacle.sh/supported-file-types?type=RCS-MEDIA).
     class RcsValidateContentMedia < Internal::Types::Model
       field :media, -> { String }, optional: false, nullable: false
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
     end
   end
 end

data/lib/pinnacle/types/rich_card.rb

@@ -4,7 +4,7 @@ module Pinnacle
   module Types
     # Individual card containing title, optional media, and action buttons.
     class RichCard < Internal::Types::Model
-      field :buttons, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false
+      field :buttons, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false
       field :media, -> { String }, optional: true, nullable: false
       field :subtitle, -> { String }, optional: true, nullable: false
       field :title, -> { String }, optional: false, nullable: false

data/lib/pinnacle/types/rich_cards.rb

@@ -7,7 +7,7 @@ module Pinnacle
     # See (supported file types)[https://app.pinnacle.sh/supported-file-types?type=RCS-CARD].
     class RichCards < Internal::Types::Model
       field :cards, -> { Internal::Types::Array[Pinnacle::Types::RichCard] }, optional: false, nullable: false
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
     end
   end
 end

data/lib/pinnacle/types/rich_media_message.rb

@@ -4,7 +4,7 @@ module Pinnacle
   module Types
     class RichMediaMessage < Internal::Types::Model
       field :media, -> { String }, optional: false, nullable: false
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
     end
   end
 end

data/lib/pinnacle/types/rich_text.rb

@@ -4,7 +4,7 @@ module Pinnacle
   module Types
     # Message containing longer text content with optional quick reply buttons.
     class RichText < Internal::Types::Model
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
       field :text, -> { String }, optional: false, nullable: false
     end
   end

data/lib/pinnacle/types/send_rich_cards_options.rb

@@ -2,7 +2,12 @@
 
 module Pinnacle
   module Types
+    # Configure how your RCS message is sent and tracked.
     class SendRichCardsOptions < Internal::Types::Model
+      field :schedule, -> { Pinnacle::Types::MessageSchedule }, optional: true, nullable: false
+      field :tracking, -> { Pinnacle::Types::Tracking }, optional: true, nullable: false
+      field :transcode, -> { Internal::Types::Boolean }, optional: true, nullable: false
+      field :validate, -> { Internal::Types::Boolean }, optional: true, nullable: false
       field :standalone_card, -> { Pinnacle::Types::RichStandaloneCardOptions }, optional: true, nullable: false
     end
   end

data/lib/pinnacle/types/send_rich_message_options_4.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Configure how your RCS message is sent and tracked.
+    class SendRichMessageOptions4 < Internal::Types::Model
+      field :schedule, -> { Pinnacle::Types::MessageSchedule }, optional: true, nullable: false
+      field :tracking, -> { Pinnacle::Types::Tracking }, optional: true, nullable: false
+      field :transcode, -> { Internal::Types::Boolean }, optional: true, nullable: false
+      field :validate, -> { Internal::Types::Boolean }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/simulate_message_input.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # User message payload. At least one of `text` or `mediaUrls` must be non-empty.
+    # Send only `text` to simulate an inbound SMS; include `mediaUrls` to simulate an inbound MMS.
+    class SimulateMessageInput < Internal::Types::Model
+      field :text, -> { String }, optional: true, nullable: false
+      field :media_urls, -> { Internal::Types::Array[String] }, optional: true, nullable: false, api_name: "mediaUrls"
+    end
+  end
+end

data/lib/pinnacle/types/simulate_user_button.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Simulate a button press from a user.
+    class SimulateUserButton < Internal::Types::Model
+      field :from, -> { String }, optional: false, nullable: false
+      field :to, -> { String }, optional: false, nullable: false
+      field :button, -> { Pinnacle::Types::UserButtonPress }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/simulate_user_message.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Simulate an inbound message from a user.
+    class SimulateUserMessage < Internal::Types::Model
+      field :from, -> { String }, optional: false, nullable: false
+      field :to, -> { String }, optional: false, nullable: false
+      field :message, -> { Pinnacle::Types::SimulateMessageInput }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/simulate_user_params.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Request body for simulating an inbound event from a user.
+    class SimulateUserParams < Internal::Types::Model
+      extend Pinnacle::Internal::Types::Union
+
+      member -> { Pinnacle::Types::SimulateUserMessage }
+      member -> { Pinnacle::Types::SimulateUserButton }
+    end
+  end
+end

data/lib/pinnacle/types/simulate_user_response.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Result of the simulation.
+    class SimulateUserResponse < Internal::Types::Model
+      field :success, -> { Internal::Types::Boolean }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/user_button_press.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Discriminated union of button presses that can be simulated for a user.
+    class UserButtonPress < Internal::Types::Model
+      extend Pinnacle::Internal::Types::Union
+
+      discriminant :type
+
+      member -> { Pinnacle::Types::UserButtonPressTrigger }, key: "TRIGGER"
+      member -> { Pinnacle::Types::UserButtonPressOpenUrl }, key: "OPEN_URL"
+      member -> { Pinnacle::Types::UserButtonPressCall }, key: "CALL"
+      member -> { Pinnacle::Types::UserButtonPressScheduleEvent }, key: "SCHEDULE_EVENT"
+      member -> { Pinnacle::Types::UserButtonPressSendLocation }, key: "SEND_LOCATION"
+      member -> { Pinnacle::Types::UserButtonPressRequestUserLocation }, key: "REQUEST_USER_LOCATION"
+    end
+  end
+end

data/lib/pinnacle/types/user_button_press_call.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Simulates when a user presses a `call` button.
+    class UserButtonPressCall < Internal::Types::Model
+      field :title, -> { String }, optional: false, nullable: false
+      field :metadata, -> { String }, optional: true, nullable: false
+      field :payload, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/user_button_press_open_url.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Simulates when a user presses an `openUrl` button.
+    class UserButtonPressOpenUrl < Internal::Types::Model
+      field :title, -> { String }, optional: false, nullable: false
+      field :metadata, -> { String }, optional: true, nullable: false
+      field :payload, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/user_button_press_request_user_location.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Simulates when a user presses a `requestUserLocation` button.
+    class UserButtonPressRequestUserLocation < Internal::Types::Model
+      field :title, -> { String }, optional: false, nullable: false
+      field :metadata, -> { String }, optional: true, nullable: false
+      field :location, -> { Pinnacle::Types::UserButtonPressRequestUserLocationLocation }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/user_button_press_request_user_location_location.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Location the simulated user responded with.
+    class UserButtonPressRequestUserLocationLocation < Internal::Types::Model
+      field :text, -> { String }, optional: true, nullable: false
+      field :latitude, -> { Integer }, optional: true, nullable: false
+      field :longitude, -> { Integer }, optional: true, nullable: false
+      field :address, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/user_button_press_schedule_event.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Simulates when a user presses a `scheduleEvent` button.
+    class UserButtonPressScheduleEvent < Internal::Types::Model
+      field :title, -> { String }, optional: false, nullable: false
+      field :metadata, -> { String }, optional: true, nullable: false
+      field :event_start_time, -> { String }, optional: true, nullable: false, api_name: "eventStartTime"
+      field :event_end_time, -> { String }, optional: true, nullable: false, api_name: "eventEndTime"
+      field :event_title, -> { String }, optional: true, nullable: false, api_name: "eventTitle"
+      field :event_description, -> { String }, optional: true, nullable: false, api_name: "eventDescription"
+    end
+  end
+end

data/lib/pinnacle/types/user_button_press_send_location.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Simulates when a user presses a `sendLocation` button.
+    class UserButtonPressSendLocation < Internal::Types::Model
+      field :title, -> { String }, optional: false, nullable: false
+      field :metadata, -> { String }, optional: true, nullable: false
+      field :name, -> { String }, optional: true, nullable: false
+      field :lat_long, -> { Pinnacle::Types::UserButtonPressSendLocationLatLong }, optional: true, nullable: false, api_name: "latLong"
+    end
+  end
+end

data/lib/pinnacle/types/user_button_press_send_location_lat_long.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Shared coordinates.
+    class UserButtonPressSendLocationLatLong < Internal::Types::Model
+      field :lat, -> { Integer }, optional: true, nullable: false
+      field :lng, -> { Integer }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/user_button_press_trigger.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Simulates when a user presses a `trigger` button.
+    class UserButtonPressTrigger < Internal::Types::Model
+      field :title, -> { String }, optional: false, nullable: false
+      field :metadata, -> { String }, optional: true, nullable: false
+      field :payload, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/vcard_content.rb

@@ -3,7 +3,7 @@
 module Pinnacle
   module Types
     class VcardContent < Internal::Types::Model
-      field :revision, -> { String }, optional: true, nullable: false
+      field :revision, -> { String }, optional: false, nullable: false
     end
   end
 end

data/lib/pinnacle/types/webhook_summary.rb

@@ -9,6 +9,7 @@ module Pinnacle
       field :status, -> { Pinnacle::Types::WebhookSummaryStatus }, optional: false, nullable: false
       field :created_at, -> { String }, optional: false, nullable: false, api_name: "createdAt"
       field :updated_at, -> { String }, optional: false, nullable: false, api_name: "updatedAt"
+      field :headers, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
     end
   end
 end

data/lib/pinnacle/types/webhooks.rb

@@ -7,6 +7,7 @@ module Pinnacle
       field :endpoint, -> { String }, optional: false, nullable: false
       field :id, -> { String }, optional: false, nullable: false
       field :name, -> { String }, optional: false, nullable: false
+      field :headers, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
     end
   end
 end

data/lib/pinnacle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pinnacle
-  VERSION = "2.0.15"
+  VERSION = "2.0.16"
 end

data/lib/pinnacle/webhooks/client.rb

@@ -85,7 +85,13 @@ module Pinnacle
       # Supports bulk operations with up to 50 senders per request. <br>
       #
       # Subscriptions are additive — attaching new senders does not remove existing ones. Re-attaching the same sender
-      # updates the event type filter without creating duplicates.
+      # updates the event type filter without creating duplicates. <br>
+      #
+      # **Custom headers** may be provided in either case via the optional `headers` field. When attaching a new
+      # webhook, the headers are stored on the webhook and sent on every delivery. When attaching an existing
+      # `webhookId`, supplying `headers` **overwrites** the stored headers on that webhook — omit the field to leave
+      # them unchanged, or pass an empty object `{}` to clear them. The reserved `PINNACLE-SIGNING-SECRET` header is
+      # always set by Pinnacle and cannot be overridden.
       #
       # @param request_options [Hash]
       # @param params [Pinnacle::Webhooks::Types::AttachWebhookParams]

data/lib/pinnacle/webhooks/types/attach_webhook_params.rb

@@ -9,6 +9,7 @@ module Pinnacle
         field :name, -> { String }, optional: true, nullable: false
         field :url, -> { String }, optional: true, nullable: false
         field :event, -> { Pinnacle::Types::WebhookEventEnum }, optional: true, nullable: false
+        field :headers, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
       end
     end
   end

data/lib/pinnacle.rb

@@ -302,6 +302,7 @@ require_relative "pinnacle/types/rich_text_message"
 require_relative "pinnacle/types/rich_media_message"
 require_relative "pinnacle/types/rich_card"
 require_relative "pinnacle/types/rich_cards"
+require_relative "pinnacle/types/send_rich_message_options_4"
 require_relative "pinnacle/types/send_rcs_card_options_standalone_card_orientation"
 require_relative "pinnacle/types/send_rcs_card_options_standalone_card_image_alignment"
 require_relative "pinnacle/types/rich_standalone_card_options"
@@ -333,6 +334,20 @@ require_relative "pinnacle/types/list_scheduled_messages_response"
 require_relative "pinnacle/types/blast_summary_type"
 require_relative "pinnacle/types/blast_summary"
 require_relative "pinnacle/types/list_blasts_response"
+require_relative "pinnacle/types/simulate_message_input"
+require_relative "pinnacle/types/simulate_user_message"
+require_relative "pinnacle/types/user_button_press_trigger"
+require_relative "pinnacle/types/user_button_press_open_url"
+require_relative "pinnacle/types/user_button_press_call"
+require_relative "pinnacle/types/user_button_press_schedule_event"
+require_relative "pinnacle/types/user_button_press_send_location_lat_long"
+require_relative "pinnacle/types/user_button_press_send_location"
+require_relative "pinnacle/types/user_button_press_request_user_location_location"
+require_relative "pinnacle/types/user_button_press_request_user_location"
+require_relative "pinnacle/types/user_button_press"
+require_relative "pinnacle/types/simulate_user_button"
+require_relative "pinnacle/types/simulate_user_params"
+require_relative "pinnacle/types/simulate_user_response"
 require_relative "pinnacle/types/phone_feature_enum"
 require_relative "pinnacle/types/phone_enum"
 require_relative "pinnacle/types/phone_number_cost"
@@ -514,6 +529,7 @@ require_relative "pinnacle/messages/schedules/client"
 require_relative "pinnacle/messages/schedules/types/list_scheduled_messages_params"
 require_relative "pinnacle/messages/blasts/client"
 require_relative "pinnacle/messages/blasts/types/list_blasts_params"
+require_relative "pinnacle/messages/simulate/client"
 require_relative "pinnacle/phone_numbers/campaign/client"
 require_relative "pinnacle/phone_numbers/campaign/types/attach_campaign_params"
 require_relative "pinnacle/phone_numbers/campaign/types/detach_campaign_params"

data/reference.md

@@ -2783,7 +2783,9 @@ Attach a webhook to one or more senders (phone numbers or RCS agent IDs) to rece
 
 You can attach an existing webhook by providing its ID, or create a new webhook by specifying a name and URL. Supports bulk operations with up to 50 senders per request. <br>
 
-Subscriptions are additive — attaching new senders does not remove existing ones. Re-attaching the same sender updates the event type filter without creating duplicates.
+Subscriptions are additive — attaching new senders does not remove existing ones. Re-attaching the same sender updates the event type filter without creating duplicates. <br>
+
+**Custom headers** may be provided in either case via the optional `headers` field. When attaching a new webhook, the headers are stored on the webhook and sent on every delivery. When attaching an existing `webhookId`, supplying `headers` **overwrites** the stored headers on that webhook — omit the field to leave them unchanged, or pass an empty object `{}` to clear them. The reserved `PINNACLE-SIGNING-SECRET` header is always set by Pinnacle and cannot be overridden.
 </dd>
 </dl>
 </dd>
@@ -2821,7 +2823,11 @@ client.webhooks.attach(senders: ['+14155551234', 'agent_abc123']);
 <dl>
 <dd>
 
-**webhook_id:** `String` — Existing webhook ID (starts with `wh_`). Provide this OR `name` + `url` to create a new webhook. The webhook must be in ENABLED status. Disabled webhooks can be re-enabled from the [dashboard](https://app.pinnacle.sh/dashboard/development/webhooks).
+**webhook_id:** `String` 
+
+Existing webhook ID (starts with `wh_`). Provide this OR `name` + `url` to create a new webhook. The webhook must be in ENABLED status. Disabled webhooks can be re-enabled from the [dashboard](https://app.pinnacle.sh/dashboard/development/webhooks).
+
+Supplying `headers` alongside `webhookId` **overwrites** the stored headers on the webhook. Omit `headers` to leave them unchanged.
     
 </dd>
 </dl>
@@ -2857,6 +2863,22 @@ Event type filter for the subscription. Set to `null` to receive all events. <br
 <dl>
 <dd>
 
+**headers:** `Internal::Types::Hash[String, String]` 
+
+Optional custom HTTP headers (key-value map) to include when dispatching webhook events to the endpoint.
+
+Header names must start with a letter or digit and contain only letters, digits, `-`, or `_` (matching the pattern `^[A-Za-z0-9][A-Za-z0-9_-]*$`). Names are case-insensitive per [RFC 9110](https://datatracker.ietf.org/doc/html/rfc9110#name-field-names) and are normalized to uppercase before storage and sending.
+
+When provided with an existing `webhookId`, these headers **overwrite** any headers currently stored on that webhook. Omit to leave existing headers unchanged.
+
+The reserved `PINNACLE-SIGNING-SECRET` header is silently ignored and cannot be overridden.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **request_options:** `Pinnacle::Webhooks::RequestOptions` 
     
 </dd>
@@ -5109,7 +5131,6 @@ Requires an active RCS agent and recipient devices that support RCS Business Mes
 client.messages.rcs.send_(
   from: 'from',
   to: 'to',
-  quick_replies: [],
   text: 'text'
 );
 ```
@@ -5264,10 +5285,7 @@ Validate RCS message content without sending it.
 <dd>
 
 ```ruby
-client.messages.rcs.validate(
-  quick_replies: [],
-  text: 'text'
-);
+client.messages.rcs.validate(text: 'text');
 ```
 </dd>
 </dl>
@@ -5897,6 +5915,75 @@ client.messages.blasts.list();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Messages Simulate
+<details><summary><code>client.messages.simulate.<a href="/lib/pinnacle/messages/simulate/client.rb">user</a>(request) -> Pinnacle::Types::SimulateUserResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Simulate inbound messages and button presses from a user.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.messages.simulate.user(
+  from: '+14155551234',
+  to: '+14155555678',
+  message: {
+    text: 'Hello from the test user!'
+  }
+);
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Pinnacle::Types::SimulateUserParams` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Pinnacle::Messages::Simulate::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rcs
 version: !ruby/object:Gem::Version
-  version: 2.0.15
+  version: 2.0.16
 platform: ruby
 authors:
 - Pinnacle
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-29 00:00:00.000000000 Z
+date: 2026-04-22 00:00:00.000000000 Z
 dependencies: []
 description: The Pinnacle Ruby library provides convenient access to the Pinnacle
   API from Ruby.
@@ -159,6 +159,7 @@ files:
 - lib/pinnacle/messages/schedules/types/list_scheduled_messages_params.rb
 - lib/pinnacle/messages/schedules/types/list_scheduled_messages_request_schedule_type.rb
 - lib/pinnacle/messages/schedules/types/list_scheduled_messages_request_status.rb
+- lib/pinnacle/messages/simulate/client.rb
 - lib/pinnacle/messages/sms/client.rb
 - lib/pinnacle/messages/sms/types/send_sms_options.rb
 - lib/pinnacle/messages/sms/types/sms.rb
@@ -477,6 +478,7 @@ files:
 - lib/pinnacle/types/send_rcs_card_options_standalone_card_orientation.rb
 - lib/pinnacle/types/send_rich_cards_options.rb
 - lib/pinnacle/types/send_rich_message_options.rb
+- lib/pinnacle/types/send_rich_message_options_4.rb
 - lib/pinnacle/types/send_sms_response_segments.rb
 - lib/pinnacle/types/send_sms_response_segments_encoding.rb
 - lib/pinnacle/types/send_typing_indicator_response.rb
@@ -488,6 +490,11 @@ files:
 - lib/pinnacle/types/sent_sms_details.rb
 - lib/pinnacle/types/shortened_url.rb
 - lib/pinnacle/types/shortened_url_with_click_data.rb
+- lib/pinnacle/types/simulate_message_input.rb
+- lib/pinnacle/types/simulate_user_button.rb
+- lib/pinnacle/types/simulate_user_message.rb
+- lib/pinnacle/types/simulate_user_params.rb
+- lib/pinnacle/types/simulate_user_response.rb
 - lib/pinnacle/types/sms_content.rb
 - lib/pinnacle/types/sms_validation_response_segments.rb
 - lib/pinnacle/types/sms_validation_response_segments_gsm_7.rb
@@ -523,6 +530,15 @@ files:
 - lib/pinnacle/types/tracking.rb
 - lib/pinnacle/types/updated_contact_id.rb
 - lib/pinnacle/types/upload_results.rb
+- lib/pinnacle/types/user_button_press.rb
+- lib/pinnacle/types/user_button_press_call.rb
+- lib/pinnacle/types/user_button_press_open_url.rb
+- lib/pinnacle/types/user_button_press_request_user_location.rb
+- lib/pinnacle/types/user_button_press_request_user_location_location.rb
+- lib/pinnacle/types/user_button_press_schedule_event.rb
+- lib/pinnacle/types/user_button_press_send_location.rb
+- lib/pinnacle/types/user_button_press_send_location_lat_long.rb
+- lib/pinnacle/types/user_button_press_trigger.rb
 - lib/pinnacle/types/user_event.rb
 - lib/pinnacle/types/user_event_conversation.rb
 - lib/pinnacle/types/v_card_address_schema_type_item.rb