rcs 2.0.0.pre.rc.5 → 2.0.1

data/lib/rcs/messages/client.rb

@@ -4,34 +4,23 @@ require_relative "../../requests"
 require_relative "../types/message"
 require_relative "types/react_message_options"
 require_relative "../types/reaction_result"
-require_relative "sms/client"
-require_relative "mms/client"
-require_relative "rcs/client"
 require "async"
 
 module Pinnacle
   class MessagesClient
     # @return [Pinnacle::RequestClient]
     attr_reader :request_client
-    # @return [Pinnacle::Messages::SmsClient]
-    attr_reader :sms
-    # @return [Pinnacle::Messages::MmsClient]
-    attr_reader :mms
-    # @return [Pinnacle::Messages::RcsClient]
-    attr_reader :rcs
 
     # @param request_client [Pinnacle::RequestClient]
     # @return [Pinnacle::MessagesClient]
     def initialize(request_client:)
       @request_client = request_client
-      @sms = Pinnacle::Messages::SmsClient.new(request_client: request_client)
-      @mms = Pinnacle::Messages::MmsClient.new(request_client: request_client)
-      @rcs = Pinnacle::Messages::RcsClient.new(request_client: request_client)
     end
 
     # Retrieve a previously sent message.
     #
-    # @param id [Integer] Unique identifier of the message.
+    # @param id [String] Unique identifier of the message. This identifier is a string that always begins
+    #  with the prefix `msg_`, for example: `msg_1234567890`.
     # @param request_options [Pinnacle::RequestOptions]
     # @return [Pinnacle::Types::Message]
     # @example
@@ -40,7 +29,7 @@ module Pinnacle
     #    environment: Pinnacle::Environment::DEFAULT,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.messages.get(id: 1240)
+    #  api.messages.get(id: "msg_1234567890")
     def get(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?
@@ -63,7 +52,8 @@ module Pinnacle
 
     # Add or remove an emoji reaction to a previously sent message.
     #
-    # @param message_id [Integer] Unique identifier of the message.
+    # @param message_id [String] Unique identifier of the message. This identifier is a string that always begins
+    #  with the prefix `msg_`, for example: `msg_1234567890`.
     # @param options [Hash] Request of type Pinnacle::Messages::Types::ReactMessageOptions, as a Hash
     #   * :force (Boolean)
     # @param reaction [String] Unicode emoji to add. <br>
@@ -77,7 +67,7 @@ module Pinnacle
     #    api_key: "YOUR_API_KEY"
     #  )
     #  api.messages.react(
-    #    message_id: 1410,
+    #    message_id: "msg_1234567890",
     #    options: { force: true },
     #    reaction: "👍"
     #  )
@@ -108,25 +98,17 @@ module Pinnacle
   class AsyncMessagesClient
     # @return [Pinnacle::AsyncRequestClient]
     attr_reader :request_client
-    # @return [Pinnacle::Messages::AsyncSmsClient]
-    attr_reader :sms
-    # @return [Pinnacle::Messages::AsyncMmsClient]
-    attr_reader :mms
-    # @return [Pinnacle::Messages::AsyncRcsClient]
-    attr_reader :rcs
 
     # @param request_client [Pinnacle::AsyncRequestClient]
     # @return [Pinnacle::AsyncMessagesClient]
     def initialize(request_client:)
       @request_client = request_client
-      @sms = Pinnacle::Messages::AsyncSmsClient.new(request_client: request_client)
-      @mms = Pinnacle::Messages::AsyncMmsClient.new(request_client: request_client)
-      @rcs = Pinnacle::Messages::AsyncRcsClient.new(request_client: request_client)
     end
 
     # Retrieve a previously sent message.
     #
-    # @param id [Integer] Unique identifier of the message.
+    # @param id [String] Unique identifier of the message. This identifier is a string that always begins
+    #  with the prefix `msg_`, for example: `msg_1234567890`.
     # @param request_options [Pinnacle::RequestOptions]
     # @return [Pinnacle::Types::Message]
     # @example
@@ -135,7 +117,7 @@ module Pinnacle
     #    environment: Pinnacle::Environment::DEFAULT,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.messages.get(id: 1240)
+    #  api.messages.get(id: "msg_1234567890")
     def get(id:, request_options: nil)
       Async do
         response = @request_client.conn.get do |req|
@@ -160,7 +142,8 @@ module Pinnacle
 
     # Add or remove an emoji reaction to a previously sent message.
     #
-    # @param message_id [Integer] Unique identifier of the message.
+    # @param message_id [String] Unique identifier of the message. This identifier is a string that always begins
+    #  with the prefix `msg_`, for example: `msg_1234567890`.
     # @param options [Hash] Request of type Pinnacle::Messages::Types::ReactMessageOptions, as a Hash
     #   * :force (Boolean)
     # @param reaction [String] Unicode emoji to add. <br>
@@ -174,7 +157,7 @@ module Pinnacle
     #    api_key: "YOUR_API_KEY"
     #  )
     #  api.messages.react(
-    #    message_id: 1410,
+    #    message_id: "msg_1234567890",
     #    options: { force: true },
     #    reaction: "👍"
     #  )

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

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
 require_relative "../../../requests"
-require_relative "../../types/rcs"
+require_relative "../../types/rich_message"
 require_relative "types/rcs_send_response"
+require_relative "types/send_typing_indicator_schema_options"
+require_relative "../../types/send_typing_indicator_response"
 require_relative "../../types/rcs_validate_content"
 require_relative "../../types/rcs_validation_result"
 require "async"
@@ -51,6 +53,66 @@ module Pinnacle
         Pinnacle::Messages::Rcs::Types::RcsSendResponse.from_json(json_object: response.body)
       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
+      #  le.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 agent_id [String] The unique identifier of the RCS agent sending the typing indicator. <br>
+      #  Format: `agent_` followed by alphanumeric characters (e.g., `agent_pinnacle`).
+      # @param to [String] The recipient's phone number in E.164 format. <br>
+      #  Must include country code with a leading plus sign (e.g., `+14155551234`).
+      # @param options [Hash] Configure how your typing indicator is sent.Request of type Pinnacle::Messages::Rcs::Types::SendTypingIndicatorSchemaOptions, as a Hash
+      #   * :test_mode (Boolean)
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::SendTypingIndicatorResponse]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.messages.rcs.send_typing(
+      #    agent_id: "agent_pinnacle",
+      #    to: "+14154746461",
+      #    options: { test_mode: false }
+      #  )
+      def send_typing(agent_id:, to:, options: 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 || {}),
+            agentId: agent_id,
+            to: to,
+            options: options
+          }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/messages/typing"
+        end
+        Pinnacle::Types::SendTypingIndicatorResponse.from_json(json_object: response.body)
+      end
+
       # Validate RCS message content without sending it.
       #
       # @param request [Pinnacle::Types::RcsTextContent, Pinnacle::Types::RcsValidateContentMedia, Pinnacle::Types::RcsCards]
@@ -126,6 +188,68 @@ module Pinnacle
         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
+      #  le.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 agent_id [String] The unique identifier of the RCS agent sending the typing indicator. <br>
+      #  Format: `agent_` followed by alphanumeric characters (e.g., `agent_pinnacle`).
+      # @param to [String] The recipient's phone number in E.164 format. <br>
+      #  Must include country code with a leading plus sign (e.g., `+14155551234`).
+      # @param options [Hash] Configure how your typing indicator is sent.Request of type Pinnacle::Messages::Rcs::Types::SendTypingIndicatorSchemaOptions, as a Hash
+      #   * :test_mode (Boolean)
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::SendTypingIndicatorResponse]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.messages.rcs.send_typing(
+      #    agent_id: "agent_pinnacle",
+      #    to: "+14154746461",
+      #    options: { test_mode: false }
+      #  )
+      def send_typing(agent_id:, to:, options: 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 || {}),
+              agentId: agent_id,
+              to: to,
+              options: options
+            }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/messages/typing"
+          end
+          Pinnacle::Types::SendTypingIndicatorResponse.from_json(json_object: response.body)
+        end
+      end
+
       # Validate RCS message content without sending it.
       #
       # @param request [Pinnacle::Types::RcsTextContent, Pinnacle::Types::RcsValidateContentMedia, Pinnacle::Types::RcsCards]

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

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module Pinnacle
+  module Messages
+    module Rcs
+      module Types
+        # Configure how your typing indicator is sent.
+        class SendTypingIndicatorSchemaOptions
+          # @return [Boolean] Send via the test agent to whitelisted test devices. Useful for development and
+          #  debugging.
+          attr_reader :test_mode
+          # @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 test_mode [Boolean] Send via the test agent to whitelisted test devices. Useful for development and
+          #  debugging.
+          # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+          # @return [Pinnacle::Messages::Rcs::Types::SendTypingIndicatorSchemaOptions]
+          def initialize(test_mode: OMIT, additional_properties: nil)
+            @test_mode = test_mode if test_mode != OMIT
+            @additional_properties = additional_properties
+            @_field_set = { "test_mode": test_mode }.reject do |_k, v|
+              v == OMIT
+            end
+          end
+
+          # Deserialize a JSON object to an instance of SendTypingIndicatorSchemaOptions
+          #
+          # @param json_object [String]
+          # @return [Pinnacle::Messages::Rcs::Types::SendTypingIndicatorSchemaOptions]
+          def self.from_json(json_object:)
+            struct = JSON.parse(json_object, object_class: OpenStruct)
+            parsed_json = JSON.parse(json_object)
+            test_mode = parsed_json["test_mode"]
+            new(test_mode: test_mode, additional_properties: struct)
+          end
+
+          # Serialize an instance of SendTypingIndicatorSchemaOptions 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.test_mode&.is_a?(Boolean) != false || raise("Passed value for field obj.test_mode is not the expected type, validation failed.")
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -18,11 +18,18 @@ module Pinnacle
         @request_client = request_client
       end
 
-      # Link a phone number to a specific campaign.
+      # Link a phone number to a specific campaign. Phone numbers must be linked to a
+      #  campaign to send messages.
       #
       # @param phones [Array<String>] List of phone number (E.164 format).
       # @param campaign_type [Pinnacle::Types::MessagingProfileEnum]
-      # @param campaign_id [Integer] Campaign's identifier.
+      # @param campaign_id [String] Unique identifier for the campaign. <br>
+      #  - **TOLL_FREE** campaigns:
+      #  - Must begin with the prefix `tf_`
+      #  - Example: `tf_1234567890`
+      #  - **10DLC** campaigns:
+      #  - Must begin with the prefix `dlc_`
+      #  - Example: `dlc_1234567890`
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::AttachedPhoneNumberResult]
       # @example
@@ -34,7 +41,7 @@ module Pinnacle
       #  api.phone_numbers.campaign.attach(
       #    phones: ["+14155550123", "+14155559876", "+14155550111"],
       #    campaign_type: TOLL_FREE,
-      #    campaign_id: 101
+      #    campaign_id: "tf_1234567890"
       #  )
       def attach(phones:, campaign_type:, campaign_id:, request_options: nil)
         response = @request_client.conn.post do |req|
@@ -100,11 +107,18 @@ module Pinnacle
         @request_client = request_client
       end
 
-      # Link a phone number to a specific campaign.
+      # Link a phone number to a specific campaign. Phone numbers must be linked to a
+      #  campaign to send messages.
       #
       # @param phones [Array<String>] List of phone number (E.164 format).
       # @param campaign_type [Pinnacle::Types::MessagingProfileEnum]
-      # @param campaign_id [Integer] Campaign's identifier.
+      # @param campaign_id [String] Unique identifier for the campaign. <br>
+      #  - **TOLL_FREE** campaigns:
+      #  - Must begin with the prefix `tf_`
+      #  - Example: `tf_1234567890`
+      #  - **10DLC** campaigns:
+      #  - Must begin with the prefix `dlc_`
+      #  - Example: `dlc_1234567890`
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::AttachedPhoneNumberResult]
       # @example
@@ -116,7 +130,7 @@ module Pinnacle
       #  api.phone_numbers.campaign.attach(
       #    phones: ["+14155550123", "+14155559876", "+14155550111"],
       #    campaign_type: TOLL_FREE,
-      #    campaign_id: 101
+      #    campaign_id: "tf_1234567890"
       #  )
       def attach(phones:, campaign_type:, campaign_id:, request_options: nil)
         Async do

data/lib/rcs/phone_numbers/client.rb

@@ -12,25 +12,17 @@ require_relative "../types/purchased_number"
 require_relative "types/phone_details_schema_level"
 require_relative "types/retrieve_phone_number_details_options"
 require_relative "types/phone_numbers_get_response"
-require_relative "campaign/client"
-require_relative "webhook/client"
 require "async"
 
 module Pinnacle
   class PhoneNumbersClient
     # @return [Pinnacle::RequestClient]
     attr_reader :request_client
-    # @return [Pinnacle::PhoneNumbers::CampaignClient]
-    attr_reader :campaign
-    # @return [Pinnacle::PhoneNumbers::WebhookClient]
-    attr_reader :webhook
 
     # @param request_client [Pinnacle::RequestClient]
     # @return [Pinnacle::PhoneNumbersClient]
     def initialize(request_client:)
       @request_client = request_client
-      @campaign = Pinnacle::PhoneNumbers::CampaignClient.new(request_client: request_client)
-      @webhook = Pinnacle::PhoneNumbers::WebhookClient.new(request_client: request_client)
     end
 
     # Search for available phone numbers that match your exact criteria.
@@ -187,17 +179,11 @@ module Pinnacle
   class AsyncPhoneNumbersClient
     # @return [Pinnacle::AsyncRequestClient]
     attr_reader :request_client
-    # @return [Pinnacle::PhoneNumbers::AsyncCampaignClient]
-    attr_reader :campaign
-    # @return [Pinnacle::PhoneNumbers::AsyncWebhookClient]
-    attr_reader :webhook
 
     # @param request_client [Pinnacle::AsyncRequestClient]
     # @return [Pinnacle::AsyncPhoneNumbersClient]
     def initialize(request_client:)
       @request_client = request_client
-      @campaign = Pinnacle::PhoneNumbers::AsyncCampaignClient.new(request_client: request_client)
-      @webhook = Pinnacle::PhoneNumbers::AsyncWebhookClient.new(request_client: request_client)
     end
 
     # Search for available phone numbers that match your exact criteria.

data/lib/rcs/phone_numbers/webhook/client.rb

@@ -24,7 +24,7 @@ module Pinnacle
       # @param phone [String] The phone number you want to attach the webhook to in E.164 format. Make sure it
       #  is url encoded (i.e. replace the leading + with %2B). <br>
       #  Must be a phone number that you own and have already [purchased](./buy) through
-      #  the API.
+      #  the API. A phone number can have multiple webhooks attached to it.
       # @param request [Pinnacle::Types::AttachWebhookByIdParams, Pinnacle::Types::CreateAndAttachWebhookByUrlParams]
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::ConfiguredWebhook]
@@ -34,7 +34,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.phone_numbers.webhook.attach(phone: "%2B14155551234", request: { webhook_id: 1 })
+      #  api.phone_numbers.webhook.attach(phone: "%2B14155551234", request: { webhook_id: "wh_1234567890", event: MESSAGE_STATUS })
       def attach(phone:, 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?
@@ -62,10 +62,11 @@ module Pinnacle
       #  is url encoded (i.e. replace the leading + with %2B). <br>
       #  Must be a phone number that you own and currently has the specified webhook
       #  attached.
-      # @param webhook_id [Integer] The unique identifier of the webhook you want to detach from the phone number.
+      # @param webhook_id [String] The unique identifier of the webhook you want to detach from the phone number.
       #  <br>
       #  This must be a valid webhook ID that is currently attached to the specified
-      #  phone number.
+      #  phone number. This identifier is a string that always begins with the prefix
+      #  `wh_`, for example: `wh_1234567890`.
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::DetachedWebhookInfo]
       # @example
@@ -74,7 +75,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.phone_numbers.webhook.detach(phone: "+14155551234", webhook_id: 123)
+      #  api.phone_numbers.webhook.detach(phone: "+14155551234", webhook_id: "wh_1234567890")
       def detach(phone:, webhook_id:, request_options: nil)
         response = @request_client.conn.delete do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -112,7 +113,7 @@ module Pinnacle
       # @param phone [String] The phone number you want to attach the webhook to in E.164 format. Make sure it
       #  is url encoded (i.e. replace the leading + with %2B). <br>
       #  Must be a phone number that you own and have already [purchased](./buy) through
-      #  the API.
+      #  the API. A phone number can have multiple webhooks attached to it.
       # @param request [Pinnacle::Types::AttachWebhookByIdParams, Pinnacle::Types::CreateAndAttachWebhookByUrlParams]
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::ConfiguredWebhook]
@@ -122,7 +123,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.phone_numbers.webhook.attach(phone: "%2B14155551234", request: { webhook_id: 1 })
+      #  api.phone_numbers.webhook.attach(phone: "%2B14155551234", request: { webhook_id: "wh_1234567890", event: MESSAGE_STATUS })
       def attach(phone:, request:, request_options: nil)
         Async do
           response = @request_client.conn.post do |req|
@@ -152,10 +153,11 @@ module Pinnacle
       #  is url encoded (i.e. replace the leading + with %2B). <br>
       #  Must be a phone number that you own and currently has the specified webhook
       #  attached.
-      # @param webhook_id [Integer] The unique identifier of the webhook you want to detach from the phone number.
+      # @param webhook_id [String] The unique identifier of the webhook you want to detach from the phone number.
       #  <br>
       #  This must be a valid webhook ID that is currently attached to the specified
-      #  phone number.
+      #  phone number. This identifier is a string that always begins with the prefix
+      #  `wh_`, for example: `wh_1234567890`.
       # @param request_options [Pinnacle::RequestOptions]
       # @return [Pinnacle::Types::DetachedWebhookInfo]
       # @example
@@ -164,7 +166,7 @@ module Pinnacle
       #    environment: Pinnacle::Environment::DEFAULT,
       #    api_key: "YOUR_API_KEY"
       #  )
-      #  api.phone_numbers.webhook.detach(phone: "+14155551234", webhook_id: 123)
+      #  api.phone_numbers.webhook.detach(phone: "+14155551234", webhook_id: "wh_1234567890")
       def detach(phone:, webhook_id:, request_options: nil)
         Async do
           response = @request_client.conn.delete do |req|

data/lib/rcs/rcs/client.rb

@@ -59,23 +59,30 @@ module Pinnacle
     #  ## Overview
     #  During development and testing, RCS agents can only send messages to whitelisted
     #  phone numbers.
-    #  Use this endpoint to add test devices to your agent's whitelist before sending
-    #  test messages.
+    #  Use this endpoint to whitelist specific phone numbers to send and receive
+    #  messages from the test agent.
     #  ## Verification Process
     #  After whitelisting a number, you'll need to complete verification:
-    #  1. Check the test device for an "RBM Tester Management" request
-    #  2. Accept the request on the device
-    #  3. Enter the 4-digit verification code in the Pinnacle dashboard at:
+    #  1. Check the test device for message from "RBM Tester Management"
+    #  2. Click the "Make me a tester" button
+    #  3. Enter the separate 4-digit verification SMS code in the Pinnacle dashboard
+    #  at:
     #  ```
     #  .pinnacle.sh/dashboard/brands/{brandId}?campaignId={campaignId}&campaignType=RCS
     #  ```
+    #  > **⚠️ Important: Re-whitelisting Numbers**
+    #  >
+    #  > If you whitelist a number that's already whitelisted, you'll receive a new
+    #  message from "RBM Tester Management". **You must click the "Make me a tester"
+    #  button again to continue sending and receiving messages.**
     #  > **Important Notes**
     #  >
+    #  > - **Verification required:** Messages cannot be sent nor received until you
+    #  have clicked the "Make me a tester" button on the test device.
     #  > - **Testing only:** This is only required for test agents. Production agents
-    #  can message any RCS-enabled number
-    #  > - **AT&T limitation:** Whitelisting may currently fail for AT&T numbers
-    #  > - **Verification required:** The whitelist request isn't complete until you
-    #  verify the device.
+    #  can message any RCS-enabled number.
+    #  > - **Network limitations:** Whitelisting may be temporarily unavailable for
+    #  some carriers but are usually restored shortly.
     #
     # @param agent_id [String] The RCS agent ID (must be prefixed with 'agent_')
     # @param phone_number [String] Phone number to whitelist for testing (E.164 format)
@@ -211,23 +218,30 @@ module Pinnacle
     #  ## Overview
     #  During development and testing, RCS agents can only send messages to whitelisted
     #  phone numbers.
-    #  Use this endpoint to add test devices to your agent's whitelist before sending
-    #  test messages.
+    #  Use this endpoint to whitelist specific phone numbers to send and receive
+    #  messages from the test agent.
     #  ## Verification Process
     #  After whitelisting a number, you'll need to complete verification:
-    #  1. Check the test device for an "RBM Tester Management" request
-    #  2. Accept the request on the device
-    #  3. Enter the 4-digit verification code in the Pinnacle dashboard at:
+    #  1. Check the test device for message from "RBM Tester Management"
+    #  2. Click the "Make me a tester" button
+    #  3. Enter the separate 4-digit verification SMS code in the Pinnacle dashboard
+    #  at:
     #  ```
     #  .pinnacle.sh/dashboard/brands/{brandId}?campaignId={campaignId}&campaignType=RCS
     #  ```
+    #  > **⚠️ Important: Re-whitelisting Numbers**
+    #  >
+    #  > If you whitelist a number that's already whitelisted, you'll receive a new
+    #  message from "RBM Tester Management". **You must click the "Make me a tester"
+    #  button again to continue sending and receiving messages.**
     #  > **Important Notes**
     #  >
+    #  > - **Verification required:** Messages cannot be sent nor received until you
+    #  have clicked the "Make me a tester" button on the test device.
     #  > - **Testing only:** This is only required for test agents. Production agents
-    #  can message any RCS-enabled number
-    #  > - **AT&T limitation:** Whitelisting may currently fail for AT&T numbers
-    #  > - **Verification required:** The whitelist request isn't complete until you
-    #  verify the device.
+    #  can message any RCS-enabled number.
+    #  > - **Network limitations:** Whitelisting may be temporarily unavailable for
+    #  some carriers but are usually restored shortly.
     #
     # @param agent_id [String] The RCS agent ID (must be prefixed with 'agent_')
     # @param phone_number [String] Phone number to whitelist for testing (E.164 format)