rcs 2.0.4 → 2.0.5.pre.rc.1

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

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Rcs
+      class Client
+        # @param client [Pinnacle::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Send a RCS message immediately or schedule it for future delivery. <br>
+        #
+        # Requires an active RCS agent and recipient devices that support RCS Business Messaging.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Types::RichMessage]
+        # @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::Messages::Rcs::Types::SendRichMessageResponse]
+        def send_(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/send/rcs",
+            body: Pinnacle::Types::RichMessage.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::Messages::Rcs::Types::SendRichMessageResponse.load(response.body)
+          else
+            error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Send a typing indicator from an RCS agent to a recipient.
+        #
+        # This endpoint allows RCS agents to display a typing indicator to recipients. The indicator is a message bubble
+        # with animated typing dots like this: <img
+        # src="https://server.trypinnacle.app/storage/v1/object/public/pinnacle-public-assets/ios-typing-indicator.png"
+        # alt="Typing Indicator" style="display: inline; height: 1.5em; vertical-align: middle; margin: 0 4px;" />
+        #
+        # **Use Case:** Typing indicators are especially useful for providing feedback to users while the agent is
+        # thinking or generating a response that may take some time, creating a more engaging conversational experience.
+        #
+        # **Expiration:** Typing indicators automatically expire after around 20 seconds or when the agent sends a
+        # message, whichever comes first.
+        #
+        # **Frequency:** You can send typing indicators as many times as needed, though only one will be displayed at a
+        # time. Sending multiple typing indicators will extend the duration of the current indicator.
+        #
+        # > **Note:** Typing indicators are best-effort hints, not delivery-guaranteed state. The platform is allowed to
+        # coalesce or drop them, and the client UI decides when to show/hide.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Messages::Rcs::Types::SendTypingIndicatorSchema]
+        # @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::SendTypingIndicatorResponse]
+        def send_typing(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          body_prop_names = %i[agent_id to options]
+          body_bag = params.slice(*body_prop_names)
+
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "messages/send/typing",
+            body: Pinnacle::Messages::Rcs::Types::SendTypingIndicatorSchema.new(body_bag).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::SendTypingIndicatorResponse.load(response.body)
+          else
+            error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Validate RCS message content without sending it.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Types::RcsValidateContent]
+        # @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::RcsValidationResult]
+        def validate(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/validate/rcs",
+            body: Pinnacle::Types::RcsValidateContent.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::RcsValidationResult.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/messages/rcs/types/send_rich_message_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Rcs
+      module Types
+        class SendRichMessageResponse < Internal::Types::Model
+          extend Pinnacle::Internal::Types::Union
+
+          member -> { Pinnacle::Types::SentRichMessage }
+          member -> { Pinnacle::Types::ScheduledMessage }
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/messages/rcs/types/send_typing_indicator_schema.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Rcs
+      module Types
+        class SendTypingIndicatorSchema < Internal::Types::Model
+          field :agent_id, -> { String }, optional: false, nullable: false, api_name: "agentId"
+          field :to, -> { String }, optional: false, nullable: false
+          field :options, -> { Pinnacle::Messages::Rcs::Types::SendTypingIndicatorSchemaOptions }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/messages/rcs/types/send_typing_indicator_schema_options.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Rcs
+      module Types
+        # Configure how your typing indicator is sent.
+        class SendTypingIndicatorSchemaOptions < Internal::Types::Model
+          field :test_mode, -> { Internal::Types::Boolean }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Schedule
+      class Client
+        # @param client [Pinnacle::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Cancel a scheduled message or blast. <br>
+        #
+        # Works for both individual scheduled messages and scheduled blasts. Use the `scheduleId` returned when the
+        # message or blast was scheduled.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @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
+        # @option params [String] :id
+        #
+        # @return [Pinnacle::Types::ScheduleCancelResult]
+        def cancel(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "DELETE",
+            path: "messages/schedule/#{params[:id]}",
+            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::ScheduleCancelResult.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/messages/sms/client.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Sms
+      class Client
+        # @param client [Pinnacle::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Send a SMS message immediately or schedule it for future delivery.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Messages::Sms::Types::Sms]
+        # @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::Messages::Sms::Types::SmsSendResponse]
+        def send_(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          body_prop_names = %i[from options text to]
+          body_bag = params.slice(*body_prop_names)
+
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "messages/send/sms",
+            body: Pinnacle::Messages::Sms::Types::Sms.new(body_bag).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::Messages::Sms::Types::SmsSendResponse.load(response.body)
+          else
+            error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Validate SMS message content without sending it.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Types::SmsContent]
+        # @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::SmsValidationResult]
+        def validate(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/validate/sms",
+            body: Pinnacle::Types::SmsContent.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::SmsValidationResult.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/messages/sms/types/send_sms_options.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Sms
+      module Types
+        # Additional settings to customize SMS delivery.
+        class SendSmsOptions < Internal::Types::Model
+          field :schedule, -> { Pinnacle::Types::MessageSchedule }, optional: true, nullable: false
+          field :tracking, -> { Pinnacle::Types::Tracking }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/messages/sms/types/sms.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Sms
+      module Types
+        class Sms < Internal::Types::Model
+          field :from, -> { String }, optional: false, nullable: false
+          field :options, -> { Pinnacle::Messages::Sms::Types::SendSmsOptions }, optional: true, nullable: false
+          field :text, -> { String }, optional: false, nullable: false
+          field :to, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/messages/sms/types/sms_send_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Sms
+      module Types
+        class SmsSendResponse < Internal::Types::Model
+          extend Pinnacle::Internal::Types::Union
+
+          member -> { Pinnacle::Types::SentSmsDetails }
+          member -> { Pinnacle::Types::ScheduledMessage }
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/messages/types/react_message_options.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Types
+      class ReactMessageOptions < Internal::Types::Model
+        field :force, -> { Internal::Types::Boolean }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/pinnacle/messages/types/react_message_params.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Messages
+    module Types
+      class ReactMessageParams < Internal::Types::Model
+        field :message_id, -> { String }, optional: false, nullable: false, api_name: "messageId"
+        field :options, -> { Pinnacle::Messages::Types::ReactMessageOptions }, optional: true, nullable: false
+        field :reaction, -> { String }, optional: false, nullable: true
+      end
+    end
+  end
+end

data/lib/pinnacle/phone_numbers/campaign/client.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module PhoneNumbers
+    module Campaign
+      class Client
+        # @param client [Pinnacle::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Link a phone number to a specific campaign. Phone numbers must be linked to a campaign to send messages.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::PhoneNumbers::Campaign::Types::AttachCampaignParams]
+        # @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::AttachedPhoneNumberResult]
+        def attach(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          body_prop_names = %i[phones campaign_type campaign_id]
+          body_bag = params.slice(*body_prop_names)
+
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "phone-numbers/attach-campaign",
+            body: Pinnacle::PhoneNumbers::Campaign::Types::AttachCampaignParams.new(body_bag).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::AttachedPhoneNumberResult.load(response.body)
+          else
+            error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Remove the association between a phone number and its attached campaign.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::PhoneNumbers::Campaign::Types::DetachCampaignParams]
+        # @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::DetachedPhoneNumberResult]
+        def detach(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          body_prop_names = %i[phones]
+          body_bag = params.slice(*body_prop_names)
+
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "DELETE",
+            path: "phone-numbers/detach-campaign",
+            body: Pinnacle::PhoneNumbers::Campaign::Types::DetachCampaignParams.new(body_bag).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::DetachedPhoneNumberResult.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/phone_numbers/campaign/types/attach_campaign_params.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module PhoneNumbers
+    module Campaign
+      module Types
+        class AttachCampaignParams < Internal::Types::Model
+          field :phones, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+          field :campaign_type, -> { Pinnacle::Types::MessagingProfileEnum }, optional: false, nullable: false, api_name: "campaignType"
+          field :campaign_id, -> { String }, optional: false, nullable: false, api_name: "campaignId"
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/phone_numbers/campaign/types/detach_campaign_params.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module PhoneNumbers
+    module Campaign
+      module Types
+        class DetachCampaignParams < Internal::Types::Model
+          field :phones, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/phone_numbers/client.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module PhoneNumbers
+    class Client
+      # @param client [Pinnacle::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Search for available phone numbers that match your exact criteria.
+      #
+      # @param request_options [Hash]
+      # @param params [Pinnacle::PhoneNumbers::Types::SearchPhoneNumberParams]
+      # @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 [Array[Pinnacle::Types::PhoneNumberDetails]]
+      def search(request_options: {}, **params)
+        params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+        body_prop_names = %i[features location number options type]
+        body_bag = params.slice(*body_prop_names)
+
+        request = Pinnacle::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "phone-numbers/search",
+          body: Pinnacle::PhoneNumbers::Types::SearchPhoneNumberParams.new(body_bag).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Pinnacle::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # Purchase one or more phone numbers found through the [search endpoint](./search). <br>
+      #
+      # Billing uses your account credits and the numbers are ready for immediate use.
+      #
+      # @param request_options [Hash]
+      # @param params [Pinnacle::PhoneNumbers::Types::BuyPhoneNumberParams]
+      # @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 [Array[Pinnacle::Types::PurchasedNumber]]
+      def buy(request_options: {}, **params)
+        params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+        body_prop_names = %i[numbers]
+        body_bag = params.slice(*body_prop_names)
+
+        request = Pinnacle::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "phone-numbers/buy",
+          body: Pinnacle::PhoneNumbers::Types::BuyPhoneNumberParams.new(body_bag).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Pinnacle::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # Retrieve information about any phone number.
+      #
+      # @param request_options [Hash]
+      # @param params [Pinnacle::PhoneNumbers::Types::RetrievePhoneNumberDetailsParams]
+      # @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::PhoneNumbers::Types::PhoneNumbersGetResponse]
+      def get(request_options: {}, **params)
+        params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+        body_prop_names = %i[phone level options]
+        body_bag = params.slice(*body_prop_names)
+
+        request = Pinnacle::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "phone-numbers/details",
+          body: Pinnacle::PhoneNumbers::Types::RetrievePhoneNumberDetailsParams.new(body_bag).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::PhoneNumbers::Types::PhoneNumbersGetResponse.load(response.body)
+        else
+          error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @return [Pinnacle::Webhook::Client]
+      def webhook
+        @webhook ||= Pinnacle::PhoneNumbers::Webhook::Client.new(client: @client)
+      end
+
+      # @return [Pinnacle::Campaign::Client]
+      def campaign
+        @campaign ||= Pinnacle::PhoneNumbers::Campaign::Client.new(client: @client)
+      end
+    end
+  end
+end

data/lib/pinnacle/phone_numbers/types/buy_phone_number_params.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module PhoneNumbers
+    module Types
+      class BuyPhoneNumberParams < Internal::Types::Model
+        field :numbers, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+      end
+    end
+  end
+end