twilio-ruby 5.46.1 → 5.77.0

data/lib/twilio-ruby/rest/messaging/v1/domain_config_messaging_service.rb

@@ -0,0 +1,226 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Messaging < Domain
+      class V1 < Version
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class DomainConfigMessagingServiceList < ListResource
+          ##
+          # Initialize the DomainConfigMessagingServiceList
+          # @param [Version] version Version that contains the resource
+          # @return [DomainConfigMessagingServiceList] DomainConfigMessagingServiceList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Messaging.V1.DomainConfigMessagingServiceList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class DomainConfigMessagingServicePage < Page
+          ##
+          # Initialize the DomainConfigMessagingServicePage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [DomainConfigMessagingServicePage] DomainConfigMessagingServicePage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of DomainConfigMessagingServiceInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [DomainConfigMessagingServiceInstance] DomainConfigMessagingServiceInstance
+          def get_instance(payload)
+            DomainConfigMessagingServiceInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Messaging.V1.DomainConfigMessagingServicePage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class DomainConfigMessagingServiceContext < InstanceContext
+          ##
+          # Initialize the DomainConfigMessagingServiceContext
+          # @param [Version] version Version that contains the resource
+          # @param [String] messaging_service_sid Unique string used to identify the
+          #   Messaging service that this domain should be associated with.
+          # @return [DomainConfigMessagingServiceContext] DomainConfigMessagingServiceContext
+          def initialize(version, messaging_service_sid)
+            super(version)
+
+            # Path Solution
+            @solution = {messaging_service_sid: messaging_service_sid, }
+            @uri = "/LinkShortening/MessagingService/#{@solution[:messaging_service_sid]}/DomainConfig"
+          end
+
+          ##
+          # Fetch the DomainConfigMessagingServiceInstance
+          # @return [DomainConfigMessagingServiceInstance] Fetched DomainConfigMessagingServiceInstance
+          def fetch
+            payload = @version.fetch('GET', @uri)
+
+            DomainConfigMessagingServiceInstance.new(
+                @version,
+                payload,
+                messaging_service_sid: @solution[:messaging_service_sid],
+            )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Messaging.V1.DomainConfigMessagingServiceContext #{context}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Messaging.V1.DomainConfigMessagingServiceContext #{context}>"
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class DomainConfigMessagingServiceInstance < InstanceResource
+          ##
+          # Initialize the DomainConfigMessagingServiceInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @param [String] messaging_service_sid Unique string used to identify the
+          #   Messaging service that this domain should be associated with.
+          # @return [DomainConfigMessagingServiceInstance] DomainConfigMessagingServiceInstance
+          def initialize(version, payload, messaging_service_sid: nil)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'domain_sid' => payload['domain_sid'],
+                'config_sid' => payload['config_sid'],
+                'messaging_service_sid' => payload['messaging_service_sid'],
+                'fallback_url' => payload['fallback_url'],
+                'callback_url' => payload['callback_url'],
+                'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+                'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
+                'url' => payload['url'],
+            }
+
+            # Context
+            @instance_context = nil
+            @params = {'messaging_service_sid' => messaging_service_sid || @properties['messaging_service_sid'], }
+          end
+
+          ##
+          # Generate an instance context for the instance, the context is capable of
+          # performing various actions.  All instance actions are proxied to the context
+          # @return [DomainConfigMessagingServiceContext] DomainConfigMessagingServiceContext for this DomainConfigMessagingServiceInstance
+          def context
+            unless @instance_context
+              @instance_context = DomainConfigMessagingServiceContext.new(
+                  @version,
+                  @params['messaging_service_sid'],
+              )
+            end
+            @instance_context
+          end
+
+          ##
+          # @return [String] The unique string that we created to identify the Domain resource.
+          def domain_sid
+            @properties['domain_sid']
+          end
+
+          ##
+          # @return [String] The unique string that we created to identify the Domain config (prefix ZK).
+          def config_sid
+            @properties['config_sid']
+          end
+
+          ##
+          # @return [String] The unique string that identifies the messaging service
+          def messaging_service_sid
+            @properties['messaging_service_sid']
+          end
+
+          ##
+          # @return [String] We will redirect requests to urls we are unable to identify to this url.
+          def fallback_url
+            @properties['fallback_url']
+          end
+
+          ##
+          # @return [String] URL to receive click events to your webhook whenever the recipients click on the shortened links.
+          def callback_url
+            @properties['callback_url']
+          end
+
+          ##
+          # @return [Time] Date this Domain Config was created.
+          def date_created
+            @properties['date_created']
+          end
+
+          ##
+          # @return [Time] Date that this Domain Config was last updated.
+          def date_updated
+            @properties['date_updated']
+          end
+
+          ##
+          # @return [String] The url
+          def url
+            @properties['url']
+          end
+
+          ##
+          # Fetch the DomainConfigMessagingServiceInstance
+          # @return [DomainConfigMessagingServiceInstance] Fetched DomainConfigMessagingServiceInstance
+          def fetch
+            context.fetch
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Messaging.V1.DomainConfigMessagingServiceInstance #{values}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Messaging.V1.DomainConfigMessagingServiceInstance #{values}>"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/messaging/v1/external_campaign.rb

@@ -0,0 +1,150 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Messaging < Domain
+      class V1 < Version
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class ExternalCampaignList < ListResource
+          ##
+          # Initialize the ExternalCampaignList
+          # @param [Version] version Version that contains the resource
+          # @return [ExternalCampaignList] ExternalCampaignList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+            @uri = "/Services/PreregisteredUsa2p"
+          end
+
+          ##
+          # Create the ExternalCampaignInstance
+          # @param [String] campaign_id ID of the preregistered campaign.
+          # @param [String] messaging_service_sid The SID of the {Messaging
+          #   Service}[https://www.twilio.com/docs/messaging/services/api] that the resource
+          #   is associated with.
+          # @return [ExternalCampaignInstance] Created ExternalCampaignInstance
+          def create(campaign_id: nil, messaging_service_sid: nil)
+            data = Twilio::Values.of({
+                'CampaignId' => campaign_id,
+                'MessagingServiceSid' => messaging_service_sid,
+            })
+
+            payload = @version.create('POST', @uri, data: data)
+
+            ExternalCampaignInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Messaging.V1.ExternalCampaignList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class ExternalCampaignPage < Page
+          ##
+          # Initialize the ExternalCampaignPage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [ExternalCampaignPage] ExternalCampaignPage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of ExternalCampaignInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [ExternalCampaignInstance] ExternalCampaignInstance
+          def get_instance(payload)
+            ExternalCampaignInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Messaging.V1.ExternalCampaignPage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class ExternalCampaignInstance < InstanceResource
+          ##
+          # Initialize the ExternalCampaignInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @return [ExternalCampaignInstance] ExternalCampaignInstance
+          def initialize(version, payload)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'sid' => payload['sid'],
+                'account_sid' => payload['account_sid'],
+                'campaign_id' => payload['campaign_id'],
+                'messaging_service_sid' => payload['messaging_service_sid'],
+                'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+            }
+          end
+
+          ##
+          # @return [String] The unique string that identifies a US A2P Compliance resource
+          def sid
+            @properties['sid']
+          end
+
+          ##
+          # @return [String] The SID of the Account that created the resource
+          def account_sid
+            @properties['account_sid']
+          end
+
+          ##
+          # @return [String] ID of the preregistered campaign.
+          def campaign_id
+            @properties['campaign_id']
+          end
+
+          ##
+          # @return [String] The SID of the Messaging Service the resource is associated with
+          def messaging_service_sid
+            @properties['messaging_service_sid']
+          end
+
+          ##
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was created
+          def date_created
+            @properties['date_created']
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            "<Twilio.Messaging.V1.ExternalCampaignInstance>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            "<Twilio.Messaging.V1.ExternalCampaignInstance>"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/messaging/v1/linkshortening_messaging_service.rb

@@ -0,0 +1,218 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Messaging < Domain
+      class V1 < Version
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class LinkshorteningMessagingServiceList < ListResource
+          ##
+          # Initialize the LinkshorteningMessagingServiceList
+          # @param [Version] version Version that contains the resource
+          # @return [LinkshorteningMessagingServiceList] LinkshorteningMessagingServiceList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Messaging.V1.LinkshorteningMessagingServiceList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class LinkshorteningMessagingServicePage < Page
+          ##
+          # Initialize the LinkshorteningMessagingServicePage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [LinkshorteningMessagingServicePage] LinkshorteningMessagingServicePage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of LinkshorteningMessagingServiceInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [LinkshorteningMessagingServiceInstance] LinkshorteningMessagingServiceInstance
+          def get_instance(payload)
+            LinkshorteningMessagingServiceInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Messaging.V1.LinkshorteningMessagingServicePage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class LinkshorteningMessagingServiceContext < InstanceContext
+          ##
+          # Initialize the LinkshorteningMessagingServiceContext
+          # @param [Version] version Version that contains the resource
+          # @param [String] domain_sid The domain SID to dissociate from a messaging
+          #   service. With URL shortening enabled, links in messages sent with the associated
+          #   messaging service will be shortened to the provided domain
+          # @param [String] messaging_service_sid A messaging service SID to dissociate from
+          #   a domain. With URL shortening enabled, links in messages sent with the provided
+          #   messaging service will be shortened to the associated domain
+          # @return [LinkshorteningMessagingServiceContext] LinkshorteningMessagingServiceContext
+          def initialize(version, domain_sid, messaging_service_sid)
+            super(version)
+
+            # Path Solution
+            @solution = {domain_sid: domain_sid, messaging_service_sid: messaging_service_sid, }
+            @uri = "/LinkShortening/Domains/#{@solution[:domain_sid]}/MessagingServices/#{@solution[:messaging_service_sid]}"
+          end
+
+          ##
+          # Create the LinkshorteningMessagingServiceInstance
+          # @return [LinkshorteningMessagingServiceInstance] Created LinkshorteningMessagingServiceInstance
+          def create
+            payload = @version.create('POST', @uri)
+
+            LinkshorteningMessagingServiceInstance.new(
+                @version,
+                payload,
+                domain_sid: @solution[:domain_sid],
+                messaging_service_sid: @solution[:messaging_service_sid],
+            )
+          end
+
+          ##
+          # Delete the LinkshorteningMessagingServiceInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
+          def delete
+             @version.delete('DELETE', @uri)
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Messaging.V1.LinkshorteningMessagingServiceContext #{context}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Messaging.V1.LinkshorteningMessagingServiceContext #{context}>"
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class LinkshorteningMessagingServiceInstance < InstanceResource
+          ##
+          # Initialize the LinkshorteningMessagingServiceInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @param [String] domain_sid The domain SID to dissociate from a messaging
+          #   service. With URL shortening enabled, links in messages sent with the associated
+          #   messaging service will be shortened to the provided domain
+          # @param [String] messaging_service_sid A messaging service SID to dissociate from
+          #   a domain. With URL shortening enabled, links in messages sent with the provided
+          #   messaging service will be shortened to the associated domain
+          # @return [LinkshorteningMessagingServiceInstance] LinkshorteningMessagingServiceInstance
+          def initialize(version, payload, domain_sid: nil, messaging_service_sid: nil)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'domain_sid' => payload['domain_sid'],
+                'messaging_service_sid' => payload['messaging_service_sid'],
+                'url' => payload['url'],
+            }
+
+            # Context
+            @instance_context = nil
+            @params = {
+                'domain_sid' => domain_sid || @properties['domain_sid'],
+                'messaging_service_sid' => messaging_service_sid || @properties['messaging_service_sid'],
+            }
+          end
+
+          ##
+          # Generate an instance context for the instance, the context is capable of
+          # performing various actions.  All instance actions are proxied to the context
+          # @return [LinkshorteningMessagingServiceContext] LinkshorteningMessagingServiceContext for this LinkshorteningMessagingServiceInstance
+          def context
+            unless @instance_context
+              @instance_context = LinkshorteningMessagingServiceContext.new(
+                  @version,
+                  @params['domain_sid'],
+                  @params['messaging_service_sid'],
+              )
+            end
+            @instance_context
+          end
+
+          ##
+          # @return [String] The unique string that identifies the domain resource
+          def domain_sid
+            @properties['domain_sid']
+          end
+
+          ##
+          # @return [String] The unique string that identifies the messaging service
+          def messaging_service_sid
+            @properties['messaging_service_sid']
+          end
+
+          ##
+          # @return [String] The url
+          def url
+            @properties['url']
+          end
+
+          ##
+          # Create the LinkshorteningMessagingServiceInstance
+          # @return [LinkshorteningMessagingServiceInstance] Created LinkshorteningMessagingServiceInstance
+          def create
+            context.create
+          end
+
+          ##
+          # Delete the LinkshorteningMessagingServiceInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
+          def delete
+            context.delete
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Messaging.V1.LinkshorteningMessagingServiceInstance #{values}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Messaging.V1.LinkshorteningMessagingServiceInstance #{values}>"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/messaging/v1/service/alpha_sender.rb

@@ -32,8 +32,8 @@ module Twilio
             ##
             # Create the AlphaSenderInstance
             # @param [String] alpha_sender The Alphanumeric Sender ID string. Can be up to 11
-            #   characters long. Valid characters are A-Z, a-z, 0-9, space, and hyphen `-`. This
-            #   value cannot contain only numbers.
+            #   characters long. Valid characters are A-Z, a-z, 0-9, space, hyphen `-`, plus
+            #   `+`, underscore `_` and ampersand `&`. This value cannot contain only numbers.
             # @return [AlphaSenderInstance] Created AlphaSenderInstance
             def create(alpha_sender: nil)
               data = Twilio::Values.of({'AlphaSender' => alpha_sender, })