rcs 2.0.11 → 2.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a5841ff03fdde7a2ead0de8ccdd774f8c507d378cc47777af4133e30579d0aea
-  data.tar.gz: 95b18d886ba057009f2123858129beed4bedbc2f09cb1e72752c9bd056cd3749
+  metadata.gz: 1c99a464d0f0ef9afe1e7b08f06a9a20cb97840340c52de58fe006490c6e8941
+  data.tar.gz: e15cbae3c8c44e7eb7d023fb762fc41678120d3122ea9cb7febdade3b65912b0
 SHA512:
-  metadata.gz: 8925e03ef43e31adb11bd6161dc75e0e7d7a124b3eded1d2db8db7ebe2f553372f4b29357d591804e17683bcfd0e6ec45e732cb4d6428ccef94f561d1b25bcfb
-  data.tar.gz: 3038a74a20d551c85121e2b1a0eb5d6b6169b2d76efaca1aac0553bdfa12eb0d51850cbbaecd7bcd92ca7930dd969ab88e208a93c2b36a73fef45d2bb37f11b3
+  metadata.gz: 1adea3a08c1c1e0580e64042cca8b267df2503b8efa6b460e553350abb99b0b40ffe77056a8501b5dbdc73e65413916e21b8fb5ad0dc70af8144b16ba5d329d4
+  data.tar.gz: ec0ffc8495e23302b34c21fc335bebc8d7c6953fae0c13141b3fda5812fbe86a84e007ddbfdc0cef05e501f8e7d67c9cf85af6dc1b19e1564efef5ed4b55029d

data/.fern/metadata.json

@@ -7,5 +7,5 @@
     "flattenModuleStructure": true,
     "useProvidedDefaults": true
   },
-  "sdkVersion": "2.0.11"
+  "sdkVersion": "2.0.13"
 }

data/lib/pinnacle/client.rb

@@ -10,7 +10,7 @@ module Pinnacle
       @raw_client = Pinnacle::Internal::Http::RawClient.new(
         base_url: base_url || Pinnacle::Environment::DEFAULT,
         headers: {
-          "User-Agent" => "rcs/2.0.11",
+          "User-Agent" => "rcs/2.0.13",
           "X-Fern-Language" => "Ruby",
           "PINNACLE-API-KEY" => api_key.to_s
         }

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

@@ -11,6 +11,7 @@ module Pinnacle
         SEND_FAILED = "SEND_FAILED"
         DELIVERED = "DELIVERED"
         DELIVERY_FAILED = "DELIVERY_FAILED"
+        FALLBACK_SENT = "FALLBACK_SENT"
         RECEIVED = "RECEIVED"
         READ = "READ"
       end

data/lib/pinnacle/messages/blast/types/blast_rcs.rb

@@ -8,6 +8,7 @@ module Pinnacle
           field :audience_id, -> { String }, optional: false, nullable: false, api_name: "audienceId"
           field :senders, -> { Internal::Types::Array[String] }, optional: false, nullable: false
           field :message, -> { Pinnacle::Types::RcsValidateContent }, optional: false, nullable: false
+          field :fallback, -> { Pinnacle::Types::FallbackMessage }, optional: true, nullable: false
           field :options, -> { Pinnacle::Messages::Blast::Types::BlastRcsOptions }, optional: true, nullable: false
         end
       end

data/lib/pinnacle/types/base_rich_message.rb

@@ -4,6 +4,7 @@ module Pinnacle
   module Types
     class BaseRichMessage < Internal::Types::Model
       field :from, -> { String }, optional: false, nullable: false
+      field :fallback, -> { Pinnacle::Types::FallbackMessage }, optional: true, nullable: false
       field :options, -> { Pinnacle::Types::SendRichMessageOptions }, optional: true, nullable: false
       field :to, -> { String }, optional: false, nullable: false
     end

data/lib/pinnacle/types/fallback_message.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # SMS/MMS fallback message to send if the RCS message fails to deliver.
+    #
+    # When a recipient's device doesn't support RCS or the RCS message cannot be delivered, this fallback message will
+    # be sent as SMS or MMS instead. The fallback is sent from the specified phone number.
+    #
+    # > **Note:** At least one of `text` or `mediaUrls` must be provided. Fallback messages require a verified `from`
+    # phone number with SMS/MMS sending capabilities.
+    # > **Note:** You will not be charged for the fallback message, only the original RCS message will be charged.
+    class FallbackMessage < Internal::Types::Model
+      field :from, -> { String }, optional: false, nullable: false
+      field :text, -> { String }, optional: true, nullable: false
+      field :media_urls, -> { Internal::Types::Array[String] }, optional: true, nullable: false, api_name: "mediaUrls"
+    end
+  end
+end

data/lib/pinnacle/types/message.rb

@@ -7,6 +7,7 @@ module Pinnacle
       field :cost, -> { Integer }, optional: false, nullable: true
       field :delivered_at, -> { String }, optional: false, nullable: true, api_name: "deliveredAt"
       field :error, -> { String }, optional: false, nullable: true
+      field :fallback, -> { Pinnacle::Types::FallbackMessage }, optional: true, nullable: false
       field :id, -> { String }, optional: false, nullable: false
       field :method_, -> { Pinnacle::Types::MessageMethodEnum }, optional: false, nullable: false, api_name: "method"
       field :num_segments, -> { Integer }, optional: false, nullable: false, api_name: "numSegments"

data/lib/pinnacle/types/message_event.rb

@@ -12,6 +12,7 @@ module Pinnacle
       field :sent_at, -> { String }, optional: false, nullable: false, api_name: "sentAt"
       field :delivered_at, -> { String }, optional: true, nullable: false, api_name: "deliveredAt"
       field :message, -> { Pinnacle::Types::MessageEventContent }, optional: false, nullable: false
+      field :fallback_message, -> { Pinnacle::Types::MessageEventFallbackMessage }, optional: true, nullable: false, api_name: "fallbackMessage"
     end
   end
 end

data/lib/pinnacle/types/message_event_content.rb

@@ -6,13 +6,15 @@ module Pinnacle
     class MessageEventContent < Internal::Types::Model
       extend Pinnacle::Internal::Types::Union
 
-      member -> { Pinnacle::Types::MessageEventSmsContent }
-      member -> { Pinnacle::Types::MessageEventMmsContent }
-      member -> { Pinnacle::Types::MessageEventRcsTextContent }
-      member -> { Pinnacle::Types::MessageEventRcsMediaContent }
-      member -> { Pinnacle::Types::MessageEventRcsCardsContent }
-      member -> { Pinnacle::Types::MessageEventRcsButtonData }
-      member -> { Pinnacle::Types::MessageEventRcsLocationData }
+      discriminant :type
+
+      member -> { Pinnacle::Types::MessageEventSmsContent }, key: "SMS"
+      member -> { Pinnacle::Types::MessageEventMmsContent }, key: "MMS"
+      member -> { Pinnacle::Types::MessageEventRcsTextContent }, key: "RCS_TEXT"
+      member -> { Pinnacle::Types::MessageEventRcsMediaContent }, key: "RCS_MEDIA"
+      member -> { Pinnacle::Types::MessageEventRcsCardsContent }, key: "RCS_CARDS"
+      member -> { Pinnacle::Types::MessageEventRcsButtonData }, key: "RCS_BUTTON_DATA"
+      member -> { Pinnacle::Types::MessageEventRcsLocationData }, key: "RCS_LOCATION_DATA"
     end
   end
 end

data/lib/pinnacle/types/message_event_fallback_message.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Details of the fallback SMS/MMS message that was sent instead of the original RCS message.
+    #
+    # This field is only present when the message `status` is `FALLBACK_SENT`, indicating the original RCS message could
+    # not be delivered and a fallback message was sent instead.
+    #
+    # Use this information to track which fallback messages were sent and their content.
+    class MessageEventFallbackMessage < Internal::Types::Model
+      field :id, -> { String }, optional: false, nullable: false
+      field :type, -> { Pinnacle::Types::MessageEventFallbackMessageType }, optional: false, nullable: false
+      field :from, -> { String }, optional: false, nullable: false
+      field :to, -> { String }, optional: false, nullable: false
+      field :text, -> { String }, optional: true, nullable: false
+      field :media_urls, -> { Internal::Types::Array[String] }, optional: true, nullable: false, api_name: "mediaUrls"
+    end
+  end
+end

data/lib/pinnacle/types/message_event_fallback_message_type.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    module MessageEventFallbackMessageType
+      extend Pinnacle::Internal::Types::Enum
+
+      SMS = "SMS"
+      MMS = "MMS"
+    end
+  end
+end

data/lib/pinnacle/types/message_event_mms_content.rb

@@ -4,7 +4,6 @@ module Pinnacle
   module Types
     # MMS message with text and/or media files from a phone number.
     class MessageEventMmsContent < Internal::Types::Model
-      field :type, -> { String }, optional: false, nullable: false
       field :id, -> { String }, optional: false, nullable: false
       field :media_urls, -> { Internal::Types::Array[String] }, optional: false, nullable: false, api_name: "mediaUrls"
       field :text, -> { String }, optional: true, nullable: false

data/lib/pinnacle/types/message_event_rcs_button_data.rb

@@ -8,8 +8,9 @@ module Pinnacle
     # This event contains information about which button was clicked, how many times it's been clicked, and any payload
     # or metadata attached to the button. Use this data to handle user interactions with your RCS messages.
     class MessageEventRcsButtonData < Internal::Types::Model
-      field :type, -> { String }, optional: false, nullable: false
       field :id, -> { String }, optional: false, nullable: false
+      field :button, -> { Pinnacle::Types::MessageEventRcsButtonDataButton }, optional: false, nullable: false
+      field :message_id, -> { String }, optional: false, nullable: true, api_name: "messageId"
     end
   end
 end

data/lib/pinnacle/types/message_event_rcs_button_data_button.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Information about the button that was clicked.
+    class MessageEventRcsButtonDataButton < Internal::Types::Model
+      field :type, -> { Pinnacle::Types::MessageEventRcsButtonDataButtonType }, optional: true, nullable: false
+      field :raw, -> { Pinnacle::Types::MessageEventRcsButtonDataButtonRaw }, optional: false, nullable: false
+      field :payload, -> { String }, optional: true, nullable: false
+      field :metadata, -> { String }, optional: true, nullable: false
+      field :clicks, -> { Integer }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/message_event_rcs_button_data_button_raw.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Raw button data. Contains the entire button that was clicked by the user. In rare cases where we cannot determine
+    # the exact button, this will return only the button title.
+    class MessageEventRcsButtonDataButtonRaw < Internal::Types::Model
+      extend Pinnacle::Internal::Types::Union
+
+      member -> { Pinnacle::Types::RichButton }
+      member -> { String }
+    end
+  end
+end

data/lib/pinnacle/types/message_event_rcs_button_data_button_type.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    module MessageEventRcsButtonDataButtonType
+      extend Pinnacle::Internal::Types::Enum
+
+      CARD = "CARD"
+      QUICK_REPLY = "QUICK_REPLY"
+    end
+  end
+end

data/lib/pinnacle/types/message_event_rcs_cards_content.rb

@@ -7,7 +7,6 @@ module Pinnacle
     #
     # See [supported file types](https://app.pinnacle.sh/supported-file-types?type=RCS-CARD).
     class MessageEventRcsCardsContent < Internal::Types::Model
-      field :type, -> { String }, optional: false, nullable: false
       field :id, -> { String }, optional: false, nullable: false
       field :cards, -> { Internal::Types::Array[Pinnacle::Types::MessageEventRcsCardsContentCardsItem] }, optional: false, nullable: false
       field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"

data/lib/pinnacle/types/message_event_rcs_location_data.rb

@@ -8,8 +8,9 @@ module Pinnacle
     # This event contains the geographic coordinates (latitude/longitude) and human-readable address of the location the
     # user chose to share. Use this data to process location-based requests or provide location-specific services.
     class MessageEventRcsLocationData < Internal::Types::Model
-      field :type, -> { String }, optional: false, nullable: false
       field :id, -> { String }, optional: false, nullable: false
+      field :data, -> { Pinnacle::Types::MessageEventRcsLocationDataData }, optional: false, nullable: false
+      field :message_id, -> { String }, optional: true, nullable: false, api_name: "messageId"
     end
   end
 end

data/lib/pinnacle/types/message_event_rcs_location_data_data.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Location data shared by the user.
+    class MessageEventRcsLocationDataData < Internal::Types::Model
+      field :address, -> { String }, optional: false, nullable: false
+      field :latitude, -> { Integer }, optional: false, nullable: false
+      field :longitude, -> { Integer }, optional: false, nullable: false
+      field :text, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/message_event_rcs_media_content.rb

@@ -6,7 +6,6 @@ module Pinnacle
     #
     # See [supported file types](https://app.pinnacle.sh/supported-file-types?type=RCS-MEDIA).
     class MessageEventRcsMediaContent < Internal::Types::Model
-      field :type, -> { String }, optional: false, nullable: false
       field :id, -> { String }, optional: false, nullable: false
       field :media, -> { String }, optional: false, nullable: false
       field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"

data/lib/pinnacle/types/message_event_rcs_text_content.rb

@@ -4,7 +4,6 @@ module Pinnacle
   module Types
     # RCS message containing longer text content with optional quick reply buttons.
     class MessageEventRcsTextContent < Internal::Types::Model
-      field :type, -> { String }, optional: false, nullable: false
       field :id, -> { String }, optional: false, nullable: false
       field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
       field :text, -> { String }, optional: false, nullable: false

data/lib/pinnacle/types/message_event_sms_content.rb

@@ -4,7 +4,6 @@ module Pinnacle
   module Types
     # SMS message containing plain text only.
     class MessageEventSmsContent < Internal::Types::Model
-      field :type, -> { String }, optional: false, nullable: false
       field :id, -> { String }, optional: false, nullable: false
       field :text, -> { String }, optional: false, nullable: false
     end

data/lib/pinnacle/types/message_status_enum.rb

@@ -13,6 +13,7 @@ module Pinnacle
       DELIVERY_FAILED = "DELIVERY_FAILED"
       RECEIVED = "RECEIVED"
       READ = "READ"
+      FALLBACK_SENT = "FALLBACK_SENT"
     end
   end
 end

data/lib/pinnacle/types/rich_cards_message.rb

@@ -5,6 +5,7 @@ module Pinnacle
     class RichCardsMessage < Internal::Types::Model
       field :options, -> { Pinnacle::Types::SendRichCardsOptions }, optional: true, nullable: false
       field :from, -> { String }, optional: false, nullable: false
+      field :fallback, -> { Pinnacle::Types::FallbackMessage }, optional: true, nullable: false
       field :to, -> { String }, optional: false, nullable: false
     end
   end

data/lib/pinnacle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pinnacle
-  VERSION = "2.0.11"
+  VERSION = "2.0.13"
 end

data/lib/pinnacle.rb

@@ -0,0 +1,453 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "securerandom"
+
+require_relative "pinnacle/internal/json/serializable"
+require_relative "pinnacle/internal/types/type"
+require_relative "pinnacle/internal/types/utils"
+require_relative "pinnacle/internal/types/union"
+require_relative "pinnacle/internal/errors/constraint_error"
+require_relative "pinnacle/internal/errors/type_error"
+require_relative "pinnacle/internal/http/base_request"
+require_relative "pinnacle/internal/json/request"
+require_relative "pinnacle/internal/http/raw_client"
+require_relative "pinnacle/internal/multipart/multipart_encoder"
+require_relative "pinnacle/internal/multipart/multipart_form_data_part"
+require_relative "pinnacle/internal/multipart/multipart_form_data"
+require_relative "pinnacle/internal/multipart/multipart_request"
+require_relative "pinnacle/internal/types/model/field"
+require_relative "pinnacle/internal/types/model"
+require_relative "pinnacle/internal/types/array"
+require_relative "pinnacle/internal/types/boolean"
+require_relative "pinnacle/internal/types/enum"
+require_relative "pinnacle/internal/types/hash"
+require_relative "pinnacle/internal/types/unknown"
+require_relative "pinnacle/errors/api_error"
+require_relative "pinnacle/errors/response_error"
+require_relative "pinnacle/errors/client_error"
+require_relative "pinnacle/errors/redirect_error"
+require_relative "pinnacle/errors/server_error"
+require_relative "pinnacle/errors/timeout_error"
+require_relative "pinnacle/internal/iterators/item_iterator"
+require_relative "pinnacle/internal/iterators/cursor_item_iterator"
+require_relative "pinnacle/internal/iterators/offset_item_iterator"
+require_relative "pinnacle/internal/iterators/cursor_page_iterator"
+require_relative "pinnacle/internal/iterators/offset_page_iterator"
+require_relative "pinnacle/brands/types/autofill_brand_options"
+require_relative "pinnacle/brands/types/upsert_brand_schema_contact"
+require_relative "pinnacle/brands/types/upsert_brand_schema_sector"
+require_relative "pinnacle/brands/types/upsert_brand_schema_type"
+require_relative "pinnacle/brands/types/upsert_brand_schema_entity_type"
+require_relative "pinnacle/types/contact"
+require_relative "pinnacle/types/pagination"
+require_relative "pinnacle/types/audience_with_pagination"
+require_relative "pinnacle/types/audience_count_only"
+require_relative "pinnacle/audiences/types/audiences_get_response"
+require_relative "pinnacle/conversations/types/conversations_list_messages_request_sort_order"
+require_relative "pinnacle/conversations/types/conversations_list_messages_request_direction"
+require_relative "pinnacle/conversations/types/conversations_list_messages_request_status"
+require_relative "pinnacle/conversations/types/conversations_list_messages_request_type"
+require_relative "pinnacle/messages/types/react_message_options"
+require_relative "pinnacle/phone_numbers/types/search_phone_number_by_location"
+require_relative "pinnacle/phone_numbers/types/search_phone_number_by_digits"
+require_relative "pinnacle/phone_numbers/types/search_phone_number_options"
+require_relative "pinnacle/phone_numbers/types/phone_details_schema_level"
+require_relative "pinnacle/phone_numbers/types/enhanced_contact_info"
+require_relative "pinnacle/phone_numbers/types/retrieve_phone_number_details_options"
+require_relative "pinnacle/types/phone_number_enum"
+require_relative "pinnacle/types/number_format"
+require_relative "pinnacle/types/basic_phone_information_location_country"
+require_relative "pinnacle/types/basic_phone_information_location"
+require_relative "pinnacle/types/basic_phone_information_contact"
+require_relative "pinnacle/types/basic_phone_information"
+require_relative "pinnacle/types/detailed_phone_number_enum"
+require_relative "pinnacle/types/enhanced_contact_item"
+require_relative "pinnacle/types/enhanced_contact"
+require_relative "pinnacle/types/advanced_phone_information_type_recommendation"
+require_relative "pinnacle/types/advanced_phone_information_type"
+require_relative "pinnacle/types/advanced_phone_information_location_country"
+require_relative "pinnacle/types/advanced_phone_information_location_coordinates"
+require_relative "pinnacle/types/advanced_phone_information_location"
+require_relative "pinnacle/types/advanced_phone_information_carrier"
+require_relative "pinnacle/types/advanced_phone_information_contact"
+require_relative "pinnacle/types/advanced_phone_information"
+require_relative "pinnacle/phone_numbers/types/phone_numbers_get_response"
+require_relative "pinnacle/campaigns/dlc/types/dlc_campaign_help_keywords"
+require_relative "pinnacle/campaigns/dlc/types/dlc_campaign_opt_in_keywords"
+require_relative "pinnacle/campaigns/dlc/types/dlc_campaign_opt_out_keywords"
+require_relative "pinnacle/campaigns/dlc/types/dlc_campaign_keywords"
+require_relative "pinnacle/campaigns/dlc/types/dlc_campaign_links"
+require_relative "pinnacle/campaigns/dlc/types/dlc_campaign_options"
+require_relative "pinnacle/types/sub_use_case_enum"
+require_relative "pinnacle/types/dlc_campaign_use_case_enum"
+require_relative "pinnacle/campaigns/dlc/types/dlc_campaign_use_case"
+require_relative "pinnacle/types/message_volume_enum"
+require_relative "pinnacle/types/opt_in_method_enum"
+require_relative "pinnacle/types/toll_free_campaign_use_case_enum"
+require_relative "pinnacle/types/toll_free_campaign_schema_keywords_help"
+require_relative "pinnacle/types/toll_free_campaign_schema_keywords_opt_in"
+require_relative "pinnacle/types/toll_free_campaign_schema_keywords"
+require_relative "pinnacle/types/toll_free_campaign_schema_links"
+require_relative "pinnacle/types/toll_free_campaign_schema_opt_in"
+require_relative "pinnacle/types/toll_free_campaign_schema_options"
+require_relative "pinnacle/types/toll_free_campaign_schema_use_case"
+require_relative "pinnacle/types/toll_free_campaign"
+require_relative "pinnacle/campaigns/toll_free/types/toll_free_autofill_response"
+require_relative "pinnacle/campaigns/toll_free/types/toll_free_campaign_help_keywords"
+require_relative "pinnacle/campaigns/toll_free/types/toll_free_campaign_opt_in_keywords"
+require_relative "pinnacle/campaigns/toll_free/types/toll_free_campaign_keywords"
+require_relative "pinnacle/campaigns/toll_free/types/toll_free_campaign_links"
+require_relative "pinnacle/campaigns/toll_free/types/toll_free_campaign_opt_in"
+require_relative "pinnacle/campaigns/toll_free/types/toll_free_campaign_options"
+require_relative "pinnacle/campaigns/toll_free/types/toll_free_campaign_use_case"
+require_relative "pinnacle/types/rcs_campaign_use_case_enum"
+require_relative "pinnacle/types/rcs_messaging_type_enum"
+require_relative "pinnacle/types/rcs_campaign_schema_agent_emails_item"
+require_relative "pinnacle/types/rcs_campaign_schema_agent_phones_item"
+require_relative "pinnacle/types/rcs_campaign_schema_agent_websites_item"
+require_relative "pinnacle/types/rcs_campaign_schema_agent"
+require_relative "pinnacle/types/rcs_campaign_schema_links"
+require_relative "pinnacle/types/rcs_campaign_schema_use_case"
+require_relative "pinnacle/types/rcs_campaign_schema_keywords_help"
+require_relative "pinnacle/types/rcs_campaign_schema_keywords_opt_in"
+require_relative "pinnacle/types/rcs_campaign_schema_keywords_opt_out"
+require_relative "pinnacle/types/rcs_campaign_schema_keywords"
+require_relative "pinnacle/types/rcs_campaign_schema_traffic"
+require_relative "pinnacle/types/rcs_campaign"
+require_relative "pinnacle/campaigns/rcs/types/rcs_autofill_response"
+require_relative "pinnacle/campaigns/rcs/types/rcs_agent_email"
+require_relative "pinnacle/campaigns/rcs/types/rcs_agent_phone"
+require_relative "pinnacle/campaigns/rcs/types/rcs_agent_website"
+require_relative "pinnacle/campaigns/rcs/types/rcs_agent"
+require_relative "pinnacle/campaigns/rcs/types/rcs_links"
+require_relative "pinnacle/campaigns/rcs/types/rcs_use_case"
+require_relative "pinnacle/campaigns/rcs/types/rcs_campaign_help_keywords"
+require_relative "pinnacle/campaigns/rcs/types/rcs_campaign_opt_in_keywords"
+require_relative "pinnacle/campaigns/rcs/types/rcs_campaign_opt_out_keywords"
+require_relative "pinnacle/campaigns/rcs/types/rcs_campaign_keywords"
+require_relative "pinnacle/campaigns/rcs/types/rcs_campaign_traffic"
+require_relative "pinnacle/types/message_schedule"
+require_relative "pinnacle/types/tracking"
+require_relative "pinnacle/messages/sms/types/send_sms_options"
+require_relative "pinnacle/types/send_sms_response_segments_encoding"
+require_relative "pinnacle/types/send_sms_response_segments"
+require_relative "pinnacle/types/sent_sms_details"
+require_relative "pinnacle/types/scheduled_send_response_config"
+require_relative "pinnacle/types/scheduled_message"
+require_relative "pinnacle/messages/sms/types/sms_send_response"
+require_relative "pinnacle/messages/mms/types/send_mms_options"
+require_relative "pinnacle/types/sent_mms_details"
+require_relative "pinnacle/messages/mms/types/mms_send_response"
+require_relative "pinnacle/types/sent_rich_message"
+require_relative "pinnacle/messages/rcs/types/send_rich_message_response"
+require_relative "pinnacle/messages/rcs/types/send_typing_indicator_schema_options"
+require_relative "pinnacle/messages/blast/types/blast_sms_options"
+require_relative "pinnacle/types/blast_details"
+require_relative "pinnacle/types/scheduled_blast_response_config"
+require_relative "pinnacle/types/scheduled_blast_details"
+require_relative "pinnacle/messages/blast/types/blast_sms_response"
+require_relative "pinnacle/messages/blast/types/blast_mms_options"
+require_relative "pinnacle/messages/blast/types/blast_mms_response"
+require_relative "pinnacle/messages/blast/types/blast_rcs_request_options_standalone_card_orientation"
+require_relative "pinnacle/messages/blast/types/blast_rcs_request_options_standalone_card_image_alignment"
+require_relative "pinnacle/messages/blast/types/blast_rcs_request_options_standalone_card"
+require_relative "pinnacle/messages/blast/types/blast_rcs_options"
+require_relative "pinnacle/messages/blast/types/blast_rcs_response"
+require_relative "pinnacle/tools/file/types/download_options"
+require_relative "pinnacle/tools/file/types/upload_file_options"
+require_relative "pinnacle/tools/contact_card/types/get_v_card_schema_options"
+require_relative "pinnacle/types/zod_error"
+require_relative "pinnacle/types/error"
+require_relative "pinnacle/types/bad_request_error_body"
+require_relative "pinnacle/types/not_found_error_body"
+require_relative "pinnacle/types/optional_contacts"
+require_relative "pinnacle/types/company_sector_enum"
+require_relative "pinnacle/types/company_type_enum"
+require_relative "pinnacle/types/company_entity_type_enum"
+require_relative "pinnacle/types/optional_brand_info"
+require_relative "pinnacle/types/brand_status_enum"
+require_relative "pinnacle/types/extended_brand"
+require_relative "pinnacle/types/vetting_feedback"
+require_relative "pinnacle/types/vetting_history_vetting_status"
+require_relative "pinnacle/types/vetting_history"
+require_relative "pinnacle/types/extended_brand_with_vetting"
+require_relative "pinnacle/types/submission_results"
+require_relative "pinnacle/types/validation_error_details"
+require_relative "pinnacle/types/validation_results"
+require_relative "pinnacle/types/vetting_results"
+require_relative "pinnacle/types/autofill_campaign_params"
+require_relative "pinnacle/types/autofill_dlc_response_keywords_help"
+require_relative "pinnacle/types/autofill_dlc_response_keywords_opt_in"
+require_relative "pinnacle/types/autofill_dlc_response_keywords_opt_out"
+require_relative "pinnacle/types/autofill_dlc_response_keywords"
+require_relative "pinnacle/types/autofill_dlc_response_links"
+require_relative "pinnacle/types/autofill_dlc_response_options"
+require_relative "pinnacle/types/autofill_dlc_response_use_case"
+require_relative "pinnacle/types/autofill_dlc_campaign_response"
+require_relative "pinnacle/types/profile_status_enum"
+require_relative "pinnacle/types/dlc_with_extended_brand_and_status_keywords_help"
+require_relative "pinnacle/types/dlc_with_extended_brand_and_status_keywords_opt_in"
+require_relative "pinnacle/types/dlc_with_extended_brand_and_status_keywords_opt_out"
+require_relative "pinnacle/types/dlc_with_extended_brand_and_status_keywords"
+require_relative "pinnacle/types/dlc_with_extended_brand_and_status_links"
+require_relative "pinnacle/types/dlc_with_extended_brand_and_status_options"
+require_relative "pinnacle/types/dlc_with_extended_brand_and_status_use_case"
+require_relative "pinnacle/types/dlc_with_extended_brand_and_status_mno_brand_tier"
+require_relative "pinnacle/types/dlc_with_extended_brand_and_status_mno_tcr_tier"
+require_relative "pinnacle/types/dlc_campaign_with_extended_brand_and_status"
+require_relative "pinnacle/types/campaign_submission_result"
+require_relative "pinnacle/types/validate_campaign_params"
+require_relative "pinnacle/types/campaign_validation_response_errors_item"
+require_relative "pinnacle/types/campaign_validation_result"
+require_relative "pinnacle/types/toll_free_with_extended_brand_and_status_keywords_help"
+require_relative "pinnacle/types/toll_free_with_extended_brand_and_status_keywords_opt_in"
+require_relative "pinnacle/types/toll_free_with_extended_brand_and_status_keywords"
+require_relative "pinnacle/types/toll_free_with_extended_brand_and_status_links"
+require_relative "pinnacle/types/toll_free_with_extended_brand_and_status_opt_in"
+require_relative "pinnacle/types/toll_free_with_extended_brand_and_status_options"
+require_relative "pinnacle/types/toll_free_with_extended_brand_and_status_use_case"
+require_relative "pinnacle/types/toll_free_campaign_with_extended_brand_and_status"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_agent_emails_item"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_agent_phones_item"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_agent_websites_item"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_agent"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_links"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_use_case"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_keywords_help"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_keywords_opt_in"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_keywords_opt_out"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_keywords"
+require_relative "pinnacle/types/rcs_campaign_schema_extra_traffic"
+require_relative "pinnacle/types/extended_rcs_campaign"
+require_relative "pinnacle/types/delete_audience_response"
+require_relative "pinnacle/types/optional_contact"
+require_relative "pinnacle/types/updated_contact_id"
+require_relative "pinnacle/types/contact_id"
+require_relative "pinnacle/types/conversation_by_id_params"
+require_relative "pinnacle/types/conversation_by_participants_params"
+require_relative "pinnacle/types/get_conversation_params"
+require_relative "pinnacle/types/campaign_enum"
+require_relative "pinnacle/types/campaign_query"
+require_relative "pinnacle/types/phone_capabilities"
+require_relative "pinnacle/types/conversation_contact"
+require_relative "pinnacle/types/phone"
+require_relative "pinnacle/types/agent"
+require_relative "pinnacle/types/conversation_sender"
+require_relative "pinnacle/types/conversation"
+require_relative "pinnacle/types/sender"
+require_relative "pinnacle/types/conversation_list"
+require_relative "pinnacle/types/successful_conversation_update"
+require_relative "pinnacle/types/sms_content"
+require_relative "pinnacle/types/mms_content"
+require_relative "pinnacle/types/rcs_button_open_url_webview_mode"
+require_relative "pinnacle/types/rcs_button_open_url"
+require_relative "pinnacle/types/rcs_button_call"
+require_relative "pinnacle/types/rcs_button_trigger"
+require_relative "pinnacle/types/rcs_button_request_user_location"
+require_relative "pinnacle/types/rcs_button_schedule_event"
+require_relative "pinnacle/types/rcs_button_send_location_lat_long"
+require_relative "pinnacle/types/rcs_button_send_location"
+require_relative "pinnacle/types/rich_button"
+require_relative "pinnacle/types/rich_text"
+require_relative "pinnacle/types/rcs_media_details_content"
+require_relative "pinnacle/types/rcs_media_content"
+require_relative "pinnacle/types/rcs_cards_content_cards_item"
+require_relative "pinnacle/types/rcs_cards_content"
+require_relative "pinnacle/types/rcs_content"
+require_relative "pinnacle/types/button_clicked_data_button_type"
+require_relative "pinnacle/types/button_clicked_data_button_raw"
+require_relative "pinnacle/types/button_clicked_data_button"
+require_relative "pinnacle/types/button_clicked_data"
+require_relative "pinnacle/types/location_share_action_data"
+require_relative "pinnacle/types/location_share_action"
+require_relative "pinnacle/types/button_clicked"
+require_relative "pinnacle/types/message_content"
+require_relative "pinnacle/types/fallback_message"
+require_relative "pinnacle/types/message_method_enum"
+require_relative "pinnacle/types/message_status_enum"
+require_relative "pinnacle/types/message_protocol_enum"
+require_relative "pinnacle/types/message"
+require_relative "pinnacle/types/message_with_reaction_direction"
+require_relative "pinnacle/types/message_with_reaction"
+require_relative "pinnacle/types/message_list"
+require_relative "pinnacle/types/reaction_result"
+require_relative "pinnacle/types/send_rich_message_options"
+require_relative "pinnacle/types/base_rich_message"
+require_relative "pinnacle/types/rich_text_message"
+require_relative "pinnacle/types/rich_media_message"
+require_relative "pinnacle/types/rich_card"
+require_relative "pinnacle/types/rich_cards"
+require_relative "pinnacle/types/send_rcs_card_options_standalone_card_orientation"
+require_relative "pinnacle/types/send_rcs_card_options_standalone_card_image_alignment"
+require_relative "pinnacle/types/rich_standalone_card_options"
+require_relative "pinnacle/types/send_rich_cards_options"
+require_relative "pinnacle/types/rich_cards_message"
+require_relative "pinnacle/types/rich_message"
+require_relative "pinnacle/types/send_typing_indicator_response"
+require_relative "pinnacle/types/sms_validation_response_segments_gsm_7"
+require_relative "pinnacle/types/sms_validation_response_segments_utf_16"
+require_relative "pinnacle/types/sms_validation_response_segments"
+require_relative "pinnacle/types/sms_validation_response_total"
+require_relative "pinnacle/types/sms_validation_result"
+require_relative "pinnacle/types/mms_validation_response_segments_value_item"
+require_relative "pinnacle/types/mms_validation_response_segments"
+require_relative "pinnacle/types/mms_validation_result"
+require_relative "pinnacle/types/rcs_validate_content_media"
+require_relative "pinnacle/types/rcs_validate_content"
+require_relative "pinnacle/types/rcs_validation_result"
+require_relative "pinnacle/types/schedule_cancel_result"
+require_relative "pinnacle/types/phone_feature_enum"
+require_relative "pinnacle/types/phone_enum"
+require_relative "pinnacle/types/phone_number_cost"
+require_relative "pinnacle/types/phone_number_region"
+require_relative "pinnacle/types/phone_number_details"
+require_relative "pinnacle/types/buy_response_capabilities"
+require_relative "pinnacle/types/purchased_number"
+require_relative "pinnacle/types/webhook_event_enum"
+require_relative "pinnacle/types/attach_webhook_by_id_params"
+require_relative "pinnacle/types/create_and_attach_webhook_by_url_params"
+require_relative "pinnacle/types/attach_webhook_params"
+require_relative "pinnacle/types/attach_webhook_response_webhook"
+require_relative "pinnacle/types/configured_webhook"
+require_relative "pinnacle/types/detached_webhook_info"
+require_relative "pinnacle/types/messaging_profile_enum"
+require_relative "pinnacle/types/phone_number_campaign_attach_phone_numbers_item_campaign"
+require_relative "pinnacle/types/phone_number_campaign_attach_phone_numbers_item"
+require_relative "pinnacle/types/phone_number_campaign_attach_failed_item"
+require_relative "pinnacle/types/attached_phone_number_result"
+require_relative "pinnacle/types/phone_number_campaign_detach_phone_numbers_item_campaign"
+require_relative "pinnacle/types/phone_number_campaign_detach_phone_numbers_item"
+require_relative "pinnacle/types/phone_number_campaign_detach_failed_item"
+require_relative "pinnacle/types/detached_phone_number_result"
+require_relative "pinnacle/types/rcs_capability_cards"
+require_relative "pinnacle/types/rcs_capability_actions"
+require_relative "pinnacle/types/rcs_capability"
+require_relative "pinnacle/types/rcs_capabilities_result"
+require_relative "pinnacle/types/rcs_whitelist_response"
+require_relative "pinnacle/types/rcs_link_result"
+require_relative "pinnacle/types/brand_status"
+require_relative "pinnacle/types/toll_free_status_enum"
+require_relative "pinnacle/types/get_toll_free_campaign_status_response_updates"
+require_relative "pinnacle/types/toll_free_campaign_status"
+require_relative "pinnacle/types/dlc_assignment_status_enum"
+require_relative "pinnacle/types/get_dlc_campaign_status_response_updates"
+require_relative "pinnacle/types/dlc_campaign_status"
+require_relative "pinnacle/types/rcs_campaign_status"
+require_relative "pinnacle/types/phone_number_status_enum"
+require_relative "pinnacle/types/phone_number_status"
+require_relative "pinnacle/types/create_url_options"
+require_relative "pinnacle/types/pinnacle_url_config"
+require_relative "pinnacle/types/shortened_url"
+require_relative "pinnacle/types/link_click_event"
+require_relative "pinnacle/types/shortened_url_with_click_data"
+require_relative "pinnacle/types/pinnacle_file_upload_metadata"
+require_relative "pinnacle/types/upload_results"
+require_relative "pinnacle/types/refreshed_file"
+require_relative "pinnacle/types/v_card_address_schema_type_item"
+require_relative "pinnacle/types/vcard_address"
+require_relative "pinnacle/types/v_card_phone_schema_type_item"
+require_relative "pinnacle/types/vcard_phone"
+require_relative "pinnacle/types/v_card_email_schema_type_item"
+require_relative "pinnacle/types/vcard_email"
+require_relative "pinnacle/types/v_card_name"
+require_relative "pinnacle/types/v_card_geo"
+require_relative "pinnacle/types/v_card_organization"
+require_relative "pinnacle/types/vcard"
+require_relative "pinnacle/types/vcard_content"
+require_relative "pinnacle/types/v_card_data_file_metadata"
+require_relative "pinnacle/types/v_card_data_file"
+require_relative "pinnacle/types/v_card_data"
+require_relative "pinnacle/types/vcard_resource"
+require_relative "pinnacle/types/webhooks"
+require_relative "pinnacle/types/webhook_result"
+require_relative "pinnacle/types/message_event_sms_content"
+require_relative "pinnacle/types/message_event_mms_content"
+require_relative "pinnacle/types/message_event_rcs_text_content"
+require_relative "pinnacle/types/message_event_rcs_media_content"
+require_relative "pinnacle/types/message_event_rcs_cards_content_cards_item"
+require_relative "pinnacle/types/message_event_rcs_cards_content"
+require_relative "pinnacle/types/message_event_rcs_button_data_button_type"
+require_relative "pinnacle/types/message_event_rcs_button_data_button_raw"
+require_relative "pinnacle/types/message_event_rcs_button_data_button"
+require_relative "pinnacle/types/message_event_rcs_button_data"
+require_relative "pinnacle/types/message_event_rcs_location_data_data"
+require_relative "pinnacle/types/message_event_rcs_location_data"
+require_relative "pinnacle/types/message_event_content"
+require_relative "pinnacle/types/message_event_conversation"
+require_relative "pinnacle/types/message_event_direction"
+require_relative "pinnacle/types/message_event_fallback_message_type"
+require_relative "pinnacle/types/message_event_fallback_message"
+require_relative "pinnacle/types/message_event"
+require_relative "pinnacle/types/user_event_conversation"
+require_relative "pinnacle/types/user_event"
+require_relative "pinnacle/client"
+require_relative "pinnacle/brands/client"
+require_relative "pinnacle/brands/types/autofill_brand_params"
+require_relative "pinnacle/brands/types/upsert_brand_params"
+require_relative "pinnacle/brands/types/brands_get_request"
+require_relative "pinnacle/brands/types/vet_brand_params"
+require_relative "pinnacle/audiences/client"
+require_relative "pinnacle/audiences/types/audiences_get_request"
+require_relative "pinnacle/audiences/types/create_audience_params"
+require_relative "pinnacle/audiences/types/audiences_delete_request"
+require_relative "pinnacle/audiences/types/update_audience_params"
+require_relative "pinnacle/contacts/client"
+require_relative "pinnacle/contacts/types/contacts_get_request"
+require_relative "pinnacle/contacts/types/create_contact_params"
+require_relative "pinnacle/contacts/types/update_contact_params"
+require_relative "pinnacle/conversations/client"
+require_relative "pinnacle/conversations/types/list_conversations_params"
+require_relative "pinnacle/conversations/types/update_conversation_params"
+require_relative "pinnacle/conversations/types/conversations_list_messages_request"
+require_relative "pinnacle/messages/client"
+require_relative "pinnacle/messages/types/react_message_params"
+require_relative "pinnacle/phone_numbers/client"
+require_relative "pinnacle/phone_numbers/types/search_phone_number_params"
+require_relative "pinnacle/phone_numbers/types/buy_phone_number_params"
+require_relative "pinnacle/phone_numbers/types/retrieve_phone_number_details_params"
+require_relative "pinnacle/rcs/client"
+require_relative "pinnacle/rcs/types/rcs_capabilities_query"
+require_relative "pinnacle/rcs/types/rcs_whitelist_request"
+require_relative "pinnacle/rcs/types/rcs_link_request"
+require_relative "pinnacle/webhooks/client"
+require_relative "pinnacle/webhooks/types/get_webhook_params"
+require_relative "pinnacle/audiences/contacts/client"
+require_relative "pinnacle/audiences/contacts/types/remove_contacts_params"
+require_relative "pinnacle/audiences/contacts/types/add_contacts_params"
+require_relative "pinnacle/campaigns/client"
+require_relative "pinnacle/campaigns/dlc/client"
+require_relative "pinnacle/campaigns/dlc/types/upsert_dlc_campaign_params"
+require_relative "pinnacle/campaigns/toll_free/client"
+require_relative "pinnacle/campaigns/toll_free/types/upsert_toll_free_campaign_params"
+require_relative "pinnacle/campaigns/rcs/client"
+require_relative "pinnacle/campaigns/rcs/types/upsert_rcs_campaign_params"
+require_relative "pinnacle/messages/sms/client"
+require_relative "pinnacle/messages/sms/types/sms"
+require_relative "pinnacle/messages/mms/client"
+require_relative "pinnacle/messages/mms/types/mms"
+require_relative "pinnacle/messages/rcs/client"
+require_relative "pinnacle/messages/rcs/types/send_typing_indicator_schema"
+require_relative "pinnacle/messages/blast/client"
+require_relative "pinnacle/messages/blast/types/blast_sms"
+require_relative "pinnacle/messages/blast/types/blast_mms"
+require_relative "pinnacle/messages/blast/types/blast_rcs"
+require_relative "pinnacle/messages/schedule/client"
+require_relative "pinnacle/phone_numbers/webhook/client"
+require_relative "pinnacle/phone_numbers/campaign/client"
+require_relative "pinnacle/phone_numbers/campaign/types/attach_campaign_params"
+require_relative "pinnacle/phone_numbers/campaign/types/detach_campaign_params"
+require_relative "pinnacle/status/client"
+require_relative "pinnacle/status/get/client"
+require_relative "pinnacle/tools/client"
+require_relative "pinnacle/tools/url/client"
+require_relative "pinnacle/tools/url/types/create_url_params"
+require_relative "pinnacle/tools/url/types/update_url_params"
+require_relative "pinnacle/tools/file/client"
+require_relative "pinnacle/tools/file/types/upload_file_params"
+require_relative "pinnacle/tools/file/types/refresh_file_params"
+require_relative "pinnacle/tools/contact_card/client"
+require_relative "pinnacle/tools/contact_card/types/get_vcard_params"
+require_relative "pinnacle/tools/contact_card/types/upsert_vcard_params"
+require_relative "pinnacle/environment"

data/reference.md

@@ -4604,6 +4604,10 @@ client.messages.blast.rcs(
     quick_replies: [],
     text: 'Hello from Pinnacle RCS!'
   },
+  fallback: {
+    from: '+14155164736',
+    text: 'Hello from Pinnacle! Reply LEARN to learn more.'
+  },
   options: {
     transcode: true,
     validate: true
@@ -4659,6 +4663,14 @@ Messages will be evenly distributed across these agents.
 <dl>
 <dd>
 
+**fallback:** `Pinnacle::Types::FallbackMessage` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **options:** `Pinnacle::Messages::Blast::Types::BlastRcsOptions` — Configure how your RCS blast is sent and tracked.
     
 </dd>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rcs
 version: !ruby/object:Gem::Version
-  version: 2.0.11
+  version: 2.0.13
 platform: ruby
 authors:
 - Pinnacle
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-28 00:00:00.000000000 Z
+date: 2026-02-01 00:00:00.000000000 Z
 dependencies: []
 description: The Pinnacle Ruby library provides convenient access to the Pinnacle
   API from Ruby.
@@ -23,6 +23,7 @@ files:
 - README.md
 - Rakefile
 - custom.gemspec.rb
+- lib/pinnacle.rb
 - lib/pinnacle/audiences/client.rb
 - lib/pinnacle/audiences/contacts/client.rb
 - lib/pinnacle/audiences/contacts/types/add_contacts_params.rb
@@ -266,6 +267,7 @@ files:
 - lib/pinnacle/types/extended_brand.rb
 - lib/pinnacle/types/extended_brand_with_vetting.rb
 - lib/pinnacle/types/extended_rcs_campaign.rb
+- lib/pinnacle/types/fallback_message.rb
 - lib/pinnacle/types/get_conversation_params.rb
 - lib/pinnacle/types/get_dlc_campaign_status_response_updates.rb
 - lib/pinnacle/types/get_toll_free_campaign_status_response_updates.rb
@@ -278,11 +280,17 @@ files:
 - lib/pinnacle/types/message_event_content.rb
 - lib/pinnacle/types/message_event_conversation.rb
 - lib/pinnacle/types/message_event_direction.rb
+- lib/pinnacle/types/message_event_fallback_message.rb
+- lib/pinnacle/types/message_event_fallback_message_type.rb
 - lib/pinnacle/types/message_event_mms_content.rb
 - lib/pinnacle/types/message_event_rcs_button_data.rb
+- lib/pinnacle/types/message_event_rcs_button_data_button.rb
+- lib/pinnacle/types/message_event_rcs_button_data_button_raw.rb
+- lib/pinnacle/types/message_event_rcs_button_data_button_type.rb
 - lib/pinnacle/types/message_event_rcs_cards_content.rb
 - lib/pinnacle/types/message_event_rcs_cards_content_cards_item.rb
 - lib/pinnacle/types/message_event_rcs_location_data.rb
+- lib/pinnacle/types/message_event_rcs_location_data_data.rb
 - lib/pinnacle/types/message_event_rcs_media_content.rb
 - lib/pinnacle/types/message_event_rcs_text_content.rb
 - lib/pinnacle/types/message_event_sms_content.rb