rcs 1.0.17 → 2.0.0.pre.rc.1

data/lib/rcs/campaigns/toll_free/types/upsert_toll_free_schema_use_case.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require_relative "../../../types/toll_free_campaign_use_case_enum"
+require "ostruct"
+require "json"
+
+module Pinnacle
+  module Campaigns
+    module TollFree
+      module Types
+        # Use case classification for the campaign.
+        class UpsertTollFreeSchemaUseCase
+          # @return [String] Summary of the use case.
+          attr_reader :summary
+          # @return [Pinnacle::Types::TollFreeCampaignUseCaseEnum]
+          attr_reader :value
+          # @return [OpenStruct] Additional properties unmapped to the current class definition
+          attr_reader :additional_properties
+          # @return [Object]
+          attr_reader :_field_set
+          protected :_field_set
+
+          OMIT = Object.new
+
+          # @param summary [String] Summary of the use case.
+          # @param value [Pinnacle::Types::TollFreeCampaignUseCaseEnum]
+          # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+          # @return [Pinnacle::Campaigns::TollFree::Types::UpsertTollFreeSchemaUseCase]
+          def initialize(summary: OMIT, value: OMIT, additional_properties: nil)
+            @summary = summary if summary != OMIT
+            @value = value if value != OMIT
+            @additional_properties = additional_properties
+            @_field_set = { "summary": summary, "value": value }.reject do |_k, v|
+              v == OMIT
+            end
+          end
+
+          # Deserialize a JSON object to an instance of UpsertTollFreeSchemaUseCase
+          #
+          # @param json_object [String]
+          # @return [Pinnacle::Campaigns::TollFree::Types::UpsertTollFreeSchemaUseCase]
+          def self.from_json(json_object:)
+            struct = JSON.parse(json_object, object_class: OpenStruct)
+            parsed_json = JSON.parse(json_object)
+            summary = parsed_json["summary"]
+            value = parsed_json["value"]
+            new(
+              summary: summary,
+              value: value,
+              additional_properties: struct
+            )
+          end
+
+          # Serialize an instance of UpsertTollFreeSchemaUseCase to a JSON object
+          #
+          # @return [String]
+          def to_json(*_args)
+            @_field_set&.to_json
+          end
+
+          # Leveraged for Union-type generation, validate_raw attempts to parse the given
+          #  hash and check each fields type against the current object's property
+          #  definitions.
+          #
+          # @param obj [Object]
+          # @return [Void]
+          def self.validate_raw(obj:)
+            obj.summary&.is_a?(String) != false || raise("Passed value for field obj.summary is not the expected type, validation failed.")
+            obj.value&.is_a?(Pinnacle::Types::TollFreeCampaignUseCaseEnum) != false || raise("Passed value for field obj.value is not the expected type, validation failed.")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rcs/contacts/client.rb

@@ -0,0 +1,275 @@
+# frozen_string_literal: true
+
+require_relative "../../requests"
+require_relative "../types/contact"
+require_relative "../types/contact_id"
+require_relative "../types/updated_contact_id"
+require "async"
+
+module Pinnacle
+  class ContactsClient
+    # @return [Pinnacle::RequestClient]
+    attr_reader :request_client
+
+    # @param request_client [Pinnacle::RequestClient]
+    # @return [Pinnacle::ContactsClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+
+    # Retrieve contact information for a given number.
+    #
+    # @param id [Integer] Unique identifier of a specific contact you want to retrieve. <br>
+    #  Either this parameter or `phoneNumber` must be provided, but not both.
+    # @param phone_number [String] Phone number you want to look up contact information for, provided in
+    #  URL-encoded E.164 format with %2B prefix instead of +.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::Contact]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.contacts.get
+    def get(id: nil, phone_number: nil, request_options: nil)
+      response = @request_client.conn.get do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        req.params = {
+          **(request_options&.additional_query_parameters || {}),
+          "id": id,
+          "phoneNumber": phone_number
+        }.compact
+        unless request_options.nil? || request_options&.additional_body_parameters.nil?
+          req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+        end
+        req.url "#{@request_client.get_url(request_options: request_options)}/contacts"
+      end
+      Pinnacle::Types::Contact.from_json(json_object: response.body)
+    end
+
+    # Create a new contact for a given phone number.
+    #
+    # @param description [String] New notes or details for your contact.
+    # @param email [String] New email address for your contact.
+    # @param name [String] New name for your contact.
+    # @param tags [Array<String>] New tags for your contact.
+    # @param phone_number [String] Phone number to save for your contact, in E.164 format.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::ContactId]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.contacts.create(phone_number: "phoneNumber")
+    def create(phone_number:, description: nil, email: nil, name: nil, tags: nil, request_options: nil)
+      response = @request_client.conn.post do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        req.body = {
+          **(request_options&.additional_body_parameters || {}),
+          description: description,
+          email: email,
+          name: name,
+          tags: tags,
+          phoneNumber: phone_number
+        }.compact
+        req.url "#{@request_client.get_url(request_options: request_options)}/contacts"
+      end
+      Pinnacle::Types::ContactId.from_json(json_object: response.body)
+    end
+
+    # Update an existing contact.
+    #
+    # @param description [String] New notes or details for your contact.
+    # @param email [String] New email address for your contact.
+    # @param name [String] New name for your contact.
+    # @param tags [Array<String>] New tags for your contact.
+    # @param id [Integer] ID of the contact you want to update.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::UpdatedContactId]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.contacts.update(id: 137)
+    def update(id:, description: nil, email: nil, name: nil, tags: nil, request_options: nil)
+      response = @request_client.conn.put do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        req.body = {
+          **(request_options&.additional_body_parameters || {}),
+          description: description,
+          email: email,
+          name: name,
+          tags: tags,
+          id: id
+        }.compact
+        req.url "#{@request_client.get_url(request_options: request_options)}/contacts"
+      end
+      Pinnacle::Types::UpdatedContactId.from_json(json_object: response.body)
+    end
+  end
+
+  class AsyncContactsClient
+    # @return [Pinnacle::AsyncRequestClient]
+    attr_reader :request_client
+
+    # @param request_client [Pinnacle::AsyncRequestClient]
+    # @return [Pinnacle::AsyncContactsClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+
+    # Retrieve contact information for a given number.
+    #
+    # @param id [Integer] Unique identifier of a specific contact you want to retrieve. <br>
+    #  Either this parameter or `phoneNumber` must be provided, but not both.
+    # @param phone_number [String] Phone number you want to look up contact information for, provided in
+    #  URL-encoded E.164 format with %2B prefix instead of +.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::Contact]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.contacts.get
+    def get(id: nil, phone_number: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "id": id,
+            "phoneNumber": phone_number
+          }.compact
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/contacts"
+        end
+        Pinnacle::Types::Contact.from_json(json_object: response.body)
+      end
+    end
+
+    # Create a new contact for a given phone number.
+    #
+    # @param description [String] New notes or details for your contact.
+    # @param email [String] New email address for your contact.
+    # @param name [String] New name for your contact.
+    # @param tags [Array<String>] New tags for your contact.
+    # @param phone_number [String] Phone number to save for your contact, in E.164 format.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::ContactId]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.contacts.create(phone_number: "phoneNumber")
+    def create(phone_number:, description: nil, email: nil, name: nil, tags: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.post do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = {
+            **(request_options&.additional_body_parameters || {}),
+            description: description,
+            email: email,
+            name: name,
+            tags: tags,
+            phoneNumber: phone_number
+          }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/contacts"
+        end
+        Pinnacle::Types::ContactId.from_json(json_object: response.body)
+      end
+    end
+
+    # Update an existing contact.
+    #
+    # @param description [String] New notes or details for your contact.
+    # @param email [String] New email address for your contact.
+    # @param name [String] New name for your contact.
+    # @param tags [Array<String>] New tags for your contact.
+    # @param id [Integer] ID of the contact you want to update.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::UpdatedContactId]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.contacts.update(id: 137)
+    def update(id:, description: nil, email: nil, name: nil, tags: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.put do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = {
+            **(request_options&.additional_body_parameters || {}),
+            description: description,
+            email: email,
+            name: name,
+            tags: tags,
+            id: id
+          }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/contacts"
+        end
+        Pinnacle::Types::UpdatedContactId.from_json(json_object: response.body)
+      end
+    end
+  end
+end

data/lib/rcs/conversations/client.rb

@@ -0,0 +1,273 @@
+# frozen_string_literal: true
+
+require_relative "../../requests"
+require_relative "../types/get_conversation_params"
+require_relative "../types/conversation"
+require_relative "../types/campaign_enum"
+require_relative "../types/conversation_list"
+require_relative "../types/successful_conversation_update"
+require "async"
+
+module Pinnacle
+  class ConversationsClient
+    # @return [Pinnacle::RequestClient]
+    attr_reader :request_client
+
+    # @param request_client [Pinnacle::RequestClient]
+    # @return [Pinnacle::ConversationsClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+
+    # Fetch a specific conversation using either its unique identifier or by matching
+    #  sender and recipient details.
+    #
+    # @param request [Pinnacle::Types::GetConversationRequestId, Pinnacle::Types::GetConversationRequestRecipient]
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::Conversation]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.conversations.get(request: { id: 1 })
+    def get(request:, request_options: nil)
+      response = @request_client.conn.post do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+        req.url "#{@request_client.get_url(request_options: request_options)}/conversations/get"
+      end
+      Pinnacle::Types::Conversation.from_json(json_object: response.body)
+    end
+
+    # Retrieves conversations by page with optional filtering based off provided
+    #  parameters.
+    #
+    # @param brand_id [Integer] The unique identifier of the brand to filter conversations.
+    # @param campaign_id [Integer] The unique identifier of the campaign to filter conversations.
+    # @param campaign_type [Pinnacle::Types::CampaignEnum]
+    # @param page_index [Integer] Zero-based index for pagination.
+    # @param page_size [Integer] Number of conversations to return per page.
+    # @param receiver [String] Receiver's phone number in E.164 format.
+    # @param sender [String]
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::ConversationList]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.conversations.list(
+    #    brand_id: 101,
+    #    campaign_id: 136,
+    #    campaign_type: TOLL_FREE,
+    #    page_index: 0,
+    #    page_size: 20,
+    #    receiver: "+16509231662",
+    #    sender: "+18445551234"
+    #  )
+    def list(page_index:, brand_id: nil, campaign_id: nil, campaign_type: nil, page_size: nil, receiver: nil,
+             sender: nil, request_options: nil)
+      response = @request_client.conn.post do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        req.body = {
+          **(request_options&.additional_body_parameters || {}),
+          brandId: brand_id,
+          campaignId: campaign_id,
+          campaignType: campaign_type,
+          pageIndex: page_index,
+          pageSize: page_size,
+          receiver: receiver,
+          sender: sender
+        }.compact
+        req.url "#{@request_client.get_url(request_options: request_options)}/conversations/list"
+      end
+      Pinnacle::Types::ConversationList.from_json(json_object: response.body)
+    end
+
+    # Update the notes associated with a specific conversation.
+    #
+    # @param id [Integer] The unique identifier of the conversation to update.
+    # @param notes [String] New notes or comments for the conversation.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::SuccessfulConversationUpdate]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.conversations.update(id: 123, notes: "Follow-up completed. Customer satisfied with resolution.")
+    def update(id:, notes:, request_options: nil)
+      response = @request_client.conn.post do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        req.body = { **(request_options&.additional_body_parameters || {}), id: id, notes: notes }.compact
+        req.url "#{@request_client.get_url(request_options: request_options)}/conversations/update"
+      end
+      Pinnacle::Types::SuccessfulConversationUpdate.from_json(json_object: response.body)
+    end
+  end
+
+  class AsyncConversationsClient
+    # @return [Pinnacle::AsyncRequestClient]
+    attr_reader :request_client
+
+    # @param request_client [Pinnacle::AsyncRequestClient]
+    # @return [Pinnacle::AsyncConversationsClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+
+    # Fetch a specific conversation using either its unique identifier or by matching
+    #  sender and recipient details.
+    #
+    # @param request [Pinnacle::Types::GetConversationRequestId, Pinnacle::Types::GetConversationRequestRecipient]
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::Conversation]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.conversations.get(request: { id: 1 })
+    def get(request:, request_options: nil)
+      Async do
+        response = @request_client.conn.post do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/conversations/get"
+        end
+        Pinnacle::Types::Conversation.from_json(json_object: response.body)
+      end
+    end
+
+    # Retrieves conversations by page with optional filtering based off provided
+    #  parameters.
+    #
+    # @param brand_id [Integer] The unique identifier of the brand to filter conversations.
+    # @param campaign_id [Integer] The unique identifier of the campaign to filter conversations.
+    # @param campaign_type [Pinnacle::Types::CampaignEnum]
+    # @param page_index [Integer] Zero-based index for pagination.
+    # @param page_size [Integer] Number of conversations to return per page.
+    # @param receiver [String] Receiver's phone number in E.164 format.
+    # @param sender [String]
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::ConversationList]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.conversations.list(
+    #    brand_id: 101,
+    #    campaign_id: 136,
+    #    campaign_type: TOLL_FREE,
+    #    page_index: 0,
+    #    page_size: 20,
+    #    receiver: "+16509231662",
+    #    sender: "+18445551234"
+    #  )
+    def list(page_index:, brand_id: nil, campaign_id: nil, campaign_type: nil, page_size: nil, receiver: nil,
+             sender: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.post do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = {
+            **(request_options&.additional_body_parameters || {}),
+            brandId: brand_id,
+            campaignId: campaign_id,
+            campaignType: campaign_type,
+            pageIndex: page_index,
+            pageSize: page_size,
+            receiver: receiver,
+            sender: sender
+          }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/conversations/list"
+        end
+        Pinnacle::Types::ConversationList.from_json(json_object: response.body)
+      end
+    end
+
+    # Update the notes associated with a specific conversation.
+    #
+    # @param id [Integer] The unique identifier of the conversation to update.
+    # @param notes [String] New notes or comments for the conversation.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::SuccessfulConversationUpdate]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.conversations.update(id: 123, notes: "Follow-up completed. Customer satisfied with resolution.")
+    def update(id:, notes:, request_options: nil)
+      Async do
+        response = @request_client.conn.post do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = { **(request_options&.additional_body_parameters || {}), id: id, notes: notes }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/conversations/update"
+        end
+        Pinnacle::Types::SuccessfulConversationUpdate.from_json(json_object: response.body)
+      end
+    end
+  end
+end

data/lib/rcs/message/client.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative "../../requests"
+require_relative "sms/client"
+
+module Pinnacle
+  module Message
+    class Client
+      # @return [Pinnacle::Message::SmsClient]
+      attr_reader :sms
+
+      # @param request_client [Pinnacle::RequestClient]
+      # @return [Pinnacle::Message::Client]
+      def initialize(request_client:)
+        @sms = Pinnacle::Message::SmsClient.new(request_client: request_client)
+      end
+    end
+
+    class AsyncClient
+      # @return [Pinnacle::Message::AsyncSmsClient]
+      attr_reader :sms
+
+      # @param request_client [Pinnacle::AsyncRequestClient]
+      # @return [Pinnacle::Message::AsyncClient]
+      def initialize(request_client:)
+        @sms = Pinnacle::Message::AsyncSmsClient.new(request_client: request_client)
+      end
+    end
+  end
+end