rcs 2.0.16.pre.rc.1 → 2.0.16.pre.rc.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2cac8fd3c68928a102bb892cd100493eb70f36a326b1c0eff8d80e9e09654a4
-  data.tar.gz: 702ed3fc0bcafd3836774adcca8cf3f8feb54bcb6120b13c1c9523a5836d5550
+  metadata.gz: 3fd2da2e009d5d8ecd9a2232a8e7aa0b62505b6ab7cab02c16c3a0ad8b12e0f8
+  data.tar.gz: aed5b2fe008ef29a4dbe2bd925c92df56447fb9f5e9f0520eb17d9f3e324b185
 SHA512:
-  metadata.gz: fbeabb07e1998a0f02d5cf7b02faf556e7d2595089daaf0e9f1c4be52a20eb20e130e7b631fb4ed2892fb3beddac5b07f84ddc8b11f782afbcbbd7f85adb0b80
-  data.tar.gz: 1db2d564b8c37db520453732791d53875eff850db2bc8cf1dd5350805f696f3e482eb344d3724a434bc590903f1b49d32e937faa275d87b9239467d34071836b
+  metadata.gz: 498522f2c8408612371282cac32d1102f504d8914da3a8b973b085c7a60aff0f791eb4660b0928002de7fbf1df1f23a66d84c6398b3a8ad0ae811d5ba261d05e
+  data.tar.gz: 2525115821fc93acbcd78049df778f41eda272607d6d069f9190f71c51189296e6aabd9103bc29799c6035f765b9a3e3d75fc32ec273307ec17c3cf141042966

data/.fern/metadata.json

@@ -5,8 +5,9 @@
   "generatorConfig": {
     "clientModuleName": "PinnacleBaseClient",
     "flattenModuleStructure": true,
-    "useProvidedDefaults": true
+    "useProvidedDefaults": true,
+    "rubocopVariableNumberStyle": "snake_case"
   },
-  "originGitCommit": "fb028ee5e2c6395c9680eb66d1173e55015384c0",
-  "sdkVersion": "2.0.16.pre.rc.1"
+  "originGitCommit": "c9cb7751b3bf27100ed65b2122d4bc8b326d34ee",
+  "sdkVersion": "2.0.16.pre.rc.3"
 }

data/.rubocop.yml

@@ -45,11 +45,7 @@ Layout/LineLength:
   Enabled: false
 
 Naming/VariableNumber:
-  # Fern's ruby-sdk generator emits symbols like :gsm_7 / :utf_16 / :code_3
-  # (snake_case) in generated type classes while shipping a template that
-  # enforces `normalcase`. The two are inconsistent, so disable the cop
-  # until the generator resolves it upstream.
-  Enabled: false
+  EnforcedStyle: snake_case
 
 Style/Documentation:
   Enabled: false

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.16.pre.rc.1",
+          "User-Agent" => "rcs/2.0.16.pre.rc.3",
           "X-Fern-Language" => "Ruby",
           "PINNACLE-API-KEY" => api_key.to_s
         }

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/agent_summary_carrier_launches.rb

@@ -2,12 +2,18 @@
 
 module Pinnacle
   module Types
-    # Per-carrier launch status for the agent.
+    # Raw per-carrier launch + verification state for the agent. Each
+    # value is tri-state — `null` means "no launch requested" or "not
+    # sent yet"; `false` means "pending" / "sent"; `true` means
+    # "launched" / "verified". Use the [GET /rcs/{agentId}](/api-reference/rcs-agents/get)
+    # endpoint for the resolved enum representation.
     class AgentSummaryCarrierLaunches < Internal::Types::Model
       field :att, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "ATT"
       field :others, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "OTHERS"
       field :tmobile, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "TMOBILE"
       field :verizon, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "VERIZON"
+      field :aegis, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "AEGIS"
+      field :google, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "GOOGLE"
     end
   end
 end

data/lib/pinnacle/types/campaign_status_event.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Webhook body delivered to subscribers of `CAMPAIGN.STATUS` whenever
+    # an RCS campaign's per-carrier launch status or verification status
+    # (AEGIS / Google) changes. `CAMPAIGN.STATUS` is only supported for
+    # RCS agent senders — the attach call rejects phone-number senders
+    # with `400 Bad Request`. Verify the `PINNACLE-SIGNING-SECRET` header
+    # matches the signing secret of the webhook this event was delivered
+    # to before trusting the payload.
+    class CampaignStatusEvent < Internal::Types::Model
+      field :type, -> { String }, optional: false, nullable: false
+      field :agent, -> { Pinnacle::Types::CampaignStatusEventAgent }, optional: false, nullable: false
+      field :campaign, -> { Pinnacle::Types::CampaignStatusEventCampaign }, optional: false, nullable: false
+      field :brand, -> { Pinnacle::Types::CampaignStatusEventBrand }, optional: false, nullable: false
+      field :carrier_launches, -> { Pinnacle::Types::CampaignStatusEventCarrierLaunches }, optional: false, nullable: false, api_name: "carrierLaunches"
+      field :updated_at, -> { String }, optional: false, nullable: false, api_name: "updatedAt"
+    end
+  end
+end

data/lib/pinnacle/types/campaign_status_event_agent.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # The RCS agent the campaign-status update is for.
+    class CampaignStatusEventAgent < Internal::Types::Model
+      field :id, -> { String }, optional: false, nullable: false
+      field :name, -> { String }, optional: false, nullable: true
+    end
+  end
+end

data/lib/pinnacle/types/campaign_status_event_brand.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Reference to the brand owning the agent's connected campaign.
+    class CampaignStatusEventBrand < Internal::Types::Model
+      field :public_id, -> { String }, optional: false, nullable: true, api_name: "publicId"
+      field :name, -> { String }, optional: false, nullable: true
+    end
+  end
+end

data/lib/pinnacle/types/campaign_status_event_campaign.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Reference to the connected campaign.
+    class CampaignStatusEventCampaign < Internal::Types::Model
+      field :public_id, -> { String }, optional: false, nullable: true, api_name: "publicId"
+      field :type, -> { Pinnacle::Types::CampaignStatusEventCampaignType }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/campaign_status_event_campaign_type.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    module CampaignStatusEventCampaignType
+      extend Pinnacle::Internal::Types::Enum
+
+      RCS = "RCS"
+      TOLL_FREE = "TOLL_FREE"
+      TEN_DLC = "10DLC"
+    end
+  end
+end

data/lib/pinnacle/types/campaign_status_event_carrier_launches.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Resolved per-key launch status for the campaign's agent. Carrier
+    # statuses live under `carriers` and verifier statuses under
+    # `verification`.
+    class CampaignStatusEventCarrierLaunches < Internal::Types::Model
+      field :carriers, -> { Pinnacle::Types::CampaignStatusEventCarrierLaunchesCarriers }, optional: false, nullable: false
+      field :verification, -> { Pinnacle::Types::CampaignStatusEventCarrierLaunchesVerification }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/campaign_status_event_carrier_launches_carriers.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Per-carrier launch status. Each carrier moves through
+    # `NOT_LAUNCHED` → `PENDING` → `LAUNCHED` as Pinnacle submits the
+    # agent for review and the carrier accepts it. The agent is only
+    # deliverable on a carrier once that carrier reports `LAUNCHED`.
+    class CampaignStatusEventCarrierLaunchesCarriers < Internal::Types::Model
+      field :att, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "ATT"
+      field :tmobile, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "TMOBILE"
+      field :verizon, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "VERIZON"
+      field :others, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "OTHERS"
+    end
+  end
+end

data/lib/pinnacle/types/campaign_status_event_carrier_launches_verification.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # External verifier status. AEGIS (the U.S. carrier vetting
+    # authority used by AT&T, T-Mobile, and Verizon) and Google each
+    # send a verification email to the brand's contact address. Each
+    # verifier moves through `NOT_SENT` → `SENT` → `VERIFIED` once
+    # the brand replies and the verifier confirms ownership.
+    class CampaignStatusEventCarrierLaunchesVerification < Internal::Types::Model
+      field :aegis, -> { Pinnacle::Types::VerificationStatus }, optional: false, nullable: false, api_name: "AEGIS"
+      field :google, -> { Pinnacle::Types::VerificationStatus }, optional: false, nullable: false, api_name: "GOOGLE"
+    end
+  end
+end

data/lib/pinnacle/types/carrier_launches.rb

@@ -2,12 +2,12 @@
 
 module Pinnacle
   module Types
-    # Per-carrier launch status.
+    # Per-carrier launch status grouped by category. `carriers` covers
+    # AT&T / T-Mobile / Verizon / other carriers; `verification` covers
+    # the AEGIS and Google verification flows.
     class CarrierLaunches < Internal::Types::Model
-      field :att, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "ATT"
-      field :tmobile, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "TMOBILE"
-      field :verizon, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "VERIZON"
-      field :others, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "OTHERS"
+      field :carriers, -> { Pinnacle::Types::CarrierLaunchesCarriers }, optional: false, nullable: false
+      field :verification, -> { Pinnacle::Types::CarrierLaunchesVerification }, optional: false, nullable: false
     end
   end
 end

data/lib/pinnacle/types/carrier_launches_carriers.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Per-carrier launch status. Each carrier moves through
+    # `NOT_LAUNCHED` → `PENDING` → `LAUNCHED` as Pinnacle submits the
+    # agent for review and the carrier accepts it. The agent is only
+    # deliverable on a carrier once that carrier reports `LAUNCHED`.
+    class CarrierLaunchesCarriers < Internal::Types::Model
+      field :att, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "ATT"
+      field :tmobile, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "TMOBILE"
+      field :verizon, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "VERIZON"
+      field :others, -> { Pinnacle::Types::CarrierLaunchStatus }, optional: false, nullable: false, api_name: "OTHERS"
+    end
+  end
+end

data/lib/pinnacle/types/carrier_launches_verification.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # External verifier status. AEGIS (the U.S. carrier vetting
+    # authority used by AT&T, T-Mobile, and Verizon) and Google each
+    # send a verification email to the brand's contact address. Each
+    # verifier moves through `NOT_SENT` → `SENT` → `VERIFIED` once
+    # the brand replies and the verifier confirms ownership.
+    class CarrierLaunchesVerification < Internal::Types::Model
+      field :aegis, -> { Pinnacle::Types::VerificationStatus }, optional: false, nullable: false, api_name: "AEGIS"
+      field :google, -> { Pinnacle::Types::VerificationStatus }, optional: false, nullable: false, api_name: "GOOGLE"
+    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/verification_status.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    module VerificationStatus
+      extend Pinnacle::Internal::Types::Enum
+
+      NOT_SENT = "NOT_SENT"
+      SENT = "SENT"
+      VERIFIED = "VERIFIED"
+    end
+  end
+end

data/lib/pinnacle/types/webhook_event_enum.rb

@@ -9,6 +9,7 @@ module Pinnacle
       MESSAGE_RECEIVED = "MESSAGE.RECEIVED"
       USER_TYPING = "USER.TYPING"
       FORM_SUBMISSION = "FORM.SUBMISSION"
+      CAMPAIGN_STATUS = "CAMPAIGN.STATUS"
     end
   end
 end

data/lib/pinnacle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pinnacle
-  VERSION = "2.0.16.pre.rc.1"
+  VERSION = "2.0.16.pre.rc.3"
 end

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

@@ -19,7 +19,7 @@ module Pinnacle
         # @param request [Hash] Request with :headers and :body keys
         # @param secret [String, nil] Webhook secret (falls back to PINNACLE_SIGNING_SECRET env var)
         #
-        # @return [Pinnacle::Types::MessageEvent, Pinnacle::Types::UserEvent]
+        # @return [Pinnacle::Types::MessageEvent, Pinnacle::Types::UserEvent, Pinnacle::Types::FormSubmissionEvent, Pinnacle::Types::CampaignStatusEvent]
         # @raise [Pinnacle::Errors::UnauthorizedError] If webhook signature is invalid or missing
         # @raise [Pinnacle::Errors::ClientError] If request body cannot be parsed
         def process(request, secret: nil)
@@ -55,8 +55,13 @@ module Pinnacle
 
           parsed = body.is_a?(String) ? JSON.parse(body) : body
 
-          if parsed["type"] == "USER.TYPING"
+          case parsed["type"]
+          when "USER.TYPING"
             Pinnacle::Types::UserEvent.coerce(parsed)
+          when "FORM.SUBMISSION"
+            Pinnacle::Types::FormSubmissionEvent.coerce(parsed)
+          when "CAMPAIGN.STATUS"
+            Pinnacle::Types::CampaignStatusEvent.coerce(parsed)
           else
             Pinnacle::Types::MessageEvent.coerce(parsed)
           end

data/lib/pinnacle.rb

@@ -375,6 +375,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"
@@ -394,6 +408,9 @@ require_relative "pinnacle/types/detached_phone_number_result"
 require_relative "pinnacle/types/owned_phone_number"
 require_relative "pinnacle/types/list_phone_numbers_response"
 require_relative "pinnacle/types/carrier_launch_status"
+require_relative "pinnacle/types/verification_status"
+require_relative "pinnacle/types/carrier_launches_carriers"
+require_relative "pinnacle/types/carrier_launches_verification"
 require_relative "pinnacle/types/carrier_launches"
 require_relative "pinnacle/types/rcs_agent_details_phones_item"
 require_relative "pinnacle/types/rcs_agent_details_emails_item"
@@ -503,6 +520,14 @@ require_relative "pinnacle/types/message_event_fallback_message"
 require_relative "pinnacle/types/message_event"
 require_relative "pinnacle/types/user_event_conversation"
 require_relative "pinnacle/types/user_event"
+require_relative "pinnacle/types/campaign_status_event_agent"
+require_relative "pinnacle/types/campaign_status_event_campaign_type"
+require_relative "pinnacle/types/campaign_status_event_campaign"
+require_relative "pinnacle/types/campaign_status_event_brand"
+require_relative "pinnacle/types/campaign_status_event_carrier_launches_carriers"
+require_relative "pinnacle/types/campaign_status_event_carrier_launches_verification"
+require_relative "pinnacle/types/campaign_status_event_carrier_launches"
+require_relative "pinnacle/types/campaign_status_event"
 require_relative "pinnacle/types/form_submission_event_conversation"
 require_relative "pinnacle/types/form_submission_event_form"
 require_relative "pinnacle/types/form_submission_answer"
@@ -550,10 +575,10 @@ require_relative "pinnacle/webhooks/types/detach_webhook_params"
 require_relative "pinnacle/forms/client"
 require_relative "pinnacle/forms/types/update_form_params"
 require_relative "pinnacle/forms/types/list_forms_params"
+require_relative "pinnacle/campaigns/client"
 require_relative "pinnacle/audiences/contacts/client"
 require_relative "pinnacle/audiences/contacts/types/remove_contacts_params"
 require_relative "pinnacle/audiences/contacts/types/add_contacts_params"
-require_relative "pinnacle/campaigns/client"
 require_relative "pinnacle/campaigns/dlc/client"
 require_relative "pinnacle/campaigns/dlc/types/upsert_dlc_campaign_params"
 require_relative "pinnacle/campaigns/dlc/types/list_dlc_campaigns_params"
@@ -580,6 +605,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

@@ -2855,7 +2855,7 @@ Supplying `headers` alongside `webhookId` **overwrites** the stored headers on t
 
 Event type filter for the subscription. Set to `null` to receive all events. <br>
 
-`USER.TYPING` is only supported for RCS agent senders, not phone numbers.
+`USER.TYPING` and `CAMPAIGN.STATUS` are only supported for RCS agent senders, not phone numbers — attempting to attach either of these events to a phone number returns `400 Bad Request`.
     
 </dd>
 </dl>
@@ -6421,6 +6421,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.16.pre.rc.1
+  version: 2.0.16.pre.rc.3
 platform: ruby
 authors:
 - Pinnacle
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-24 00:00:00.000000000 Z
+date: 2026-05-03 00:00:00.000000000 Z
 dependencies: []
 description: The Pinnacle Ruby library provides convenient access to the Pinnacle
   API from Ruby.
@@ -165,6 +165,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
@@ -278,11 +279,21 @@ files:
 - lib/pinnacle/types/buy_response_capabilities.rb
 - lib/pinnacle/types/campaign_enum.rb
 - lib/pinnacle/types/campaign_query.rb
+- lib/pinnacle/types/campaign_status_event.rb
+- lib/pinnacle/types/campaign_status_event_agent.rb
+- lib/pinnacle/types/campaign_status_event_brand.rb
+- lib/pinnacle/types/campaign_status_event_campaign.rb
+- lib/pinnacle/types/campaign_status_event_campaign_type.rb
+- lib/pinnacle/types/campaign_status_event_carrier_launches.rb
+- lib/pinnacle/types/campaign_status_event_carrier_launches_carriers.rb
+- lib/pinnacle/types/campaign_status_event_carrier_launches_verification.rb
 - lib/pinnacle/types/campaign_submission_result.rb
 - lib/pinnacle/types/campaign_validation_response_errors_item.rb
 - lib/pinnacle/types/campaign_validation_result.rb
 - lib/pinnacle/types/carrier_launch_status.rb
 - lib/pinnacle/types/carrier_launches.rb
+- lib/pinnacle/types/carrier_launches_carriers.rb
+- lib/pinnacle/types/carrier_launches_verification.rb
 - lib/pinnacle/types/checkbox_field.rb
 - lib/pinnacle/types/color_field.rb
 - lib/pinnacle/types/company_entity_type_enum.rb
@@ -550,6 +561,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
@@ -589,6 +605,15 @@ files:
 - lib/pinnacle/types/updated_contact_id.rb
 - lib/pinnacle/types/upload_results.rb
 - lib/pinnacle/types/url_field.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
@@ -609,6 +634,7 @@ files:
 - lib/pinnacle/types/vcard_email.rb
 - lib/pinnacle/types/vcard_phone.rb
 - lib/pinnacle/types/vcard_resource.rb
+- lib/pinnacle/types/verification_status.rb
 - lib/pinnacle/types/vetting_feedback.rb
 - lib/pinnacle/types/vetting_history.rb
 - lib/pinnacle/types/vetting_history_vetting_status.rb