rcs 2.0.5 → 2.0.8

data/lib/pinnacle/tools/client.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    class Client
+      # @param client [Pinnacle::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # @return [Pinnacle::Url::Client]
+      def url
+        @url ||= Pinnacle::Tools::Url::Client.new(client: @client)
+      end
+
+      # @return [Pinnacle::File::Client]
+      def file
+        @file ||= Pinnacle::Tools::File::Client.new(client: @client)
+      end
+
+      # @return [Pinnacle::ContactCard::Client]
+      def contact_card
+        @contact_card ||= Pinnacle::Tools::ContactCard::Client.new(client: @client)
+      end
+    end
+  end
+end

data/lib/pinnacle/tools/contact_card/client.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module ContactCard
+      class Client
+        # @param client [Pinnacle::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Retrieve contact information as a vCard and get a presigned URL to download the file. Contact cards can be
+        # sent [via MMS](/api-reference/messages/send-mms) as a media file.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Tools::ContactCard::Types::GetVcardParams]
+        # @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::VCardData]
+        def get(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          body_prop_names = %i[id options]
+          body_bag = params.slice(*body_prop_names)
+
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "tools/contact-card",
+            body: Pinnacle::Tools::ContactCard::Types::GetVcardParams.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::VCardData.load(response.body)
+          else
+            error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Create a new contact card or updates an existing one with full vCard data. Contact cards can be sent [via
+        # MMS](/api-reference/messages/send-mms) as a media file.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Tools::ContactCard::Types::UpsertVcardParams]
+        # @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::VcardResource]
+        def upsert(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          body_prop_names = %i[photo id formatted_name name nickname birthday addresses url phones emails timezone geo title role organization categories note]
+          body_bag = params.slice(*body_prop_names)
+
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "tools/contact-card/upsert",
+            body: Pinnacle::Tools::ContactCard::Types::UpsertVcardParams.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::VcardResource.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/tools/contact_card/types/get_v_card_schema_options.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module ContactCard
+      module Types
+        class GetVCardSchemaOptions < Internal::Types::Model
+          field :expires_at, -> { String }, optional: true, nullable: false, api_name: "expiresAt"
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/tools/contact_card/types/get_vcard_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module ContactCard
+      module Types
+        class GetVcardParams < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+          field :options, -> { Pinnacle::Tools::ContactCard::Types::GetVCardSchemaOptions }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/tools/contact_card/types/upsert_vcard_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module ContactCard
+      module Types
+        class UpsertVcardParams < Internal::Types::Model
+          field :photo, -> { String }, optional: true, nullable: false
+          field :id, -> { String }, optional: true, nullable: false
+          field :formatted_name, -> { String }, optional: true, nullable: false, api_name: "formattedName"
+          field :name, -> { Pinnacle::Types::VCardName }, optional: true, nullable: false
+          field :nickname, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+          field :birthday, -> { String }, optional: true, nullable: false
+          field :addresses, -> { Internal::Types::Array[Pinnacle::Types::VcardAddress] }, optional: true, nullable: false
+          field :url, -> { String }, optional: true, nullable: false
+          field :phones, -> { Internal::Types::Array[Pinnacle::Types::VcardPhone] }, optional: true, nullable: false
+          field :emails, -> { Internal::Types::Array[Pinnacle::Types::VcardEmail] }, optional: true, nullable: false
+          field :timezone, -> { String }, optional: true, nullable: false
+          field :geo, -> { Pinnacle::Types::VCardGeo }, optional: true, nullable: false
+          field :title, -> { String }, optional: true, nullable: false
+          field :role, -> { String }, optional: true, nullable: false
+          field :organization, -> { Pinnacle::Types::VCardOrganization }, optional: true, nullable: false
+          field :categories, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+          field :note, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/tools/file/client.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module File
+      class Client
+        # @param client [Pinnacle::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Generate presigned URLs that let you upload files directly to our storage and allow your users to download
+        # them securely.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Tools::File::Types::UploadFileParams]
+        # @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::UploadResults]
+        def upload(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          body_prop_names = %i[content_type size name options]
+          body_bag = params.slice(*body_prop_names)
+
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "tools/files/upload",
+            body: Pinnacle::Tools::File::Types::UploadFileParams.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::UploadResults.load(response.body)
+          else
+            error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Refresh expiring presigned URLs for Pinnacle-hosted files to extend their access time.
+        #
+        # <Callout type="info">
+        # This only works for presigned download URLs. At this moment, you cannot refresh a presigned upload URL,
+        # generate a new one instead.
+        # </Callout>
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Tools::File::Types::RefreshFileParams]
+        # @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::RefreshedFile]]
+        def refresh(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          body_prop_names = %i[urls]
+          body_bag = params.slice(*body_prop_names)
+
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "tools/files/refresh",
+            body: Pinnacle::Tools::File::Types::RefreshFileParams.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
+      end
+    end
+  end
+end

data/lib/pinnacle/tools/file/types/download_options.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module File
+      module Types
+        # Configure download settings for your uploaded file.
+        class DownloadOptions < Internal::Types::Model
+          field :expires_at, -> { String }, optional: true, nullable: false, api_name: "expiresAt"
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/tools/file/types/refresh_file_params.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module File
+      module Types
+        class RefreshFileParams < Internal::Types::Model
+          field :urls, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/tools/file/types/upload_file_options.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module File
+      module Types
+        # Additional configurations for your file.
+        class UploadFileOptions < Internal::Types::Model
+          field :delete_at, -> { String }, optional: true, nullable: false, api_name: "deleteAt"
+          field :download, -> { Pinnacle::Tools::File::Types::DownloadOptions }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/tools/file/types/upload_file_params.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module File
+      module Types
+        class UploadFileParams < Internal::Types::Model
+          field :content_type, -> { String }, optional: false, nullable: false, api_name: "contentType"
+          field :size, -> { Integer }, optional: false, nullable: false
+          field :name, -> { String }, optional: true, nullable: false
+          field :options, -> { Pinnacle::Tools::File::Types::UploadFileOptions }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/tools/url/client.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module Url
+      class Client
+        # @param client [Pinnacle::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Create a shortened URL that redirects visitors to the provided destination URL.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Tools::Url::Types::CreateUrlParams]
+        # @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::ShortenedUrl]
+        def create(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          body_prop_names = %i[url options]
+          body_bag = params.slice(*body_prop_names)
+
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "tools/url",
+            body: Pinnacle::Tools::Url::Types::CreateUrlParams.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::ShortenedUrl.load(response.body)
+          else
+            error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Retrieve configuration and details for your shortened URL using its unique identifier.
+        #
+        # @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] :link_id
+        #
+        # @return [Pinnacle::Types::ShortenedUrlWithClickData]
+        def get(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "GET",
+            path: "tools/url/#{params[:link_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::ShortenedUrlWithClickData.load(response.body)
+          else
+            error_class = Pinnacle::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Update the destination or expiration date of an existing shortened URL. Expiring links cannot be updated into
+        # a permalink.
+        #
+        # @param request_options [Hash]
+        # @param params [Pinnacle::Tools::Url::Types::UpdateUrlParams]
+        # @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] :link_id
+        #
+        # @return [Pinnacle::Types::ShortenedUrl]
+        def update(request_options: {}, **params)
+          params = Pinnacle::Internal::Types::Utils.normalize_keys(params)
+          path_param_names = %i[link_id]
+          body_params = params.except(*path_param_names)
+          body_prop_names = %i[url options]
+          body_bag = body_params.slice(*body_prop_names)
+
+          request = Pinnacle::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "PUT",
+            path: "tools/url/#{params[:link_id]}",
+            body: Pinnacle::Tools::Url::Types::UpdateUrlParams.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::ShortenedUrl.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/tools/url/types/create_url_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module Url
+      module Types
+        class CreateUrlParams < Internal::Types::Model
+          field :url, -> { String }, optional: false, nullable: false
+          field :options, -> { Pinnacle::Types::CreateUrlOptions }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/tools/url/types/update_url_params.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Tools
+    module Url
+      module Types
+        class UpdateUrlParams < Internal::Types::Model
+          field :link_id, -> { String }, optional: false, nullable: false, api_name: "linkId"
+          field :url, -> { String }, optional: true, nullable: false
+          field :options, -> { Pinnacle::Types::CreateUrlOptions }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/pinnacle/types/advanced_phone_information.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Detailed phone number analysis including validation status, classification with fraud risk,
+    # precise geographic data, carrier intelligence, and enhanced contact information.
+    # Provides comprehensive insights for risk assessment, compliance, and advanced usage scenarios.
+    class AdvancedPhoneInformation < Internal::Types::Model
+      field :is_valid, -> { Internal::Types::Boolean }, optional: false, nullable: false, api_name: "isValid"
+      field :type, -> { Pinnacle::Types::AdvancedPhoneInformationType }, optional: false, nullable: false
+      field :formats, -> { Pinnacle::Types::NumberFormat }, optional: false, nullable: false
+      field :location, -> { Pinnacle::Types::AdvancedPhoneInformationLocation }, optional: false, nullable: false
+      field :carrier, -> { Pinnacle::Types::AdvancedPhoneInformationCarrier }, optional: false, nullable: false
+      field :contact, -> { Pinnacle::Types::AdvancedPhoneInformationContact }, optional: false, nullable: true
+    end
+  end
+end

data/lib/pinnacle/types/advanced_phone_information_carrier.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Detailed carrier information.
+    class AdvancedPhoneInformationCarrier < Internal::Types::Model
+      field :name, -> { String }, optional: false, nullable: false
+      field :normalized_carrier, -> { String }, optional: false, nullable: false, api_name: "normalizedCarrier"
+      field :mcc, -> { String }, optional: false, nullable: false
+      field :mnc, -> { String }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/advanced_phone_information_contact.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Enhanced contact information associated with the phone number.
+    class AdvancedPhoneInformationContact < Internal::Types::Model
+      field :first_name, -> { String }, optional: true, nullable: false, api_name: "firstName"
+      field :last_name, -> { String }, optional: true, nullable: false, api_name: "lastName"
+      field :email_address, -> { String }, optional: true, nullable: false, api_name: "emailAddress"
+      field :street, -> { String }, optional: true, nullable: false
+      field :unit, -> { String }, optional: true, nullable: false
+      field :place, -> { String }, optional: true, nullable: false
+      field :zip, -> { String }, optional: true, nullable: false
+      field :state, -> { String }, optional: true, nullable: false
+      field :country, -> { String }, optional: true, nullable: false
+      field :profiles, -> { Internal::Types::Array[Pinnacle::Types::EnhancedContactItem] }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/advanced_phone_information_location.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Comprehensive geographic and administrative location data with precise coordinates
+    # and timezone information for accurate localization.
+    class AdvancedPhoneInformationLocation < Internal::Types::Model
+      field :country, -> { Pinnacle::Types::AdvancedPhoneInformationLocationCountry }, optional: false, nullable: false
+      field :city, -> { String }, optional: false, nullable: true
+      field :state, -> { String }, optional: false, nullable: true
+      field :zip, -> { String }, optional: false, nullable: true
+      field :metro_code, -> { String }, optional: false, nullable: true, api_name: "metroCode"
+      field :county, -> { String }, optional: false, nullable: true
+      field :coordinates, -> { Pinnacle::Types::AdvancedPhoneInformationLocationCoordinates }, optional: false, nullable: false
+      field :time_zone, -> { String }, optional: false, nullable: true, api_name: "timeZone"
+    end
+  end
+end

data/lib/pinnacle/types/advanced_phone_information_location_coordinates.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Coordinates provide the precise latitude and longitude values for the phone number’s registered location.
+    class AdvancedPhoneInformationLocationCoordinates < Internal::Types::Model
+      field :latitude, -> { Integer }, optional: false, nullable: true
+      field :longitude, -> { Integer }, optional: false, nullable: true
+    end
+  end
+end

data/lib/pinnacle/types/advanced_phone_information_location_country.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Complete country identification and metadata.
+    class AdvancedPhoneInformationLocationCountry < Internal::Types::Model
+      field :name, -> { String }, optional: false, nullable: false
+      field :code, -> { String }, optional: false, nullable: false
+      field :code_3, -> { String }, optional: false, nullable: false, api_name: "code3"
+    end
+  end
+end

data/lib/pinnacle/types/advanced_phone_information_type.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Detailed classification including fraud risk and security recommendations.
+    class AdvancedPhoneInformationType < Internal::Types::Model
+      field :value, -> { Pinnacle::Types::DetailedPhoneNumberEnum }, optional: false, nullable: false
+      field :description, -> { String }, optional: false, nullable: false
+      field :details, -> { String }, optional: false, nullable: false
+      field :recommendation, -> { Pinnacle::Types::AdvancedPhoneInformationTypeRecommendation }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/advanced_phone_information_type_recommendation.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    module AdvancedPhoneInformationTypeRecommendation
+      extend Pinnacle::Internal::Types::Enum
+
+      ALLOW = "ALLOW"
+      BLOCK = "BLOCK"
+      FLAG = "FLAG"
+    end
+  end
+end

data/lib/pinnacle/types/agent.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Information about an RCS agent sender in a conversation.
+    class Agent < Internal::Types::Model
+      field :agent_id, -> { String }, optional: false, nullable: false, api_name: "agentId"
+      field :agent_name, -> { String }, optional: false, nullable: false, api_name: "agentName"
+    end
+  end
+end

data/lib/pinnacle/types/attach_webhook_by_id_params.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Attach a webhook you've already created in your account to this phone number.
+    class AttachWebhookByIdParams < Internal::Types::Model
+      field :webhook_id, -> { String }, optional: false, nullable: false, api_name: "webhookId"
+      field :event, -> { Pinnacle::Types::WebhookEventEnum }, optional: false, nullable: true
+    end
+  end
+end