twilio-ruby 5.38.0 → 5.40.0

data/lib/twilio-ruby/rest/chat/v2/service/user/user_binding.rb

@@ -110,11 +110,9 @@ module Twilio
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 UserBindingPage.new(@version, response, @solution)
               end
 
@@ -195,16 +193,10 @@ module Twilio
               end
 
               ##
-              # Fetch a UserBindingInstance
+              # Fetch the UserBindingInstance
               # @return [UserBindingInstance] Fetched UserBindingInstance
               def fetch
-                params = Twilio::Values.of({})
-
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri)
 
                 UserBindingInstance.new(
                     @version,
@@ -216,10 +208,10 @@ module Twilio
               end
 
               ##
-              # Deletes the UserBindingInstance
+              # Delete the UserBindingInstance
               # @return [Boolean] true if delete succeeds, false otherwise
               def delete
-                @version.delete('delete', @uri)
+                 @version.delete('DELETE', @uri)
               end
 
               ##
@@ -365,14 +357,14 @@ module Twilio
               end
 
               ##
-              # Fetch a UserBindingInstance
+              # Fetch the UserBindingInstance
               # @return [UserBindingInstance] Fetched UserBindingInstance
               def fetch
                 context.fetch
               end
 
               ##
-              # Deletes the UserBindingInstance
+              # Delete the UserBindingInstance
               # @return [Boolean] true if delete succeeds, false otherwise
               def delete
                 context.delete

data/lib/twilio-ruby/rest/chat/v2/service/user/user_channel.rb

@@ -92,11 +92,9 @@ module Twilio
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 UserChannelPage.new(@version, response, @solution)
               end
 
@@ -179,16 +177,10 @@ module Twilio
               end
 
               ##
-              # Fetch a UserChannelInstance
+              # Fetch the UserChannelInstance
               # @return [UserChannelInstance] Fetched UserChannelInstance
               def fetch
-                params = Twilio::Values.of({})
-
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri)
 
                 UserChannelInstance.new(
                     @version,
@@ -200,10 +192,10 @@ module Twilio
               end
 
               ##
-              # Deletes the UserChannelInstance
+              # Delete the UserChannelInstance
               # @return [Boolean] true if delete succeeds, false otherwise
               def delete
-                @version.delete('delete', @uri)
+                 @version.delete('DELETE', @uri)
               end
 
               ##
@@ -225,11 +217,7 @@ module Twilio
                     'LastConsumptionTimestamp' => Twilio.serialize_iso8601_datetime(last_consumption_timestamp),
                 })
 
-                payload = @version.update(
-                    'POST',
-                    @uri,
-                    data: data,
-                )
+                payload = @version.update('POST', @uri, data: data)
 
                 UserChannelInstance.new(
                     @version,
@@ -381,14 +369,14 @@ module Twilio
               end
 
               ##
-              # Fetch a UserChannelInstance
+              # Fetch the UserChannelInstance
               # @return [UserChannelInstance] Fetched UserChannelInstance
               def fetch
                 context.fetch
               end
 
               ##
-              # Deletes the UserChannelInstance
+              # Delete the UserChannelInstance
               # @return [Boolean] true if delete succeeds, false otherwise
               def delete
                 context.delete

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

@@ -33,6 +33,7 @@ module Twilio
         @autopilot = nil
         @chat = nil
         @conversations = nil
+        @events = nil
         @fax = nil
         @flex_api = nil
         @insights = nil
@@ -160,6 +161,12 @@ module Twilio
         @conversations ||= Conversations.new self
       end
 
+      ##
+      # Access the Events Twilio Domain
+      def events
+        @events ||= Events.new self
+      end
+
       ##
       # Access the Fax Twilio Domain
       def fax

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

@@ -26,8 +26,7 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of ConversationInstance records from the API.
-          # Request is executed immediately.
+          # Create the ConversationInstance
           # @param [String] friendly_name The human-readable name of this conversation,
           #   limited to 256 characters. Optional.
           # @param [Time] date_created The date that this resource was created.
@@ -45,8 +44,10 @@ module Twilio
           #   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, timers_inactive: :unset, timers_closed: :unset)
+          # @param [conversation.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
+          # @return [ConversationInstance] Created ConversationInstance
+          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, x_twilio_webhook_enabled: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'DateCreated' => Twilio.serialize_iso8601_datetime(date_created),
@@ -57,12 +58,9 @@ module Twilio
                 'Timers.Inactive' => timers_inactive,
                 'Timers.Closed' => timers_closed,
             })
+            headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data, headers: headers)
 
             ConversationInstance.new(@version, payload, )
           end
@@ -128,11 +126,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             ConversationPage.new(@version, response, @solution)
           end
 
@@ -228,8 +224,10 @@ module Twilio
           #   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.
+          # @param [conversation.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
           # @return [ConversationInstance] Updated ConversationInstance
-          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)
+          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, x_twilio_webhook_enabled: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'DateCreated' => Twilio.serialize_iso8601_datetime(date_created),
@@ -240,34 +238,29 @@ module Twilio
                 'Timers.Inactive' => timers_inactive,
                 'Timers.Closed' => timers_closed,
             })
+            headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data, headers: headers)
 
             ConversationInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the ConversationInstance
+          # Delete the ConversationInstance
+          # @param [conversation.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
           # @return [Boolean] true if delete succeeds, false otherwise
-          def delete
-            @version.delete('delete', @uri)
+          def delete(x_twilio_webhook_enabled: :unset)
+            headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
+
+             @version.delete('DELETE', @uri, headers: headers)
           end
 
           ##
-          # Fetch a ConversationInstance
+          # Fetch the ConversationInstance
           # @return [ConversationInstance] Fetched ConversationInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             ConversationInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -477,8 +470,10 @@ module Twilio
           #   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.
+          # @param [conversation.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
           # @return [ConversationInstance] Updated ConversationInstance
-          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)
+          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, x_twilio_webhook_enabled: :unset)
             context.update(
                 friendly_name: friendly_name,
                 date_created: date_created,
@@ -488,18 +483,21 @@ module Twilio
                 state: state,
                 timers_inactive: timers_inactive,
                 timers_closed: timers_closed,
+                x_twilio_webhook_enabled: x_twilio_webhook_enabled,
             )
           end
 
           ##
-          # Deletes the ConversationInstance
+          # Delete the ConversationInstance
+          # @param [conversation.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
           # @return [Boolean] true if delete succeeds, false otherwise
-          def delete
-            context.delete
+          def delete(x_twilio_webhook_enabled: :unset)
+            context.delete(x_twilio_webhook_enabled: x_twilio_webhook_enabled, )
           end
 
           ##
-          # Fetch a ConversationInstance
+          # Fetch the ConversationInstance
           # @return [ConversationInstance] Fetched ConversationInstance
           def fetch
             context.fetch

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

@@ -29,8 +29,7 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of MessageInstance records from the API.
-            # Request is executed immediately.
+            # Create the MessageInstance
             # @param [String] author The channel specific identifier of the message's author.
             #   Defaults to `system`.
             # @param [String] body The content of the message, can be up to 1,600 characters
@@ -42,8 +41,10 @@ module Twilio
             #   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] media_sid The Media Sid to be attached to the new Message.
-            # @return [MessageInstance] Newly created MessageInstance
-            def create(author: :unset, body: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, media_sid: :unset)
+            # @param [message.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
+            # @return [MessageInstance] Created MessageInstance
+            def create(author: :unset, body: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, media_sid: :unset, x_twilio_webhook_enabled: :unset)
               data = Twilio::Values.of({
                   'Author' => author,
                   'Body' => body,
@@ -52,12 +53,9 @@ module Twilio
                   'Attributes' => attributes,
                   'MediaSid' => media_sid,
               })
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data, headers: headers)
 
               MessageInstance.new(@version, payload, conversation_sid: @solution[:conversation_sid], )
             end
@@ -123,11 +121,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               MessagePage.new(@version, response, @solution)
             end
 
@@ -199,6 +195,9 @@ module Twilio
               # Path Solution
               @solution = {conversation_sid: conversation_sid, sid: sid, }
               @uri = "/Conversations/#{@solution[:conversation_sid]}/Messages/#{@solution[:sid]}"
+
+              # Dependents
+              @delivery_receipts = nil
             end
 
             ##
@@ -213,8 +212,10 @@ module Twilio
             # @param [String] attributes A string metadata field you can use to 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 [message.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [MessageInstance] Updated MessageInstance
-            def update(author: :unset, body: :unset, date_created: :unset, date_updated: :unset, attributes: :unset)
+            def update(author: :unset, body: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, x_twilio_webhook_enabled: :unset)
               data = Twilio::Values.of({
                   'Author' => author,
                   'Body' => body,
@@ -222,12 +223,9 @@ module Twilio
                   'DateUpdated' => Twilio.serialize_iso8601_datetime(date_updated),
                   'Attributes' => attributes,
               })
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data, headers: headers)
 
               MessageInstance.new(
                   @version,
@@ -238,23 +236,21 @@ module Twilio
             end
 
             ##
-            # Deletes the MessageInstance
+            # Delete the MessageInstance
+            # @param [message.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-              @version.delete('delete', @uri)
+            def delete(x_twilio_webhook_enabled: :unset)
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
+
+               @version.delete('DELETE', @uri, headers: headers)
             end
 
             ##
-            # Fetch a MessageInstance
+            # Fetch the MessageInstance
             # @return [MessageInstance] Fetched MessageInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               MessageInstance.new(
                   @version,
@@ -264,6 +260,28 @@ module Twilio
               )
             end
 
+            ##
+            # Access the delivery_receipts
+            # @return [DeliveryReceiptList]
+            # @return [DeliveryReceiptContext] if sid was passed.
+            def delivery_receipts(sid=:unset)
+              raise ArgumentError, 'sid cannot be nil' if sid.nil?
+
+              if sid != :unset
+                return DeliveryReceiptContext.new(@version, @solution[:conversation_sid], @solution[:sid], sid, )
+              end
+
+              unless @delivery_receipts
+                @delivery_receipts = DeliveryReceiptList.new(
+                    @version,
+                    conversation_sid: @solution[:conversation_sid],
+                    message_sid: @solution[:sid],
+                )
+              end
+
+              @delivery_receipts
+            end
+
             ##
             # Provide a user friendly representation
             def to_s
@@ -308,6 +326,8 @@ module Twilio
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
                   'url' => payload['url'],
+                  'delivery' => payload['delivery'],
+                  'links' => payload['links'],
               }
 
               # Context
@@ -398,6 +418,18 @@ module Twilio
               @properties['url']
             end
 
+            ##
+            # @return [Hash] An object that contains the summary of delivery statuses for the message to non-chat participants.
+            def delivery
+              @properties['delivery']
+            end
+
+            ##
+            # @return [String] The links
+            def links
+              @properties['links']
+            end
+
             ##
             # Update the MessageInstance
             # @param [String] author The channel specific identifier of the message's author.
@@ -410,31 +442,43 @@ module Twilio
             # @param [String] attributes A string metadata field you can use to 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 [message.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [MessageInstance] Updated MessageInstance
-            def update(author: :unset, body: :unset, date_created: :unset, date_updated: :unset, attributes: :unset)
+            def update(author: :unset, body: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, x_twilio_webhook_enabled: :unset)
               context.update(
                   author: author,
                   body: body,
                   date_created: date_created,
                   date_updated: date_updated,
                   attributes: attributes,
+                  x_twilio_webhook_enabled: x_twilio_webhook_enabled,
               )
             end
 
             ##
-            # Deletes the MessageInstance
+            # Delete the MessageInstance
+            # @param [message.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-              context.delete
+            def delete(x_twilio_webhook_enabled: :unset)
+              context.delete(x_twilio_webhook_enabled: x_twilio_webhook_enabled, )
             end
 
             ##
-            # Fetch a MessageInstance
+            # Fetch the MessageInstance
             # @return [MessageInstance] Fetched MessageInstance
             def fetch
               context.fetch
             end
 
+            ##
+            # Access the delivery_receipts
+            # @return [delivery_receipts] delivery_receipts
+            def delivery_receipts
+              context.delivery_receipts
+            end
+
             ##
             # Provide a user friendly representation
             def to_s