rcs 2.0.14 → 2.0.16

data/lib/pinnacle/types/webhook_event_enum.rb

@@ -7,6 +7,7 @@ module Pinnacle
 
       MESSAGE_STATUS = "MESSAGE.STATUS"
       MESSAGE_RECEIVED = "MESSAGE.RECEIVED"
+      USER_TYPING = "USER.TYPING"
     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.14"
+  VERSION = "2.0.16"
 end

data/lib/pinnacle/webhooks/client.rb

@@ -77,6 +77,91 @@ module Pinnacle
           raise error_class.new(response.body, code: code)
         end
       end
+
+      # Attach a webhook to one or more senders (phone numbers or RCS agent IDs) to receive real-time event
+      # notifications. <br>
+      #
+      # 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. <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]
+      # @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::AttachWebhookResult]
+      def attach(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: "webhooks/attach",
+          body: Pinnacle::Webhooks::Types::AttachWebhookParams.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::AttachWebhookResult.load(response.body)
+        else
+          error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Detach a webhook from one or more senders (phone numbers or RCS agent IDs) to stop receiving event
+      # notifications. <br>
+      #
+      # The webhook itself is not deleted and remains available for use with other senders. Works regardless of webhook
+      # status. Supports bulk operations with up to 50 senders per request.
+      #
+      # @param request_options [Hash]
+      # @param params [Pinnacle::Webhooks::Types::DetachWebhookParams]
+      # @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::DetachWebhookResult]
+      def detach(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: "webhooks/detach",
+          body: Pinnacle::Webhooks::Types::DetachWebhookParams.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::DetachWebhookResult.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

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

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Webhooks
+    module Types
+      class AttachWebhookParams < Internal::Types::Model
+        field :senders, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+        field :webhook_id, -> { String }, optional: true, nullable: false, api_name: "webhookId"
+        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
+end

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

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Webhooks
+    module Types
+      class DetachWebhookParams < Internal::Types::Model
+        field :webhook_id, -> { String }, optional: false, nullable: false, api_name: "webhookId"
+        field :senders, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/pinnacle.rb

@@ -110,14 +110,12 @@ require_relative "pinnacle/campaigns/toll_free/types/toll_free_campaign_opt_in"
 require_relative "pinnacle/campaigns/toll_free/types/toll_free_campaign_options"
 require_relative "pinnacle/campaigns/toll_free/types/toll_free_campaign_use_case"
 require_relative "pinnacle/campaigns/toll_free/types/list_toll_free_campaigns_request_status"
-require_relative "pinnacle/types/rcs_campaign_use_case_enum"
 require_relative "pinnacle/types/rcs_messaging_type_enum"
 require_relative "pinnacle/types/rcs_campaign_schema_agent_emails_item"
 require_relative "pinnacle/types/rcs_campaign_schema_agent_phones_item"
 require_relative "pinnacle/types/rcs_campaign_schema_agent_websites_item"
 require_relative "pinnacle/types/rcs_campaign_schema_agent"
 require_relative "pinnacle/types/rcs_campaign_schema_links"
-require_relative "pinnacle/types/rcs_campaign_schema_use_case"
 require_relative "pinnacle/types/rcs_campaign_schema_keywords_help"
 require_relative "pinnacle/types/rcs_campaign_schema_keywords_opt_in"
 require_relative "pinnacle/types/rcs_campaign_schema_keywords_opt_out"
@@ -130,7 +128,6 @@ require_relative "pinnacle/campaigns/rcs/types/rcs_agent_phone"
 require_relative "pinnacle/campaigns/rcs/types/rcs_agent_website"
 require_relative "pinnacle/campaigns/rcs/types/rcs_agent"
 require_relative "pinnacle/campaigns/rcs/types/rcs_links"
-require_relative "pinnacle/campaigns/rcs/types/rcs_use_case"
 require_relative "pinnacle/campaigns/rcs/types/rcs_campaign_help_keywords"
 require_relative "pinnacle/campaigns/rcs/types/rcs_campaign_opt_in_keywords"
 require_relative "pinnacle/campaigns/rcs/types/rcs_campaign_opt_out_keywords"
@@ -229,7 +226,6 @@ require_relative "pinnacle/types/rcs_campaign_schema_extra_agent_phones_item"
 require_relative "pinnacle/types/rcs_campaign_schema_extra_agent_websites_item"
 require_relative "pinnacle/types/rcs_campaign_schema_extra_agent"
 require_relative "pinnacle/types/rcs_campaign_schema_extra_links"
-require_relative "pinnacle/types/rcs_campaign_schema_extra_use_case"
 require_relative "pinnacle/types/rcs_campaign_schema_extra_keywords_help"
 require_relative "pinnacle/types/rcs_campaign_schema_extra_keywords_opt_in"
 require_relative "pinnacle/types/rcs_campaign_schema_extra_keywords_opt_out"
@@ -306,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"
@@ -337,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"
@@ -344,13 +355,6 @@ require_relative "pinnacle/types/phone_number_region"
 require_relative "pinnacle/types/phone_number_details"
 require_relative "pinnacle/types/buy_response_capabilities"
 require_relative "pinnacle/types/purchased_number"
-require_relative "pinnacle/types/webhook_event_enum"
-require_relative "pinnacle/types/attach_webhook_by_id_params"
-require_relative "pinnacle/types/create_and_attach_webhook_by_url_params"
-require_relative "pinnacle/types/attach_webhook_params"
-require_relative "pinnacle/types/attach_webhook_response_webhook"
-require_relative "pinnacle/types/configured_webhook"
-require_relative "pinnacle/types/detached_webhook_info"
 require_relative "pinnacle/types/messaging_profile_enum"
 require_relative "pinnacle/types/phone_number_campaign_attach_phone_numbers_item_campaign"
 require_relative "pinnacle/types/phone_number_campaign_attach_phone_numbers_item"
@@ -434,6 +438,11 @@ require_relative "pinnacle/types/webhook_result"
 require_relative "pinnacle/types/webhook_summary_status"
 require_relative "pinnacle/types/webhook_summary"
 require_relative "pinnacle/types/list_webhooks_response"
+require_relative "pinnacle/types/webhook_event_enum"
+require_relative "pinnacle/types/failed_sender"
+require_relative "pinnacle/types/attach_webhook_response_webhook"
+require_relative "pinnacle/types/attach_webhook_result"
+require_relative "pinnacle/types/detach_webhook_result"
 require_relative "pinnacle/types/message_event_sms_content"
 require_relative "pinnacle/types/message_event_mms_content"
 require_relative "pinnacle/types/message_event_rcs_text_content"
@@ -490,6 +499,8 @@ require_relative "pinnacle/rcs/types/rcs_link_request"
 require_relative "pinnacle/webhooks/client"
 require_relative "pinnacle/webhooks/types/get_webhook_params"
 require_relative "pinnacle/webhooks/types/list_webhooks_params"
+require_relative "pinnacle/webhooks/types/attach_webhook_params"
+require_relative "pinnacle/webhooks/types/detach_webhook_params"
 require_relative "pinnacle/audiences/contacts/client"
 require_relative "pinnacle/audiences/contacts/types/remove_contacts_params"
 require_relative "pinnacle/audiences/contacts/types/add_contacts_params"
@@ -518,7 +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/phone_numbers/webhook/client"
+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"