twilio-ruby 5.34.0 → 5.38.0

data/lib/twilio-ruby/rest/client.rb

@@ -11,14 +11,17 @@ module Twilio
     ##
     # A client for accessing the Twilio API.
     class Client
-      attr_accessor :http_client, :username, :password, :account_sid, :auth_token, :region
+      @@default_region = 'us1'
+
+      attr_accessor :http_client, :username, :password, :account_sid, :auth_token, :region, :edge
 
       ##
       # Initializes the Twilio Client
       def initialize(username=nil, password=nil, account_sid=nil, region=nil, http_client=nil)
         @username = username || Twilio.account_sid
         @password = password || Twilio.auth_token
-        @region = region
+        @region = region || Twilio.region
+        @edge = Twilio.edge
         @account_sid = account_sid || @username
         @auth_token = @password
         @auth = [@username, @password]
@@ -27,7 +30,6 @@ module Twilio
         # Domains
         @accounts = nil
         @api = nil
-        @authy = nil
         @autopilot = nil
         @chat = nil
         @conversations = nil
@@ -75,12 +77,7 @@ module Twilio
           headers['Accept'] = 'application/json'
         end
 
-        if !region.nil?
-            head, tail  = uri.split('.', 2)
-            if !tail.start_with?(region)
-                uri = [head, region, tail].join('.')
-            end
-        end
+        uri = build_uri(uri)
 
         @http_client.request(
           host,
@@ -95,6 +92,35 @@ module Twilio
         )
       end
 
+      ##
+      # Build the final request uri
+      def build_uri(uri)
+        if @region.nil? and @edge.nil?
+          return uri
+        end
+
+        parsed_url = URI(uri)
+        pieces = parsed_url.host.split('.')
+        product = pieces[0]
+        domain = pieces[-2, 2]
+        new_edge = @edge
+        new_region = @region
+
+        if pieces.length == 4
+          new_region ||= pieces[1]
+        elsif pieces.length == 5
+          new_edge ||= pieces[1]
+          new_region ||= pieces[2]
+        end
+
+        if !new_edge.nil? && new_region.nil?
+          new_region = @@default_region
+        end
+
+        parsed_url.host = [product, new_edge, new_region, domain].select {|item| !item.nil?}.join('.')
+        parsed_url.to_s
+      end
+
       ##
       # Validate the new SSL certificate for the Twilio API
       def validate_ssl_certificate
@@ -116,12 +142,6 @@ module Twilio
         @api ||= Api.new self
       end
 
-      ##
-      # Access the Authy Twilio Domain
-      def authy
-        @authy ||= Authy.new self
-      end
-
       ##
       # Access the Autopilot Twilio Domain
       def autopilot

data/lib/twilio-ruby/rest/conversations/v1/conversation.rb

@@ -41,8 +41,12 @@ module Twilio
           #   returned.
           # @param [conversation.State] state Current state of this conversation. Can be
           #   either `active`, `inactive` or `closed` and defaults to `active`
+          # @param [String] timers_inactive ISO8601 duration when conversation will be
+          #   switched to `inactive` state. Minimum value for this timer is 1 minute.
+          # @param [String] timers_closed ISO8601 duration when conversation will be
+          #   switched to `closed` state. Minimum value for this timer is 10 minutes.
           # @return [ConversationInstance] Newly created ConversationInstance
-          def create(friendly_name: :unset, date_created: :unset, date_updated: :unset, messaging_service_sid: :unset, attributes: :unset, state: :unset)
+          def create(friendly_name: :unset, date_created: :unset, date_updated: :unset, messaging_service_sid: :unset, attributes: :unset, state: :unset, timers_inactive: :unset, timers_closed: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'DateCreated' => Twilio.serialize_iso8601_datetime(date_created),
@@ -50,6 +54,8 @@ module Twilio
                 'MessagingServiceSid' => messaging_service_sid,
                 'Attributes' => attributes,
                 'State' => state,
+                'Timers.Inactive' => timers_inactive,
+                'Timers.Closed' => timers_closed,
             })
 
             payload = @version.create(
@@ -218,8 +224,12 @@ module Twilio
           #   to.
           # @param [conversation.State] state Current state of this conversation. Can be
           #   either `active`, `inactive` or `closed` and defaults to `active`
+          # @param [String] timers_inactive ISO8601 duration when conversation will be
+          #   switched to `inactive` state. Minimum value for this timer is 1 minute.
+          # @param [String] timers_closed ISO8601 duration when conversation will be
+          #   switched to `closed` state. Minimum value for this timer is 10 minutes.
           # @return [ConversationInstance] Updated ConversationInstance
-          def update(friendly_name: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, messaging_service_sid: :unset, state: :unset)
+          def update(friendly_name: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, messaging_service_sid: :unset, state: :unset, timers_inactive: :unset, timers_closed: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'DateCreated' => Twilio.serialize_iso8601_datetime(date_created),
@@ -227,6 +237,8 @@ module Twilio
                 'Attributes' => attributes,
                 'MessagingServiceSid' => messaging_service_sid,
                 'State' => state,
+                'Timers.Inactive' => timers_inactive,
+                'Timers.Closed' => timers_closed,
             })
 
             payload = @version.update(
@@ -353,6 +365,7 @@ module Twilio
                 'state' => payload['state'],
                 'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                 'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
+                'timers' => payload['timers'],
                 'url' => payload['url'],
                 'links' => payload['links'],
             }
@@ -427,6 +440,12 @@ module Twilio
             @properties['date_updated']
           end
 
+          ##
+          # @return [Hash] Timer date values for this conversation.
+          def timers
+            @properties['timers']
+          end
+
           ##
           # @return [String] An absolute URL for this conversation.
           def url
@@ -454,8 +473,12 @@ module Twilio
           #   to.
           # @param [conversation.State] state Current state of this conversation. Can be
           #   either `active`, `inactive` or `closed` and defaults to `active`
+          # @param [String] timers_inactive ISO8601 duration when conversation will be
+          #   switched to `inactive` state. Minimum value for this timer is 1 minute.
+          # @param [String] timers_closed ISO8601 duration when conversation will be
+          #   switched to `closed` state. Minimum value for this timer is 10 minutes.
           # @return [ConversationInstance] Updated ConversationInstance
-          def update(friendly_name: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, messaging_service_sid: :unset, state: :unset)
+          def update(friendly_name: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, messaging_service_sid: :unset, state: :unset, timers_inactive: :unset, timers_closed: :unset)
             context.update(
                 friendly_name: friendly_name,
                 date_created: date_created,
@@ -463,6 +486,8 @@ module Twilio
                 attributes: attributes,
                 messaging_service_sid: messaging_service_sid,
                 state: state,
+                timers_inactive: timers_inactive,
+                timers_closed: timers_closed,
             )
           end
 

data/lib/twilio-ruby/rest/conversations/v1/conversation/participant.rb

@@ -53,8 +53,11 @@ module Twilio
             # @param [String] messaging_binding_projected_address The address of the Twilio
             #   phone number that is used in Group MMS. Communication mask for the Chat
             #   participant with Identity.
+            # @param [String] role_sid The SID of the
+            #   [Role](https://www.twilio.com/docs/chat/rest/role-resource) to assign to the
+            #   participant.
             # @return [ParticipantInstance] Newly created ParticipantInstance
-            def create(identity: :unset, messaging_binding_address: :unset, messaging_binding_proxy_address: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, messaging_binding_projected_address: :unset)
+            def create(identity: :unset, messaging_binding_address: :unset, messaging_binding_proxy_address: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, messaging_binding_projected_address: :unset, role_sid: :unset)
               data = Twilio::Values.of({
                   'Identity' => identity,
                   'MessagingBinding.Address' => messaging_binding_address,
@@ -63,6 +66,7 @@ module Twilio
                   'DateUpdated' => Twilio.serialize_iso8601_datetime(date_updated),
                   'Attributes' => attributes,
                   'MessagingBinding.ProjectedAddress' => messaging_binding_projected_address,
+                  'RoleSid' => role_sid,
               })
 
               payload = @version.create(
@@ -221,12 +225,16 @@ module Twilio
             #   store any data you wish. The string value must contain structurally valid JSON
             #   if specified.  **Note** that if the attributes are not set "{}" will be
             #   returned.
+            # @param [String] role_sid The SID of the
+            #   [Role](https://www.twilio.com/docs/chat/rest/role-resource) to assign to the
+            #   participant.
             # @return [ParticipantInstance] Updated ParticipantInstance
-            def update(date_created: :unset, date_updated: :unset, attributes: :unset)
+            def update(date_created: :unset, date_updated: :unset, attributes: :unset, role_sid: :unset)
               data = Twilio::Values.of({
                   'DateCreated' => Twilio.serialize_iso8601_datetime(date_created),
                   'DateUpdated' => Twilio.serialize_iso8601_datetime(date_updated),
                   'Attributes' => attributes,
+                  'RoleSid' => role_sid,
               })
 
               payload = @version.update(
@@ -308,6 +316,7 @@ module Twilio
                   'identity' => payload['identity'],
                   'attributes' => payload['attributes'],
                   'messaging_binding' => payload['messaging_binding'],
+                  'role_sid' => payload['role_sid'],
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
                   'url' => payload['url'],
@@ -365,6 +374,12 @@ module Twilio
               @properties['messaging_binding']
             end
 
+            ##
+            # @return [String] The SID of the Role to assign to the participant
+            def role_sid
+              @properties['role_sid']
+            end
+
             ##
             # @return [Time] The date that this resource was created.
             def date_created
@@ -391,9 +406,17 @@ module Twilio
             #   store any data you wish. The string value must contain structurally valid JSON
             #   if specified.  **Note** that if the attributes are not set "{}" will be
             #   returned.
+            # @param [String] role_sid The SID of the
+            #   [Role](https://www.twilio.com/docs/chat/rest/role-resource) to assign to the
+            #   participant.
             # @return [ParticipantInstance] Updated ParticipantInstance
-            def update(date_created: :unset, date_updated: :unset, attributes: :unset)
-              context.update(date_created: date_created, date_updated: date_updated, attributes: attributes, )
+            def update(date_created: :unset, date_updated: :unset, attributes: :unset, role_sid: :unset)
+              context.update(
+                  date_created: date_created,
+                  date_updated: date_updated,
+                  attributes: attributes,
+                  role_sid: role_sid,
+              )
             end
 
             ##

data/lib/twilio-ruby/rest/flex_api/v1/channel.rb

@@ -117,7 +117,8 @@ module Twilio
           #   of an SMS.
           # @param [String] chat_unique_name The chat channel's unique name.
           # @param [String] pre_engagement_data The pre-engagement data.
-          # @param [String] task_sid The SID of the TaskRouter task.
+          # @param [String] task_sid The SID of the TaskRouter task. Only valid when
+          #   integration type is `task`. `null` for integration types `studio` & `external`
           # @param [String] task_attributes The task attributes to be added for the
           #   TaskRouter Task.
           # @param [Boolean] long_lived Whether to create the channel as long-lived.

data/lib/twilio-ruby/rest/flex_api/v1/configuration.rb

@@ -161,6 +161,7 @@ module Twilio
                 'runtime_domain' => payload['runtime_domain'],
                 'messaging_service_instance_sid' => payload['messaging_service_instance_sid'],
                 'chat_service_instance_sid' => payload['chat_service_instance_sid'],
+                'flex_service_instance_sid' => payload['flex_service_instance_sid'],
                 'ui_language' => payload['ui_language'],
                 'ui_attributes' => payload['ui_attributes'],
                 'ui_dependencies' => payload['ui_dependencies'],
@@ -296,6 +297,12 @@ module Twilio
             @properties['chat_service_instance_sid']
           end
 
+          ##
+          # @return [String] The SID of the Flex service instance
+          def flex_service_instance_sid
+            @properties['flex_service_instance_sid']
+          end
+
           ##
           # @return [String] The primary language of the Flex UI
           def ui_language

data/lib/twilio-ruby/rest/flex_api/v1/flex_flow.rb

@@ -145,9 +145,10 @@ module Twilio
           #   misconfigured Flex Flow and no tasks will be created.
           # @param [Boolean] long_lived When enabled, Flex will keep the chat channel active
           #   so that it may be used for subsequent interactions with a contact identity.
+          #   Defaults to `false`.
           # @param [Boolean] janitor_enabled When enabled, the Messaging Channel Janitor
           #   will remove active Proxy sessions if the associated Task is deleted outside of
-          #   the Flex UI.
+          #   the Flex UI. Defaults to `false`.
           # @param [String] integration_retry_count The number of times to retry the webhook
           #   if the first attempt fails. Can be an integer between 0 and 3, inclusive, and
           #   the default is 0.
@@ -279,9 +280,10 @@ module Twilio
           #   misconfigured Flex Flow and no tasks will be created.
           # @param [Boolean] long_lived When enabled, Flex will keep the chat channel active
           #   so that it may be used for subsequent interactions with a contact identity.
+          #   Defaults to `false`.
           # @param [Boolean] janitor_enabled When enabled, the Messaging Channel Janitor
           #   will remove active Proxy sessions if the associated Task is deleted outside of
-          #   the Flex UI.
+          #   the Flex UI. Defaults to `false`.
           # @param [String] integration_retry_count The number of times to retry the webhook
           #   if the first attempt fails. Can be an integer between 0 and 3, inclusive, and
           #   the default is 0.
@@ -505,9 +507,10 @@ module Twilio
           #   misconfigured Flex Flow and no tasks will be created.
           # @param [Boolean] long_lived When enabled, Flex will keep the chat channel active
           #   so that it may be used for subsequent interactions with a contact identity.
+          #   Defaults to `false`.
           # @param [Boolean] janitor_enabled When enabled, the Messaging Channel Janitor
           #   will remove active Proxy sessions if the associated Task is deleted outside of
-          #   the Flex UI.
+          #   the Flex UI. Defaults to `false`.
           # @param [String] integration_retry_count The number of times to retry the webhook
           #   if the first attempt fails. Can be an integer between 0 and 3, inclusive, and
           #   the default is 0.

data/lib/twilio-ruby/rest/monitor/v1/alert.rb

@@ -29,10 +29,10 @@ module Twilio
           # memory before returning.
           # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
           #   `warning`, `notice`, or `debug`.
-          # @param [Date] start_date Only include alerts that occurred on or after this date
+          # @param [Time] start_date Only include alerts that occurred on or after this date
           #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
           #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
-          # @param [Date] end_date Only include alerts that occurred on or before this date
+          # @param [Time] end_date Only include alerts that occurred on or before this date
           #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
           #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
           # @param [Integer] limit Upper limit for the number of records to return. stream()
@@ -58,10 +58,10 @@ module Twilio
           # is reached.
           # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
           #   `warning`, `notice`, or `debug`.
-          # @param [Date] start_date Only include alerts that occurred on or after this date
+          # @param [Time] start_date Only include alerts that occurred on or after this date
           #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
           #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
-          # @param [Date] end_date Only include alerts that occurred on or before this date
+          # @param [Time] end_date Only include alerts that occurred on or before this date
           #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
           #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
           # @param [Integer] limit Upper limit for the number of records to return. stream()
@@ -103,10 +103,10 @@ module Twilio
           # Request is executed immediately.
           # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
           #   `warning`, `notice`, or `debug`.
-          # @param [Date] start_date Only include alerts that occurred on or after this date
+          # @param [Time] start_date Only include alerts that occurred on or after this date
           #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
           #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
-          # @param [Date] end_date Only include alerts that occurred on or before this date
+          # @param [Time] end_date Only include alerts that occurred on or before this date
           #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
           #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
           # @param [String] page_token PageToken provided by the API
@@ -116,8 +116,8 @@ module Twilio
           def page(log_level: :unset, start_date: :unset, end_date: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
             params = Twilio::Values.of({
                 'LogLevel' => log_level,
-                'StartDate' => Twilio.serialize_iso8601_date(start_date),
-                'EndDate' => Twilio.serialize_iso8601_date(end_date),
+                'StartDate' => Twilio.serialize_iso8601_datetime(start_date),
+                'EndDate' => Twilio.serialize_iso8601_datetime(end_date),
                 'PageToken' => page_token,
                 'Page' => page_number,
                 'PageSize' => page_size,

data/lib/twilio-ruby/rest/notify/v1/service.rb

@@ -60,8 +60,11 @@ module Twilio
           #   `false` and the default is `true`.
           # @param [String] alexa_skill_id Deprecated.
           # @param [String] default_alexa_notification_protocol_version Deprecated.
+          # @param [String] delivery_callback_url URL to send delivery status callback.
+          # @param [Boolean] delivery_callback_enabled Callback configuration that enables
+          #   delivery callbacks, default false
           # @return [ServiceInstance] Newly created ServiceInstance
-          def create(friendly_name: :unset, apn_credential_sid: :unset, gcm_credential_sid: :unset, messaging_service_sid: :unset, facebook_messenger_page_id: :unset, default_apn_notification_protocol_version: :unset, default_gcm_notification_protocol_version: :unset, fcm_credential_sid: :unset, default_fcm_notification_protocol_version: :unset, log_enabled: :unset, alexa_skill_id: :unset, default_alexa_notification_protocol_version: :unset)
+          def create(friendly_name: :unset, apn_credential_sid: :unset, gcm_credential_sid: :unset, messaging_service_sid: :unset, facebook_messenger_page_id: :unset, default_apn_notification_protocol_version: :unset, default_gcm_notification_protocol_version: :unset, fcm_credential_sid: :unset, default_fcm_notification_protocol_version: :unset, log_enabled: :unset, alexa_skill_id: :unset, default_alexa_notification_protocol_version: :unset, delivery_callback_url: :unset, delivery_callback_enabled: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'ApnCredentialSid' => apn_credential_sid,
@@ -75,6 +78,8 @@ module Twilio
                 'LogEnabled' => log_enabled,
                 'AlexaSkillId' => alexa_skill_id,
                 'DefaultAlexaNotificationProtocolVersion' => default_alexa_notification_protocol_version,
+                'DeliveryCallbackUrl' => delivery_callback_url,
+                'DeliveryCallbackEnabled' => delivery_callback_enabled,
             })
 
             payload = @version.create(
@@ -399,6 +404,8 @@ module Twilio
                 'links' => payload['links'],
                 'alexa_skill_id' => payload['alexa_skill_id'],
                 'default_alexa_notification_protocol_version' => payload['default_alexa_notification_protocol_version'],
+                'delivery_callback_url' => payload['delivery_callback_url'],
+                'delivery_callback_enabled' => payload['delivery_callback_enabled'],
             }
 
             # Context
@@ -525,6 +532,18 @@ module Twilio
             @properties['default_alexa_notification_protocol_version']
           end
 
+          ##
+          # @return [String] Webhook URL
+          def delivery_callback_url
+            @properties['delivery_callback_url']
+          end
+
+          ##
+          # @return [Boolean] Enable delivery callbacks
+          def delivery_callback_enabled
+            @properties['delivery_callback_enabled']
+          end
+
           ##
           # Deletes the ServiceInstance
           # @return [Boolean] true if delete succeeds, false otherwise

data/lib/twilio-ruby/rest/numbers/v2/regulatory_compliance/bundle.rb

@@ -242,6 +242,7 @@ module Twilio
               @uri = "/RegulatoryCompliance/Bundles/#{@solution[:sid]}"
 
               # Dependents
+              @evaluations = nil
               @item_assignments = nil
             end
 
@@ -287,6 +288,24 @@ module Twilio
               BundleInstance.new(@version, payload, sid: @solution[:sid], )
             end
 
+            ##
+            # Access the evaluations
+            # @return [EvaluationList]
+            # @return [EvaluationContext] if sid was passed.
+            def evaluations(sid=:unset)
+              raise ArgumentError, 'sid cannot be nil' if sid.nil?
+
+              if sid != :unset
+                return EvaluationContext.new(@version, @solution[:sid], sid, )
+              end
+
+              unless @evaluations
+                @evaluations = EvaluationList.new(@version, bundle_sid: @solution[:sid], )
+              end
+
+              @evaluations
+            end
+
             ##
             # Access the item_assignments
             # @return [ItemAssignmentList]
@@ -454,6 +473,13 @@ module Twilio
               )
             end
 
+            ##
+            # Access the evaluations
+            # @return [evaluations] evaluations
+            def evaluations
+              context.evaluations
+            end
+
             ##
             # Access the item_assignments
             # @return [item_assignments] item_assignments