rcs 2.0.0.pre.rc.5 → 2.0.0

data/lib/rcs/campaigns/toll_free/client.rb

@@ -29,7 +29,7 @@ module Pinnacle
       #
       # @param request [Hash] Request of type Pinnacle::Types::AutofillCampaignParams, as a Hash
       #   * :additional_info (String)
-      #   * :campaign_id (Integer)
+      #   * :campaign_id (String)
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Campaigns::TollFree::Types::TollFreeAutofillResponse]
       # @example
@@ -38,7 +38,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.campaigns.toll_free.autofill(request: { additional_info: "Please autofill missing DLC campaign fields using my brand profile", campaign_id: 161 })
+      #  api.campaigns.toll_free.autofill(request: { additional_info: "Please autofill missing campaign fields using my brand profile", campaign_id: "dlc_1234567890" })
       def autofill(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?
@@ -59,7 +59,7 @@ module Pinnacle
 
       # Retrieve Toll-Free campaign.
       #
-      # @param campaign_id [Integer] Unique identifier of toll-free campaign.
+      # @param campaign_id [String] Unique identifier of toll-free campaign. Must begin with the prefix `tf_`.
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::TollFreeCampaignWithExtendedBrandAndStatus]
       # @example
@@ -68,7 +68,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.campaigns.toll_free.get(campaign_id: 161)
+      #  api.campaigns.toll_free.get(campaign_id: "tf_1234567890")
       def get(campaign_id:, 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?
@@ -91,7 +91,8 @@ module Pinnacle
 
       # Submit your toll-free campaign for approval and activation with carriers.
       #
-      # @param campaign_id [Integer] Unique identifier of the toll-free campaign to submit.
+      # @param campaign_id [String] Unique identifier of the toll-free campaign to submit. Must begin with the
+      #  prefix `tf_`.
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::CampaignSubmissionResult]
       # @example
@@ -100,7 +101,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.campaigns.toll_free.submit(campaign_id: 161)
+      #  api.campaigns.toll_free.submit(campaign_id: "tf_1234567890")
       def submit(campaign_id:, 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?
@@ -124,8 +125,10 @@ module Pinnacle
       # Create a new toll-free campaign or updates an existing one.<br>
       #  Omit campaignId to create a campaign.
       #
-      # @param brand [Integer] Brand id.
-      # @param campaign_id [Integer] Unique identifier for the campaign.
+      # @param brand [String] Brand id. This identifier is a string that always begins with the prefix `b_`,
+      #  for example: `b_1234567890`.
+      # @param campaign_id [String] Unique identifier for the campaign. This identifier is a string that always
+      #  begins with the prefix `tf_`, for example: `tf_1234567890`.
       # @param monthly_volume [Pinnacle::Types::MessageVolumeEnum]
       # @param name [String] Display name of the campaign.
       # @param opt_in [Hash] Opt-in keyword settings.Request of type Pinnacle::Campaigns::TollFree::Types::UpsertTollFreeSchemaOptIn, as a Hash
@@ -145,12 +148,12 @@ module Pinnacle
       #    api_key: "YOUR_API_KEY"
       #  )
       #  api.campaigns.toll_free.upsert(
-      #    brand: 2,
-      #    campaign_id: 161,
+      #    brand: "b_1234567890",
+      #    campaign_id: "tf_1234567890",
       #    monthly_volume: ONE_000,
       #    name: "Pinnacle",
       #    opt_in: { method_: DIGITAL, url: "https://www.pinnacle.sh/", workflow_description: "Visit https://www.pinnacle.sh/" },
-      #    production_message_content: "Join Pinnacle's workshop tomorrow and send your first RCS!",
+      #    production_message_content: "Join the Pinnacle workshop tomorrow and send your first RCS!",
       #    use_case: { summary: "Alerts clients about any Pinnacle hosted workshops.", value: WORKSHOP_ALERTS }
       #  )
       def upsert(brand: nil, campaign_id: nil, monthly_volume: nil, name: nil, opt_in: nil,
@@ -186,7 +189,7 @@ module Pinnacle
       #
       # @param request [Hash] Request of type Pinnacle::Types::ValidateCampaignParams, as a Hash
       #   * :additional_info (String)
-      #   * :campaign_id (Integer)
+      #   * :campaign_id (String)
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::CampaignValidationResult]
       # @example
@@ -195,7 +198,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.campaigns.toll_free.validate(request: { additional_info: "Please validate this DLC campaign for 10DLC compliance", campaign_id: 161 })
+      #  api.campaigns.toll_free.validate(request: { additional_info: "Please validate this DLC campaign for 10DLC compliance", campaign_id: "dlc_1234567890" })
       def validate(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?
@@ -230,7 +233,7 @@ module Pinnacle
       #
       # @param request [Hash] Request of type Pinnacle::Types::AutofillCampaignParams, as a Hash
       #   * :additional_info (String)
-      #   * :campaign_id (Integer)
+      #   * :campaign_id (String)
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Campaigns::TollFree::Types::TollFreeAutofillResponse]
       # @example
@@ -239,7 +242,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.campaigns.toll_free.autofill(request: { additional_info: "Please autofill missing DLC campaign fields using my brand profile", campaign_id: 161 })
+      #  api.campaigns.toll_free.autofill(request: { additional_info: "Please autofill missing campaign fields using my brand profile", campaign_id: "dlc_1234567890" })
       def autofill(request:, request_options: nil)
         Async do
           response = @request_client.conn.post do |req|
@@ -262,7 +265,7 @@ module Pinnacle
 
       # Retrieve Toll-Free campaign.
       #
-      # @param campaign_id [Integer] Unique identifier of toll-free campaign.
+      # @param campaign_id [String] Unique identifier of toll-free campaign. Must begin with the prefix `tf_`.
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::TollFreeCampaignWithExtendedBrandAndStatus]
       # @example
@@ -271,7 +274,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.campaigns.toll_free.get(campaign_id: 161)
+      #  api.campaigns.toll_free.get(campaign_id: "tf_1234567890")
       def get(campaign_id:, request_options: nil)
         Async do
           response = @request_client.conn.get do |req|
@@ -296,7 +299,8 @@ module Pinnacle
 
       # Submit your toll-free campaign for approval and activation with carriers.
       #
-      # @param campaign_id [Integer] Unique identifier of the toll-free campaign to submit.
+      # @param campaign_id [String] Unique identifier of the toll-free campaign to submit. Must begin with the
+      #  prefix `tf_`.
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::CampaignSubmissionResult]
       # @example
@@ -305,7 +309,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.campaigns.toll_free.submit(campaign_id: 161)
+      #  api.campaigns.toll_free.submit(campaign_id: "tf_1234567890")
       def submit(campaign_id:, request_options: nil)
         Async do
           response = @request_client.conn.post do |req|
@@ -331,8 +335,10 @@ module Pinnacle
       # Create a new toll-free campaign or updates an existing one.<br>
       #  Omit campaignId to create a campaign.
       #
-      # @param brand [Integer] Brand id.
-      # @param campaign_id [Integer] Unique identifier for the campaign.
+      # @param brand [String] Brand id. This identifier is a string that always begins with the prefix `b_`,
+      #  for example: `b_1234567890`.
+      # @param campaign_id [String] Unique identifier for the campaign. This identifier is a string that always
+      #  begins with the prefix `tf_`, for example: `tf_1234567890`.
       # @param monthly_volume [Pinnacle::Types::MessageVolumeEnum]
       # @param name [String] Display name of the campaign.
       # @param opt_in [Hash] Opt-in keyword settings.Request of type Pinnacle::Campaigns::TollFree::Types::UpsertTollFreeSchemaOptIn, as a Hash
@@ -352,12 +358,12 @@ module Pinnacle
       #    api_key: "YOUR_API_KEY"
       #  )
       #  api.campaigns.toll_free.upsert(
-      #    brand: 2,
-      #    campaign_id: 161,
+      #    brand: "b_1234567890",
+      #    campaign_id: "tf_1234567890",
       #    monthly_volume: ONE_000,
       #    name: "Pinnacle",
       #    opt_in: { method_: DIGITAL, url: "https://www.pinnacle.sh/", workflow_description: "Visit https://www.pinnacle.sh/" },
-      #    production_message_content: "Join Pinnacle's workshop tomorrow and send your first RCS!",
+      #    production_message_content: "Join the Pinnacle workshop tomorrow and send your first RCS!",
       #    use_case: { summary: "Alerts clients about any Pinnacle hosted workshops.", value: WORKSHOP_ALERTS }
       #  )
       def upsert(brand: nil, campaign_id: nil, monthly_volume: nil, name: nil, opt_in: nil,
@@ -395,7 +401,7 @@ module Pinnacle
       #
       # @param request [Hash] Request of type Pinnacle::Types::ValidateCampaignParams, as a Hash
       #   * :additional_info (String)
-      #   * :campaign_id (Integer)
+      #   * :campaign_id (String)
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::CampaignValidationResult]
       # @example
@@ -404,7 +410,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.campaigns.toll_free.validate(request: { additional_info: "Please validate this DLC campaign for 10DLC compliance", campaign_id: 161 })
+      #  api.campaigns.toll_free.validate(request: { additional_info: "Please validate this DLC campaign for 10DLC compliance", campaign_id: "dlc_1234567890" })
       def validate(request:, request_options: nil)
         Async do
           response = @request_client.conn.post do |req|

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

@@ -11,9 +11,9 @@ module Pinnacle
     module TollFree
       module Types
         class TollFreeAutofillResponse
-          # @return [Integer]
+          # @return [String]
           attr_reader :brand
-          # @return [Integer] Unique identifier for the campaign.
+          # @return [String] Unique identifier for the campaign. Must begin with the prefix `tf_`.
           attr_reader :campaign_id
           # @return [Pinnacle::Types::MessageVolumeEnum]
           attr_reader :monthly_volume
@@ -33,8 +33,8 @@ module Pinnacle
 
           OMIT = Object.new
 
-          # @param brand [Integer]
-          # @param campaign_id [Integer] Unique identifier for the campaign.
+          # @param brand [String]
+          # @param campaign_id [String] Unique identifier for the campaign. Must begin with the prefix `tf_`.
           # @param monthly_volume [Pinnacle::Types::MessageVolumeEnum]
           # @param name [String] Display name of the campaign.
           # @param opt_in [Pinnacle::Types::UpsertTollFreeCampaignOptIn] Opt-in keyword settings.
@@ -115,8 +115,8 @@ module Pinnacle
           # @param obj [Object]
           # @return [Void]
           def self.validate_raw(obj:)
-            obj.brand&.is_a?(Integer) != false || raise("Passed value for field obj.brand is not the expected type, validation failed.")
-            obj.campaign_id&.is_a?(Integer) != false || raise("Passed value for field obj.campaign_id is not the expected type, validation failed.")
+            obj.brand&.is_a?(String) != false || raise("Passed value for field obj.brand is not the expected type, validation failed.")
+            obj.campaign_id&.is_a?(String) != false || raise("Passed value for field obj.campaign_id is not the expected type, validation failed.")
             obj.monthly_volume&.is_a?(Pinnacle::Types::MessageVolumeEnum) != false || raise("Passed value for field obj.monthly_volume is not the expected type, validation failed.")
             obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
             obj.opt_in.nil? || Pinnacle::Types::UpsertTollFreeCampaignOptIn.validate_raw(obj: obj.opt_in)

data/lib/rcs/contacts/client.rb

@@ -19,7 +19,7 @@ module Pinnacle
 
     # Retrieve contact information for a given number.
     #
-    # @param id [Integer] Unique identifier of a specific contact you want to retrieve. <br>
+    # @param id [String] 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 +.
@@ -31,7 +31,7 @@ module Pinnacle
     #    environment: Pinnacle::Environment::DEFAULT,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.contacts.get
+    #  api.contacts.get(id: "co_1234567890")
     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?
@@ -101,7 +101,8 @@ module Pinnacle
     # @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 id [String] ID of the contact you want to update. This identifier is a string that always
+    #  begins with the prefix `co_`, for example: `co_1234567890`.
     # @param request_options [Pinnacle::RequestOptions]
     # @return [Pinnacle::Types::UpdatedContactId]
     # @example
@@ -110,7 +111,7 @@ module Pinnacle
     #    environment: Pinnacle::Environment::DEFAULT,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.contacts.update(id: 137)
+    #  api.contacts.update(id: "co_1234567890")
     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?
@@ -149,7 +150,7 @@ module Pinnacle
 
     # Retrieve contact information for a given number.
     #
-    # @param id [Integer] Unique identifier of a specific contact you want to retrieve. <br>
+    # @param id [String] 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 +.
@@ -161,7 +162,7 @@ module Pinnacle
     #    environment: Pinnacle::Environment::DEFAULT,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.contacts.get
+    #  api.contacts.get(id: "co_1234567890")
     def get(id: nil, phone_number: nil, request_options: nil)
       Async do
         response = @request_client.conn.get do |req|
@@ -235,7 +236,8 @@ module Pinnacle
     # @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 id [String] ID of the contact you want to update. This identifier is a string that always
+    #  begins with the prefix `co_`, for example: `co_1234567890`.
     # @param request_options [Pinnacle::RequestOptions]
     # @return [Pinnacle::Types::UpdatedContactId]
     # @example
@@ -244,7 +246,7 @@ module Pinnacle
     #    environment: Pinnacle::Environment::DEFAULT,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.contacts.update(id: 137)
+    #  api.contacts.update(id: "co_1234567890")
     def update(id:, description: nil, email: nil, name: nil, tags: nil, request_options: nil)
       Async do
         response = @request_client.conn.put do |req|

data/lib/rcs/conversations/client.rb

@@ -6,6 +6,12 @@ require_relative "../types/conversation"
 require_relative "../types/campaign_enum"
 require_relative "../types/conversation_list"
 require_relative "../types/successful_conversation_update"
+require_relative "types/conversations_list_messages_request_sort_order"
+require_relative "types/conversations_list_messages_request_direction"
+require_relative "types/conversations_list_messages_request_status"
+require_relative "types/conversations_list_messages_request_type"
+require "date"
+require_relative "../types/message_list"
 require "async"
 
 module Pinnacle
@@ -31,7 +37,7 @@ module Pinnacle
     #    environment: Pinnacle::Environment::DEFAULT,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.conversations.get(request: { id: 1 })
+    #  api.conversations.get(request: { id: "conv_1234567890" })
     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?
@@ -53,15 +59,20 @@ module Pinnacle
     # 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 brand_id [String] The unique identifier of the brand to filter conversations. This identifier is a
+    #  string that always begins with the prefix `b_`, for example: `b_1234567890`.
+    # @param campaign_id [String] The unique identifier of the campaign to filter conversations. This identifier
+    #  is a string that begins with the prefix:
+    #  - TOLL_FREE: `tf_` (e.g., `tf_1234567890`)
+    #  - 10DLC: `dlc_` (e.g., `dlc_1234567890`)
+    #  - RCS: `rcs_` (e.g., `rcs_1234567890`)
     # @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::ErrorResponse, Pinnacle::Types::RetrievedConversations]
+    # @return [Pinnacle::Types::ConversationList]
     # @example
     #  api = Pinnacle::Client.new(
     #    base_url: "https://api.example.com",
@@ -69,8 +80,8 @@ module Pinnacle
     #    api_key: "YOUR_API_KEY"
     #  )
     #  api.conversations.list(
-    #    brand_id: 101,
-    #    campaign_id: 136,
+    #    brand_id: "b_1234567890",
+    #    campaign_id: "tf_1234567890",
     #    campaign_type: TOLL_FREE,
     #    page_index: 0,
     #    page_size: 20,
@@ -107,7 +118,8 @@ module Pinnacle
 
     # Update the notes associated with a specific conversation.
     #
-    # @param id [Integer] The unique identifier of the conversation to update.
+    # @param id [String] The unique identifier of the conversation to update. This identifier is a string
+    #  that always begins with the prefix `conv_`, for example: `conv_1234567890`.
     # @param notes [String] New notes or comments for the conversation.
     # @param request_options [Pinnacle::RequestOptions]
     # @return [Pinnacle::Types::SuccessfulConversationUpdate]
@@ -117,7 +129,7 @@ module Pinnacle
     #    environment: Pinnacle::Environment::DEFAULT,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.conversations.update(id: 123, notes: "Follow-up completed. Customer satisfied with resolution.")
+    #  api.conversations.update(id: "conv_1234567890", 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?
@@ -135,6 +147,60 @@ module Pinnacle
       end
       Pinnacle::Types::SuccessfulConversationUpdate.from_json(json_object: response.body)
     end
+
+    # Retrieve a paginated and filtered list of messages for a specific conversation.
+    #
+    # @param id [String] Unique identifier of the conversation. This identifier is a string that always
+    #  begins with the prefix `conv_`, for example: `conv_1234567890`.
+    # @param page_index [Integer] Zero-based index for pagination.
+    # @param page_size [Integer] Number of messages to return per page.
+    # @param sort_order [Pinnacle::Conversations::Types::ConversationsListMessagesRequestSortOrder] Sort order for messages. <br>
+    #  - `asc`: Oldest messages first
+    #  - `desc`: Newest messages first (default)
+    # @param direction [Pinnacle::Conversations::Types::ConversationsListMessagesRequestDirection] Filter messages by direction. <br>
+    #  - `INBOUND`: Messages received from contacts
+    #  - `OUTBOUND`: Messages sent to contacts
+    # @param status [Pinnacle::Conversations::Types::ConversationsListMessagesRequestStatus] Filter messages by delivery status.
+    # @param type [Pinnacle::Conversations::Types::ConversationsListMessagesRequestType] Filter messages by protocol type.
+    # @param date_from [DateTime] Filter messages sent on or after this date (ISO 8601 format).
+    # @param date_to [DateTime] Filter messages sent on or before this date (ISO 8601 format).
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::MessageList]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.conversations.list_messages(id: "id")
+    def list_messages(id:, page_index: nil, page_size: nil, sort_order: nil, direction: nil, status: nil, type: nil,
+                      date_from: nil, date_to: 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
+        req.params = {
+          **(request_options&.additional_query_parameters || {}),
+          "pageIndex": page_index,
+          "pageSize": page_size,
+          "sortOrder": sort_order,
+          "direction": direction,
+          "status": status,
+          "type": type,
+          "dateFrom": date_from,
+          "dateTo": date_to
+        }.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)}/conversations/#{id}/messages"
+      end
+      Pinnacle::Types::MessageList.from_json(json_object: response.body)
+    end
   end
 
   class AsyncConversationsClient
@@ -159,7 +225,7 @@ module Pinnacle
     #    environment: Pinnacle::Environment::DEFAULT,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.conversations.get(request: { id: 1 })
+    #  api.conversations.get(request: { id: "conv_1234567890" })
     def get(request:, request_options: nil)
       Async do
         response = @request_client.conn.post do |req|
@@ -183,15 +249,20 @@ module Pinnacle
     # 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 brand_id [String] The unique identifier of the brand to filter conversations. This identifier is a
+    #  string that always begins with the prefix `b_`, for example: `b_1234567890`.
+    # @param campaign_id [String] The unique identifier of the campaign to filter conversations. This identifier
+    #  is a string that begins with the prefix:
+    #  - TOLL_FREE: `tf_` (e.g., `tf_1234567890`)
+    #  - 10DLC: `dlc_` (e.g., `dlc_1234567890`)
+    #  - RCS: `rcs_` (e.g., `rcs_1234567890`)
     # @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::ErrorResponse, Pinnacle::Types::RetrievedConversations]
+    # @return [Pinnacle::Types::ConversationList]
     # @example
     #  api = Pinnacle::Client.new(
     #    base_url: "https://api.example.com",
@@ -199,8 +270,8 @@ module Pinnacle
     #    api_key: "YOUR_API_KEY"
     #  )
     #  api.conversations.list(
-    #    brand_id: 101,
-    #    campaign_id: 136,
+    #    brand_id: "b_1234567890",
+    #    campaign_id: "tf_1234567890",
     #    campaign_type: TOLL_FREE,
     #    page_index: 0,
     #    page_size: 20,
@@ -239,7 +310,8 @@ module Pinnacle
 
     # Update the notes associated with a specific conversation.
     #
-    # @param id [Integer] The unique identifier of the conversation to update.
+    # @param id [String] The unique identifier of the conversation to update. This identifier is a string
+    #  that always begins with the prefix `conv_`, for example: `conv_1234567890`.
     # @param notes [String] New notes or comments for the conversation.
     # @param request_options [Pinnacle::RequestOptions]
     # @return [Pinnacle::Types::SuccessfulConversationUpdate]
@@ -249,7 +321,7 @@ module Pinnacle
     #    environment: Pinnacle::Environment::DEFAULT,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.conversations.update(id: 123, notes: "Follow-up completed. Customer satisfied with resolution.")
+    #  api.conversations.update(id: "conv_1234567890", notes: "Follow-up completed. Customer satisfied with resolution.")
     def update(id:, notes:, request_options: nil)
       Async do
         response = @request_client.conn.post do |req|
@@ -269,5 +341,61 @@ module Pinnacle
         Pinnacle::Types::SuccessfulConversationUpdate.from_json(json_object: response.body)
       end
     end
+
+    # Retrieve a paginated and filtered list of messages for a specific conversation.
+    #
+    # @param id [String] Unique identifier of the conversation. This identifier is a string that always
+    #  begins with the prefix `conv_`, for example: `conv_1234567890`.
+    # @param page_index [Integer] Zero-based index for pagination.
+    # @param page_size [Integer] Number of messages to return per page.
+    # @param sort_order [Pinnacle::Conversations::Types::ConversationsListMessagesRequestSortOrder] Sort order for messages. <br>
+    #  - `asc`: Oldest messages first
+    #  - `desc`: Newest messages first (default)
+    # @param direction [Pinnacle::Conversations::Types::ConversationsListMessagesRequestDirection] Filter messages by direction. <br>
+    #  - `INBOUND`: Messages received from contacts
+    #  - `OUTBOUND`: Messages sent to contacts
+    # @param status [Pinnacle::Conversations::Types::ConversationsListMessagesRequestStatus] Filter messages by delivery status.
+    # @param type [Pinnacle::Conversations::Types::ConversationsListMessagesRequestType] Filter messages by protocol type.
+    # @param date_from [DateTime] Filter messages sent on or after this date (ISO 8601 format).
+    # @param date_to [DateTime] Filter messages sent on or before this date (ISO 8601 format).
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::MessageList]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.conversations.list_messages(id: "id")
+    def list_messages(id:, page_index: nil, page_size: nil, sort_order: nil, direction: nil, status: nil, type: nil,
+                      date_from: nil, date_to: 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
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "pageIndex": page_index,
+            "pageSize": page_size,
+            "sortOrder": sort_order,
+            "direction": direction,
+            "status": status,
+            "type": type,
+            "dateFrom": date_from,
+            "dateTo": date_to
+          }.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)}/conversations/#{id}/messages"
+        end
+        Pinnacle::Types::MessageList.from_json(json_object: response.body)
+      end
+    end
   end
 end

data/lib/rcs/conversations/types/conversations_list_messages_request_direction.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Conversations
+    module Types
+      class ConversationsListMessagesRequestDirection
+        INBOUND = "INBOUND"
+        OUTBOUND = "OUTBOUND"
+      end
+    end
+  end
+end

data/lib/rcs/conversations/types/conversations_list_messages_request_sort_order.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Conversations
+    module Types
+      class ConversationsListMessagesRequestSortOrder
+        ASC = "asc"
+        DESC = "desc"
+      end
+    end
+  end
+end

data/lib/rcs/conversations/types/conversations_list_messages_request_status.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Conversations
+    module Types
+      class ConversationsListMessagesRequestStatus
+        PENDING = "PENDING"
+        SENT = "SENT"
+        SEND_FAILED = "SEND_FAILED"
+        DELIVERED = "DELIVERED"
+        DELIVERY_FAILED = "DELIVERY_FAILED"
+        RECEIVED = "RECEIVED"
+        READ = "READ"
+      end
+    end
+  end
+end

data/lib/rcs/conversations/types/conversations_list_messages_request_type.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Conversations
+    module Types
+      class ConversationsListMessagesRequestType
+        SMS = "SMS"
+        MMS = "MMS"
+        RCS = "RCS"
+      end
+    end
+  end
+end