twilio-ruby 5.47.0 → 5.74.0

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

@@ -0,0 +1,257 @@
+##
+# 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 DomainCertsList < ListResource
+          ##
+          # Initialize the DomainCertsList
+          # @param [Version] version Version that contains the resource
+          # @return [DomainCertsList] DomainCertsList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Messaging.V1.DomainCertsList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class DomainCertsPage < Page
+          ##
+          # Initialize the DomainCertsPage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [DomainCertsPage] DomainCertsPage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of DomainCertsInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [DomainCertsInstance] DomainCertsInstance
+          def get_instance(payload)
+            DomainCertsInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Messaging.V1.DomainCertsPage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class DomainCertsContext < InstanceContext
+          ##
+          # Initialize the DomainCertsContext
+          # @param [Version] version Version that contains the resource
+          # @param [String] domain_sid Unique string used to identify the domain that this
+          #   certificate should be associated with.
+          # @return [DomainCertsContext] DomainCertsContext
+          def initialize(version, domain_sid)
+            super(version)
+
+            # Path Solution
+            @solution = {domain_sid: domain_sid, }
+            @uri = "/LinkShortening/Domains/#{@solution[:domain_sid]}/Certificate"
+          end
+
+          ##
+          # Update the DomainCertsInstance
+          # @param [String] tls_cert Contains the full TLS certificate and private for this
+          #   domain in PEM format: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail.
+          #   Twilio uses this information to process HTTPS traffic sent to your domain.
+          # @return [DomainCertsInstance] Updated DomainCertsInstance
+          def update(tls_cert: nil)
+            data = Twilio::Values.of({'TlsCert' => tls_cert, })
+
+            payload = @version.update('POST', @uri, data: data)
+
+            DomainCertsInstance.new(@version, payload, domain_sid: @solution[:domain_sid], )
+          end
+
+          ##
+          # Fetch the DomainCertsInstance
+          # @return [DomainCertsInstance] Fetched DomainCertsInstance
+          def fetch
+            payload = @version.fetch('GET', @uri)
+
+            DomainCertsInstance.new(@version, payload, domain_sid: @solution[:domain_sid], )
+          end
+
+          ##
+          # Delete the DomainCertsInstance
+          # @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.DomainCertsContext #{context}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Messaging.V1.DomainCertsContext #{context}>"
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class DomainCertsInstance < InstanceResource
+          ##
+          # Initialize the DomainCertsInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @param [String] domain_sid Unique string used to identify the domain that this
+          #   certificate should be associated with.
+          # @return [DomainCertsInstance] DomainCertsInstance
+          def initialize(version, payload, domain_sid: nil)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'domain_sid' => payload['domain_sid'],
+                'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
+                'date_expires' => Twilio.deserialize_iso8601_datetime(payload['date_expires']),
+                'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+                'domain_name' => payload['domain_name'],
+                'certificate_sid' => payload['certificate_sid'],
+                'url' => payload['url'],
+                'validated' => payload['validated'],
+            }
+
+            # Context
+            @instance_context = nil
+            @params = {'domain_sid' => domain_sid || @properties['domain_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 [DomainCertsContext] DomainCertsContext for this DomainCertsInstance
+          def context
+            unless @instance_context
+              @instance_context = DomainCertsContext.new(@version, @params['domain_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 [Time] Date that this Domain was last updated.
+          def date_updated
+            @properties['date_updated']
+          end
+
+          ##
+          # @return [Time] Expiration date for your private certificate.
+          def date_expires
+            @properties['date_expires']
+          end
+
+          ##
+          # @return [Time] Date this Domain SID was created.
+          def date_created
+            @properties['date_created']
+          end
+
+          ##
+          # @return [String] Full url path for this domain.
+          def domain_name
+            @properties['domain_name']
+          end
+
+          ##
+          # @return [String] The unique string that we created to identify this Certificate resource.
+          def certificate_sid
+            @properties['certificate_sid']
+          end
+
+          ##
+          # @return [String] The url
+          def url
+            @properties['url']
+          end
+
+          ##
+          # @return [Boolean] Certificate validation field
+          def validated
+            @properties['validated']
+          end
+
+          ##
+          # Update the DomainCertsInstance
+          # @param [String] tls_cert Contains the full TLS certificate and private for this
+          #   domain in PEM format: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail.
+          #   Twilio uses this information to process HTTPS traffic sent to your domain.
+          # @return [DomainCertsInstance] Updated DomainCertsInstance
+          def update(tls_cert: nil)
+            context.update(tls_cert: tls_cert, )
+          end
+
+          ##
+          # Fetch the DomainCertsInstance
+          # @return [DomainCertsInstance] Fetched DomainCertsInstance
+          def fetch
+            context.fetch
+          end
+
+          ##
+          # Delete the DomainCertsInstance
+          # @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.DomainCertsInstance #{values}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Messaging.V1.DomainCertsInstance #{values}>"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,267 @@
+##
+# 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 DomainConfigList < ListResource
+          ##
+          # Initialize the DomainConfigList
+          # @param [Version] version Version that contains the resource
+          # @return [DomainConfigList] DomainConfigList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Messaging.V1.DomainConfigList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class DomainConfigPage < Page
+          ##
+          # Initialize the DomainConfigPage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [DomainConfigPage] DomainConfigPage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of DomainConfigInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [DomainConfigInstance] DomainConfigInstance
+          def get_instance(payload)
+            DomainConfigInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Messaging.V1.DomainConfigPage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class DomainConfigContext < InstanceContext
+          ##
+          # Initialize the DomainConfigContext
+          # @param [Version] version Version that contains the resource
+          # @param [String] domain_sid Unique string used to identify the domain that this
+          #   config should be associated with.
+          # @return [DomainConfigContext] DomainConfigContext
+          def initialize(version, domain_sid)
+            super(version)
+
+            # Path Solution
+            @solution = {domain_sid: domain_sid, }
+            @uri = "/LinkShortening/Domains/#{@solution[:domain_sid]}/Config"
+          end
+
+          ##
+          # Update the DomainConfigInstance
+          # @param [Array[String]] messaging_service_sids A list of messagingServiceSids
+          #   (with prefix MG)
+          # @param [String] fallback_url Any requests we receive to this domain that do not
+          #   match an existing shortened message will be redirected to the fallback url.
+          #   These will likely be either expired messages, random misdirected traffic, or
+          #   intentional scraping.
+          # @param [String] callback_url URL to receive click events to your webhook
+          #   whenever the recipients click on the shortened links
+          # @param [String] messaging_service_sids_action An action type for
+          #   messaging_service_sids operation (ADD, DELETE, REPLACE)
+          # @return [DomainConfigInstance] Updated DomainConfigInstance
+          def update(messaging_service_sids: nil, fallback_url: :unset, callback_url: :unset, messaging_service_sids_action: :unset)
+            data = Twilio::Values.of({
+                'MessagingServiceSids' => Twilio.serialize_list(messaging_service_sids) { |e| e },
+                'FallbackUrl' => fallback_url,
+                'CallbackUrl' => callback_url,
+                'MessagingServiceSidsAction' => messaging_service_sids_action,
+            })
+
+            payload = @version.update('POST', @uri, data: data)
+
+            DomainConfigInstance.new(@version, payload, domain_sid: @solution[:domain_sid], )
+          end
+
+          ##
+          # Fetch the DomainConfigInstance
+          # @return [DomainConfigInstance] Fetched DomainConfigInstance
+          def fetch
+            payload = @version.fetch('GET', @uri)
+
+            DomainConfigInstance.new(@version, payload, domain_sid: @solution[:domain_sid], )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Messaging.V1.DomainConfigContext #{context}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Messaging.V1.DomainConfigContext #{context}>"
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class DomainConfigInstance < InstanceResource
+          ##
+          # Initialize the DomainConfigInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @param [String] domain_sid Unique string used to identify the domain that this
+          #   config should be associated with.
+          # @return [DomainConfigInstance] DomainConfigInstance
+          def initialize(version, payload, domain_sid: nil)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'domain_sid' => payload['domain_sid'],
+                'config_sid' => payload['config_sid'],
+                'messaging_service_sids' => payload['messaging_service_sids'],
+                '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 = {'domain_sid' => domain_sid || @properties['domain_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 [DomainConfigContext] DomainConfigContext for this DomainConfigInstance
+          def context
+            unless @instance_context
+              @instance_context = DomainConfigContext.new(@version, @params['domain_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 [Array[String]] A list of messagingServiceSids (with prefix MG).
+          def messaging_service_sids
+            @properties['messaging_service_sids']
+          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
+
+          ##
+          # Update the DomainConfigInstance
+          # @param [Array[String]] messaging_service_sids A list of messagingServiceSids
+          #   (with prefix MG)
+          # @param [String] fallback_url Any requests we receive to this domain that do not
+          #   match an existing shortened message will be redirected to the fallback url.
+          #   These will likely be either expired messages, random misdirected traffic, or
+          #   intentional scraping.
+          # @param [String] callback_url URL to receive click events to your webhook
+          #   whenever the recipients click on the shortened links
+          # @param [String] messaging_service_sids_action An action type for
+          #   messaging_service_sids operation (ADD, DELETE, REPLACE)
+          # @return [DomainConfigInstance] Updated DomainConfigInstance
+          def update(messaging_service_sids: nil, fallback_url: :unset, callback_url: :unset, messaging_service_sids_action: :unset)
+            context.update(
+                messaging_service_sids: messaging_service_sids,
+                fallback_url: fallback_url,
+                callback_url: callback_url,
+                messaging_service_sids_action: messaging_service_sids_action,
+            )
+          end
+
+          ##
+          # Fetch the DomainConfigInstance
+          # @return [DomainConfigInstance] Fetched DomainConfigInstance
+          def fetch
+            context.fetch
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Messaging.V1.DomainConfigInstance #{values}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Messaging.V1.DomainConfigInstance #{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/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, })