twilio-ruby 5.31.0 → 5.46.0

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

@@ -44,7 +44,7 @@ module Twilio
       end
 
       ##
-      # @param [String] sid The unique string that we created to identify the FlexFlow
+      # @param [String] sid The unique string that we created to identify the Flex Flow
       #   resource.
       # @return [Twilio::REST::Flex_api::V1::FlexFlowInstance] if sid was passed.
       # @return [Twilio::REST::Flex_api::V1::FlexFlowList]

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

@@ -42,7 +42,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid The SID of the FlexFlow resource to fetch.
+        # @param [String] sid The SID of the Flex Flow resource to fetch.
         # @return [Twilio::REST::Flex_api::V1::FlexFlowContext] if sid was passed.
         # @return [Twilio::REST::Flex_api::V1::FlexFlowList]
         def flex_flow(sid=:unset)

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

@@ -84,11 +84,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             ChannelPage.new(@version, response, @solution)
           end
 
@@ -106,9 +104,8 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of ChannelInstance records from the API.
-          # Request is executed immediately.
-          # @param [String] flex_flow_sid The SID of the FlexFlow.
+          # Create the ChannelInstance
+          # @param [String] flex_flow_sid The SID of the Flex Flow.
           # @param [String] identity The `identity` value that uniquely identifies the new
           #   resource's chat User.
           # @param [String] chat_user_friendly_name The chat participant's friendly name.
@@ -117,11 +114,12 @@ 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_attributes The task attributes to be added for the
+          # @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.
-          # @return [ChannelInstance] Newly created ChannelInstance
+          # @return [ChannelInstance] Created ChannelInstance
           def create(flex_flow_sid: nil, identity: nil, chat_user_friendly_name: nil, chat_friendly_name: nil, target: :unset, chat_unique_name: :unset, pre_engagement_data: :unset, task_sid: :unset, task_attributes: :unset, long_lived: :unset)
             data = Twilio::Values.of({
                 'FlexFlowSid' => flex_flow_sid,
@@ -136,11 +134,7 @@ module Twilio
                 'LongLived' => long_lived,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             ChannelInstance.new(@version, payload, )
           end
@@ -196,25 +190,19 @@ module Twilio
           end
 
           ##
-          # Fetch a ChannelInstance
+          # Fetch the ChannelInstance
           # @return [ChannelInstance] Fetched ChannelInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             ChannelInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the ChannelInstance
+          # Delete the ChannelInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -277,7 +265,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The SID of the FlexFlow
+          # @return [String] The SID of the Flex Flow
           def flex_flow_sid
             @properties['flex_flow_sid']
           end
@@ -295,7 +283,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The SID of the TaskRouter task
+          # @return [String] The SID of the TaskRouter Task
           def task_sid
             @properties['task_sid']
           end
@@ -319,14 +307,14 @@ module Twilio
           end
 
           ##
-          # Fetch a ChannelInstance
+          # Fetch the ChannelInstance
           # @return [ChannelInstance] Fetched ChannelInstance
           def fetch
             context.fetch
           end
 
           ##
-          # Deletes the ChannelInstance
+          # Delete the ChannelInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete

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

@@ -72,34 +72,23 @@ module Twilio
           end
 
           ##
-          # Fetch a ConfigurationInstance
+          # Fetch the ConfigurationInstance
           # @param [String] ui_version The Pinned UI version of the Configuration resource
           #   to fetch.
           # @return [ConfigurationInstance] Fetched ConfigurationInstance
           def fetch(ui_version: :unset)
             params = Twilio::Values.of({'UiVersion' => ui_version, })
 
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri, params: params)
 
             ConfigurationInstance.new(@version, payload, )
           end
 
           ##
-          # Retrieve a single page of ConfigurationInstance records from the API.
-          # Request is executed immediately.
-          # @return [ConfigurationInstance] Newly created ConfigurationInstance
+          # Create the ConfigurationInstance
+          # @return [ConfigurationInstance] Created ConfigurationInstance
           def create
-            data = Twilio::Values.of({})
-
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri)
 
             ConfigurationInstance.new(@version, payload, )
           end
@@ -108,13 +97,7 @@ module Twilio
           # Update the ConfigurationInstance
           # @return [ConfigurationInstance] Updated ConfigurationInstance
           def update
-            data = Twilio::Values.of({})
-
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri)
 
             ConfigurationInstance.new(@version, payload, )
           end
@@ -161,8 +144,10 @@ 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'],
                 'ui_version' => payload['ui_version'],
                 'service_version' => payload['service_version'],
                 'call_recording_enabled' => payload['call_recording_enabled'],
@@ -178,6 +163,7 @@ module Twilio
                 'integrations' => payload['integrations'],
                 'outbound_call_flows' => payload['outbound_call_flows'],
                 'serverless_service_sids' => payload['serverless_service_sids'],
+                'queue_stats_configuration' => payload['queue_stats_configuration'],
                 'url' => payload['url'],
             }
 
@@ -246,13 +232,13 @@ module Twilio
           end
 
           ##
-          # @return [Hash] The list of TaskRouter TaskQueues
+          # @return [Array[Hash]] The list of TaskRouter TaskQueues
           def taskrouter_taskqueues
             @properties['taskrouter_taskqueues']
           end
 
           ##
-          # @return [Hash] The Skill description for TaskRouter workers
+          # @return [Array[Hash]] The Skill description for TaskRouter workers
           def taskrouter_skills
             @properties['taskrouter_skills']
           end
@@ -293,6 +279,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
@@ -305,6 +297,12 @@ module Twilio
             @properties['ui_attributes']
           end
 
+          ##
+          # @return [Hash] The object that defines the NPM packages and versions to be used in Hosted Flex
+          def ui_dependencies
+            @properties['ui_dependencies']
+          end
+
           ##
           # @return [String] The Pinned UI version
           def ui_version
@@ -378,7 +376,7 @@ module Twilio
           end
 
           ##
-          # @return [Hash] A list of objects that contain the configurations for the Integrations supported in this configuration
+          # @return [Array[Hash]] A list of objects that contain the configurations for the Integrations supported in this configuration
           def integrations
             @properties['integrations']
           end
@@ -390,11 +388,17 @@ module Twilio
           end
 
           ##
-          # @return [String] The list of serverless service SIDs
+          # @return [Array[String]] The list of serverless service SIDs
           def serverless_service_sids
             @properties['serverless_service_sids']
           end
 
+          ##
+          # @return [Hash] Configurable parameters for Queues Statistics
+          def queue_stats_configuration
+            @properties['queue_stats_configuration']
+          end
+
           ##
           # @return [String] The absolute URL of the Configuration resource
           def url
@@ -402,7 +406,7 @@ module Twilio
           end
 
           ##
-          # Fetch a ConfigurationInstance
+          # Fetch the ConfigurationInstance
           # @param [String] ui_version The Pinned UI version of the Configuration resource
           #   to fetch.
           # @return [ConfigurationInstance] Fetched ConfigurationInstance
@@ -411,9 +415,8 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of ConfigurationInstance records from the API.
-          # Request is executed immediately.
-          # @return [ConfigurationInstance] Newly created ConfigurationInstance
+          # Create the ConfigurationInstance
+          # @return [ConfigurationInstance] Created ConfigurationInstance
           def create
             context.create
           end

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

@@ -27,7 +27,7 @@ module Twilio
           # Lists FlexFlowInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [String] friendly_name The `friendly_name` of the FlexFlow resources to
+          # @param [String] friendly_name The `friendly_name` of the Flex Flow resources to
           #   read.
           # @param [Integer] limit Upper limit for the number of records to return. stream()
           #    guarantees to never return more than limit.  Default is no limit
@@ -44,7 +44,7 @@ module Twilio
           # Streams FlexFlowInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [String] friendly_name The `friendly_name` of the FlexFlow resources to
+          # @param [String] friendly_name The `friendly_name` of the Flex Flow resources to
           #   read.
           # @param [Integer] limit Upper limit for the number of records to return. stream()
           #    guarantees to never return more than limit. Default is no limit.
@@ -78,7 +78,7 @@ module Twilio
           ##
           # Retrieve a single page of FlexFlowInstance records from the API.
           # Request is executed immediately.
-          # @param [String] friendly_name The `friendly_name` of the FlexFlow resources to
+          # @param [String] friendly_name The `friendly_name` of the Flex Flow resources to
           #   read.
           # @param [String] page_token PageToken provided by the API
           # @param [Integer] page_number Page Number, this value is simply for client state
@@ -91,11 +91,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             FlexFlowPage.new(@version, response, @solution)
           end
 
@@ -113,41 +111,49 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of FlexFlowInstance records from the API.
-          # Request is executed immediately.
+          # Create the FlexFlowInstance
           # @param [String] friendly_name A descriptive string that you create to describe
-          #   the FlexFlow resource.
+          #   the Flex Flow resource.
           # @param [String] chat_service_sid The SID of the chat service.
           # @param [flex_flow.ChannelType] channel_type The channel type. Can be: `web`,
           #   `facebook`, `sms`, `whatsapp`, `line` or `custom`.
           # @param [String] contact_identity The channel contact's Identity.
-          # @param [Boolean] enabled Whether the new FlexFlow is enabled.
+          # @param [Boolean] enabled Whether the new Flex Flow is enabled.
           # @param [flex_flow.IntegrationType] integration_type The integration type. Can
           #   be: `studio`, `external`, or `task`.
-          # @param [String] integration_flow_sid The SID of the Flow when `integration_type`
-          #   is `studio`.
-          # @param [String] integration_url The External Webhook URL when `integration_type`
-          #   is `external`.
-          # @param [String] integration_workspace_sid The Workspace SID for a new task for
-          #   Task `integration_type`.
-          # @param [String] integration_workflow_sid The Workflow SID for a new task when
-          #   `integration_type` is `task`.
-          # @param [String] integration_channel The task channel for a new task when
-          #   `integration_type` is `task`. The default is `default`.
-          # @param [String] integration_timeout The task timeout in seconds for a new task
-          #   when `integration_type` is `task`. The default is `86,400` seconds (24 hours).
-          # @param [String] integration_priority The task priority of a new task when
-          #   `integration_type` is `task`. The default priority is `0`.
-          # @param [Boolean] integration_creation_on_message Whether to create a task when
-          #   the first message arrives when `integration_type` is `task`. If `false`, the
-          #   task is created with the channel.
-          # @param [Boolean] long_lived Whether new channels are long-lived.
-          # @param [Boolean] janitor_enabled Boolean flag for enabling or disabling the
-          #   Janitor
+          # @param [String] integration_flow_sid The SID of the Studio Flow. Required when
+          #   `integrationType` is `studio`.
+          # @param [String] integration_url The URL of the external webhook. Required when
+          #   `integrationType` is `external`.
+          # @param [String] integration_workspace_sid The Workspace SID for a new Task.
+          #   Required when `integrationType` is `task`.
+          # @param [String] integration_workflow_sid The Workflow SID for a new Task.
+          #   Required when `integrationType` is `task`.
+          # @param [String] integration_channel The Task Channel for the TaskRouter Task
+          #   that will be created. Applicable and required when integrationType is `task`.
+          #   Set to `sms` for SMS, and to `chat` otherwise. The default value is `default`
+          # @param [String] integration_timeout The Task timeout in seconds for a new Task.
+          #   Default is 86,400 seconds (24 hours). Optional when `integrationType` is `task`,
+          #   not applicable otherwise.
+          # @param [String] integration_priority The Task priority of a new Task. The
+          #   default priority is 0. Optional when `integrationType` is `task`, not applicable
+          #   otherwise.
+          # @param [Boolean] integration_creation_on_message In the context of outbound
+          #   messaging, defines whether to create a Task immediately (and therefore reserve
+          #   the conversation to current agent), or delay Task creation until the customer
+          #   sends the first response. Set to false to create immediately, true to delay Task
+          #   creation. This setting is only applicable for outbound messaging.
+          # @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. 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.
-          # @return [FlexFlowInstance] Newly created FlexFlowInstance
+          #   if the first attempt fails. Can be an integer between 0 and 3 (included),
+          #   default is 0. Optional when integrationType is `external`, not applicable
+          #   otherwise.
+          # @return [FlexFlowInstance] Created FlexFlowInstance
           def create(friendly_name: nil, chat_service_sid: nil, channel_type: nil, contact_identity: :unset, enabled: :unset, integration_type: :unset, integration_flow_sid: :unset, integration_url: :unset, integration_workspace_sid: :unset, integration_workflow_sid: :unset, integration_channel: :unset, integration_timeout: :unset, integration_priority: :unset, integration_creation_on_message: :unset, long_lived: :unset, janitor_enabled: :unset, integration_retry_count: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
@@ -169,11 +175,7 @@ module Twilio
                 'Integration.RetryCount' => integration_retry_count,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             FlexFlowInstance.new(@version, payload, )
           end
@@ -218,7 +220,7 @@ module Twilio
           ##
           # Initialize the FlexFlowContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The SID of the FlexFlow resource to fetch.
+          # @param [String] sid The SID of the Flex Flow resource to fetch.
           # @return [FlexFlowContext] FlexFlowContext
           def initialize(version, sid)
             super(version)
@@ -229,16 +231,10 @@ module Twilio
           end
 
           ##
-          # Fetch a FlexFlowInstance
+          # Fetch the FlexFlowInstance
           # @return [FlexFlowInstance] Fetched FlexFlowInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             FlexFlowInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -246,37 +242,46 @@ module Twilio
           ##
           # Update the FlexFlowInstance
           # @param [String] friendly_name A descriptive string that you create to describe
-          #   the FlexFlow resource.
+          #   the Flex Flow resource.
           # @param [String] chat_service_sid The SID of the chat service.
           # @param [flex_flow.ChannelType] channel_type The channel type. Can be: `web`,
           #   `facebook`, `sms`, `whatsapp`, `line` or `custom`.
           # @param [String] contact_identity The channel contact's Identity.
-          # @param [Boolean] enabled Whether the FlexFlow is enabled.
+          # @param [Boolean] enabled Whether the new Flex Flow is enabled.
           # @param [flex_flow.IntegrationType] integration_type The integration type. Can
           #   be: `studio`, `external`, or `task`.
-          # @param [String] integration_flow_sid The SID of the Flow when `integration_type`
-          #   is `studio`.
-          # @param [String] integration_url The External Webhook URL when `integration_type`
-          #   is `external`.
-          # @param [String] integration_workspace_sid The Workspace SID for a new task when
-          #   `integration_type` is `task`.
-          # @param [String] integration_workflow_sid The Workflow SID for a new task when
-          #   `integration_type` is `task`.
-          # @param [String] integration_channel The task channel for a new task when
-          #   `integration_type` is `task`. The default is `default`.
-          # @param [String] integration_timeout The task timeout in seconds for a new task
-          #   when `integration_type` is `task`. The default is `86,400` seconds (24 hours).
-          # @param [String] integration_priority The task priority of a new task when
-          #   `integration_type` is `task`. The default priority is `0`.
-          # @param [Boolean] integration_creation_on_message Whether to create a task when
-          #   the first message arrives when `integration_type` is `task`. If `false`, the
-          #   task is created with the channel.
-          # @param [Boolean] long_lived Whether new channels created are long-lived.
-          # @param [Boolean] janitor_enabled Boolean flag for enabling or disabling the
-          #   Janitor
+          # @param [String] integration_flow_sid The SID of the Studio Flow. Required when
+          #   `integrationType` is `studio`.
+          # @param [String] integration_url The URL of the external webhook. Required when
+          #   `integrationType` is `external`.
+          # @param [String] integration_workspace_sid The Workspace SID for a new Task.
+          #   Required when `integrationType` is `task`.
+          # @param [String] integration_workflow_sid The Workflow SID for a new Task.
+          #   Required when `integrationType` is `task`.
+          # @param [String] integration_channel The Task Channel for the TaskRouter Task
+          #   that will be created. Applicable and required when integrationType is `task`.
+          #   Set to `sms` for SMS, and to `chat` otherwise. The default value is `default`
+          # @param [String] integration_timeout The Task timeout in seconds for a new Task.
+          #   Default is 86,400 seconds (24 hours). Optional when `integrationType` is `task`,
+          #   not applicable otherwise.
+          # @param [String] integration_priority The Task priority of a new Task. The
+          #   default priority is 0. Optional when `integrationType` is `task`, not applicable
+          #   otherwise.
+          # @param [Boolean] integration_creation_on_message In the context of outbound
+          #   messaging, defines whether to create a Task immediately (and therefore reserve
+          #   the conversation to current agent), or delay Task creation until the customer
+          #   sends the first response. Set to false to create immediately, true to delay Task
+          #   creation. This setting is only applicable for outbound messaging.
+          # @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. 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.
+          #   if the first attempt fails. Can be an integer between 0 and 3 (included),
+          #   default is 0. Optional when integrationType is `external`, not applicable
+          #   otherwise.
           # @return [FlexFlowInstance] Updated FlexFlowInstance
           def update(friendly_name: :unset, chat_service_sid: :unset, channel_type: :unset, contact_identity: :unset, enabled: :unset, integration_type: :unset, integration_flow_sid: :unset, integration_url: :unset, integration_workspace_sid: :unset, integration_workflow_sid: :unset, integration_channel: :unset, integration_timeout: :unset, integration_priority: :unset, integration_creation_on_message: :unset, long_lived: :unset, janitor_enabled: :unset, integration_retry_count: :unset)
             data = Twilio::Values.of({
@@ -299,20 +304,16 @@ module Twilio
                 'Integration.RetryCount' => integration_retry_count,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             FlexFlowInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the FlexFlowInstance
+          # Delete the FlexFlowInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -335,7 +336,7 @@ module Twilio
           # Initialize the FlexFlowInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The SID of the FlexFlow resource to fetch.
+          # @param [String] sid The SID of the Flex Flow resource to fetch.
           # @return [FlexFlowInstance] FlexFlowInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -423,7 +424,7 @@ module Twilio
           end
 
           ##
-          # @return [Boolean] Whether the FlexFlow is enabled
+          # @return [Boolean] Whether the Flex Flow is enabled
           def enabled
             @properties['enabled']
           end
@@ -441,25 +442,25 @@ module Twilio
           end
 
           ##
-          # @return [Boolean] Whether new channels are long-lived
+          # @return [Boolean] Re-use this chat channel for future interactions with a contact
           def long_lived
             @properties['long_lived']
           end
 
           ##
-          # @return [Boolean] Boolean flag for enabling or disabling the Janitor
+          # @return [Boolean] Remove active Proxy sessions if the corresponding Task is deleted.
           def janitor_enabled
             @properties['janitor_enabled']
           end
 
           ##
-          # @return [String] The absolute URL of the FlexFlow resource
+          # @return [String] The absolute URL of the Flex Flow resource
           def url
             @properties['url']
           end
 
           ##
-          # Fetch a FlexFlowInstance
+          # Fetch the FlexFlowInstance
           # @return [FlexFlowInstance] Fetched FlexFlowInstance
           def fetch
             context.fetch
@@ -468,37 +469,46 @@ module Twilio
           ##
           # Update the FlexFlowInstance
           # @param [String] friendly_name A descriptive string that you create to describe
-          #   the FlexFlow resource.
+          #   the Flex Flow resource.
           # @param [String] chat_service_sid The SID of the chat service.
           # @param [flex_flow.ChannelType] channel_type The channel type. Can be: `web`,
           #   `facebook`, `sms`, `whatsapp`, `line` or `custom`.
           # @param [String] contact_identity The channel contact's Identity.
-          # @param [Boolean] enabled Whether the FlexFlow is enabled.
+          # @param [Boolean] enabled Whether the new Flex Flow is enabled.
           # @param [flex_flow.IntegrationType] integration_type The integration type. Can
           #   be: `studio`, `external`, or `task`.
-          # @param [String] integration_flow_sid The SID of the Flow when `integration_type`
-          #   is `studio`.
-          # @param [String] integration_url The External Webhook URL when `integration_type`
-          #   is `external`.
-          # @param [String] integration_workspace_sid The Workspace SID for a new task when
-          #   `integration_type` is `task`.
-          # @param [String] integration_workflow_sid The Workflow SID for a new task when
-          #   `integration_type` is `task`.
-          # @param [String] integration_channel The task channel for a new task when
-          #   `integration_type` is `task`. The default is `default`.
-          # @param [String] integration_timeout The task timeout in seconds for a new task
-          #   when `integration_type` is `task`. The default is `86,400` seconds (24 hours).
-          # @param [String] integration_priority The task priority of a new task when
-          #   `integration_type` is `task`. The default priority is `0`.
-          # @param [Boolean] integration_creation_on_message Whether to create a task when
-          #   the first message arrives when `integration_type` is `task`. If `false`, the
-          #   task is created with the channel.
-          # @param [Boolean] long_lived Whether new channels created are long-lived.
-          # @param [Boolean] janitor_enabled Boolean flag for enabling or disabling the
-          #   Janitor
+          # @param [String] integration_flow_sid The SID of the Studio Flow. Required when
+          #   `integrationType` is `studio`.
+          # @param [String] integration_url The URL of the external webhook. Required when
+          #   `integrationType` is `external`.
+          # @param [String] integration_workspace_sid The Workspace SID for a new Task.
+          #   Required when `integrationType` is `task`.
+          # @param [String] integration_workflow_sid The Workflow SID for a new Task.
+          #   Required when `integrationType` is `task`.
+          # @param [String] integration_channel The Task Channel for the TaskRouter Task
+          #   that will be created. Applicable and required when integrationType is `task`.
+          #   Set to `sms` for SMS, and to `chat` otherwise. The default value is `default`
+          # @param [String] integration_timeout The Task timeout in seconds for a new Task.
+          #   Default is 86,400 seconds (24 hours). Optional when `integrationType` is `task`,
+          #   not applicable otherwise.
+          # @param [String] integration_priority The Task priority of a new Task. The
+          #   default priority is 0. Optional when `integrationType` is `task`, not applicable
+          #   otherwise.
+          # @param [Boolean] integration_creation_on_message In the context of outbound
+          #   messaging, defines whether to create a Task immediately (and therefore reserve
+          #   the conversation to current agent), or delay Task creation until the customer
+          #   sends the first response. Set to false to create immediately, true to delay Task
+          #   creation. This setting is only applicable for outbound messaging.
+          # @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. 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.
+          #   if the first attempt fails. Can be an integer between 0 and 3 (included),
+          #   default is 0. Optional when integrationType is `external`, not applicable
+          #   otherwise.
           # @return [FlexFlowInstance] Updated FlexFlowInstance
           def update(friendly_name: :unset, chat_service_sid: :unset, channel_type: :unset, contact_identity: :unset, enabled: :unset, integration_type: :unset, integration_flow_sid: :unset, integration_url: :unset, integration_workspace_sid: :unset, integration_workflow_sid: :unset, integration_channel: :unset, integration_timeout: :unset, integration_priority: :unset, integration_creation_on_message: :unset, long_lived: :unset, janitor_enabled: :unset, integration_retry_count: :unset)
             context.update(
@@ -523,7 +533,7 @@ module Twilio
           end
 
           ##
-          # Deletes the FlexFlowInstance
+          # Delete the FlexFlowInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete