twilio-ruby 5.21.1 → 5.21.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 033d99c22bd8c3c4917074619d7339aa1dd541a235f35198a0cf6fa901a5bea4
-  data.tar.gz: c5d36cc844d6f9df0da19d03b91e3c84fa8c2877be215c25b3a63120bc252865
+  metadata.gz: ad3aa9bdc412dd96cc0b81e055d21cebb066bd4cd373e8d6e81073a5b190abc2
+  data.tar.gz: 1e613a2b3905866dd111eab5f637b199f0ecac111870ff8b57abe9fcbc1568a2
 SHA512:
-  metadata.gz: eac7dc68e920d156be2f1dac6c02af1da3d9b6d54cb9e2d93886d2807c84d34bec5f1ef14ffee43fdd7c89a9228732def563cfe6428a6aad527cbbdd85173b86
-  data.tar.gz: dca9534370604592a18c3ffaeb290abdcc3bac1f27dfa6b97b1950edc6a5d08d162ad14b55702d57a9dea8780ab8ef9debdb6a7c09da63ca3510d623a212edd7
+  metadata.gz: 141bc5a13272f67e640c5c70a46ab38d8e37f5bcca2d0c092a034841250e442c7ea0bca7cb159d6eada054f6a562eab34a1223f6944e022e30751daf24c72a63
+  data.tar.gz: 4c5a19b25aea870391e9b7baddfd7088b0ae3acdbde5ac3b6217a6162ba2995d169bb97a585164bae3fae4bbadbe636ab9f7b7f27febb6542acdad113746f1ad

data/CHANGES.md

@@ -1,6 +1,19 @@
 twilio-ruby changelog
 =====================
 
+[2019-03-15] Version 5.21.2
+----------------------------
+**Library**
+- PR #444: Add Help Center and Support Ticket links to the README. Thanks to @childish-sambino!
+
+**Api**
+- Add `machine_detection_speech_threshold`, `machine_detection_speech_end_threshold`, `machine_detection_silence_timeout` optional params to Call create request
+
+**Flex**
+- Adding Flex Channel Orchestration
+- Adding Flex Flow
+
+
 [2019-03-06] Version 5.21.1
 ----------------------------
 **Twiml**

data/README.md

@@ -27,13 +27,13 @@ in-line code documentation here in the library.
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.21.1'
+gem 'twilio-ruby', '~> 5.21.2'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.21.1
+gem install twilio-ruby -v 5.21.2
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -53,8 +53,11 @@ make install
 ## Docker Image
 The `Dockerfile` present in this repository and its respective `twilio/twilio-ruby` Docker image are currently used by Twilio for testing purposes only.
 
-## Feedback
-During the Release Candidate period of this library, please leave all feedback and issues in the [Github Issues][issues] for `twilio-ruby`.
+## Getting help
+
+If you need help installing or using the library, please check the [Twilio Support Help Center](https://support.twilio.com) first, and [file a support ticket](https://twilio.com/help/contact) if you don't find an answer to your question.
+
+If you've instead found a bug in the library or would like new features added, go ahead and open issues or pull requests against this repo!
 
 ## Getting Started
 

data/lib/twilio-ruby/rest/api/v2010/account/call.rb

@@ -120,6 +120,16 @@ module Twilio
             #   that made this call. Phone numbers are in [E.164
             #   format](https://wwnw.twilio.com/docs/glossary/what-e164) (e.g., +16175551212).
             #   SIP addresses are formatted as `name@company.com`.
+            # @param [String] machine_detection_speech_threshold The number of milliseconds
+            #   that is used as the measuring stick for the length of the speech activity, where
+            #   durations lower than this value will be interpreted as a human and longer than
+            #   this value as a machine. Possible Values: 1000-6000. Default: 2400.
+            # @param [String] machine_detection_speech_end_threshold The number of
+            #   milliseconds of silence after speech activity at which point the speech activity
+            #   is considered complete. Possible Values: 500-5000. Default: 1200.
+            # @param [String] machine_detection_silence_timeout The number of milliseconds of
+            #   initial silence after which an ‘unknown’ AnsweredBy result will be returned.
+            #   Possible Values: 2000-10000. Default: 5000.
             # @param [String] url The absolute URL that returns the TwiML instructions for the
             #   call. We will call this URL using the `method` when the call connects. For more
             #   information, see the [Url
@@ -128,7 +138,7 @@ module Twilio
             # @param [String] application_sid The SID of the Application resource that will
             #   handle the call, if the call will be handled by an application.
             # @return [CallInstance] Newly created CallInstance
-            def create(to: nil, from: nil, method: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, status_callback_event: :unset, status_callback_method: :unset, send_digits: :unset, if_machine: :unset, timeout: :unset, record: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, machine_detection: :unset, machine_detection_timeout: :unset, recording_status_callback_event: :unset, trim: :unset, caller_id: :unset, url: :unset, application_sid: :unset)
+            def create(to: nil, from: nil, method: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, status_callback_event: :unset, status_callback_method: :unset, send_digits: :unset, if_machine: :unset, timeout: :unset, record: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, machine_detection: :unset, machine_detection_timeout: :unset, recording_status_callback_event: :unset, trim: :unset, caller_id: :unset, machine_detection_speech_threshold: :unset, machine_detection_speech_end_threshold: :unset, machine_detection_silence_timeout: :unset, url: :unset, application_sid: :unset)
               data = Twilio::Values.of({
                   'To' => to,
                   'From' => from,
@@ -154,6 +164,9 @@ module Twilio
                   'RecordingStatusCallbackEvent' => Twilio.serialize_list(recording_status_callback_event) { |e| e },
                   'Trim' => trim,
                   'CallerId' => caller_id,
+                  'MachineDetectionSpeechThreshold' => machine_detection_speech_threshold,
+                  'MachineDetectionSpeechEndThreshold' => machine_detection_speech_end_threshold,
+                  'MachineDetectionSilenceTimeout' => machine_detection_silence_timeout,
               })
 
               payload = @version.create(

data/lib/twilio-ruby/rest/api/v2010/account/call/feedback.rb

@@ -96,7 +96,7 @@ module Twilio
               # @param [feedback.Issues] issue A list of one or more issues experienced during
               #   the call. Issues can be: `imperfect-audio`, `dropped-call`,
               #   `incorrect-caller-id`, `post-dial-delay`, `digits-not-captured`,
-              #   `audio-latency`, or `one-way-audio`.
+              #   `audio-latency`, `unsolicited-call`, or `one-way-audio`.
               # @return [FeedbackInstance] Newly created FeedbackInstance
               def create(quality_score: nil, issue: :unset)
                 data = Twilio::Values.of({
@@ -145,7 +145,8 @@ module Twilio
               #   call.
               # @param [feedback.Issues] issue One or more issues experienced during the call.
               #   The issues can be: `imperfect-audio`, `dropped-call`, `incorrect-caller-id`,
-              #   `post-dial-delay`, `digits-not-captured`, `audio-latency`, or `one-way-audio`.
+              #   `post-dial-delay`, `digits-not-captured`, `audio-latency`, `unsolicited-call`,
+              #   or `one-way-audio`.
               # @return [FeedbackInstance] Updated FeedbackInstance
               def update(quality_score: nil, issue: :unset)
                 data = Twilio::Values.of({
@@ -267,7 +268,7 @@ module Twilio
               # @param [feedback.Issues] issue A list of one or more issues experienced during
               #   the call. Issues can be: `imperfect-audio`, `dropped-call`,
               #   `incorrect-caller-id`, `post-dial-delay`, `digits-not-captured`,
-              #   `audio-latency`, or `one-way-audio`.
+              #   `audio-latency`, `unsolicited-call`, or `one-way-audio`.
               # @return [FeedbackInstance] Newly created FeedbackInstance
               def create(quality_score: nil, issue: :unset)
                 context.create(quality_score: quality_score, issue: issue, )
@@ -287,7 +288,8 @@ module Twilio
               #   call.
               # @param [feedback.Issues] issue One or more issues experienced during the call.
               #   The issues can be: `imperfect-audio`, `dropped-call`, `incorrect-caller-id`,
-              #   `post-dial-delay`, `digits-not-captured`, `audio-latency`, or `one-way-audio`.
+              #   `post-dial-delay`, `digits-not-captured`, `audio-latency`, `unsolicited-call`,
+              #   or `one-way-audio`.
               # @return [FeedbackInstance] Updated FeedbackInstance
               def update(quality_score: nil, issue: :unset)
                 context.update(quality_score: quality_score, issue: issue, )

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

@@ -36,7 +36,7 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
+      # @param [String] sid The unique string that we created to identify the Credential
       #   resource.
       # @return [Twilio::REST::Chat::V2::CredentialInstance] if sid was passed.
       # @return [Twilio::REST::Chat::V2::CredentialList]
@@ -45,7 +45,7 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
+      # @param [String] sid The unique string that we created to identify the Service
       #   resource.
       # @return [Twilio::REST::Chat::V2::ServiceInstance] if sid was passed.
       # @return [Twilio::REST::Chat::V2::ServiceList]

data/lib/twilio-ruby/rest/chat/v2.rb

@@ -20,7 +20,8 @@ module Twilio
         end
 
         ##
-        # @param [String] sid The sid
+        # @param [String] sid The Twilio-provided string that uniquely identifies the
+        #   Credential resource to fetch.
         # @return [Twilio::REST::Chat::V2::CredentialContext] if sid was passed.
         # @return [Twilio::REST::Chat::V2::CredentialList]
         def credentials(sid=:unset)
@@ -34,7 +35,8 @@ module Twilio
         end
 
         ##
-        # @param [String] sid The sid
+        # @param [String] sid The Twilio-provided string that uniquely identifies the
+        #   Service resource to fetch.
         # @return [Twilio::REST::Chat::V2::ServiceContext] if sid was passed.
         # @return [Twilio::REST::Chat::V2::ServiceList]
         def services(sid=:unset)

data/lib/twilio-ruby/rest/chat/v2/credential.rb

@@ -108,25 +108,26 @@ module Twilio
           ##
           # Retrieve a single page of CredentialInstance records from the API.
           # Request is executed immediately.
-          # @param [credential.PushService] type Credential type, one of "gcm", "fcm", or
-          #   "apn"
-          # @param [String] friendly_name Friendly name for stored credential
-          # @param [String] certificate [APN only] URL encoded representation of the
-          #   certificate, e.g.
+          # @param [credential.PushService] type The type of push-notification service the
+          #   credential is for. Can be: `gcm`, `fcm`, or `apn`.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the new resource. It can be up to 64 characters long.
+          # @param [String] certificate [APN only] The URL encoded representation of the
+          #   certificate. For example, 
           #   `-----BEGIN CERTIFICATE-----
           #   MIIFnTCCBIWgAwIBAgIIAjy9H849+E8wDQYJKoZIhvcNAQEFBQAwgZYxCzAJBgNV.....A==
           #   -----END CERTIFICATE-----`
-          # @param [String] private_key [APN only] URL encoded representation of the private
-          #   key, e.g.
+          # @param [String] private_key [APN only] The URL encoded representation of the
+          #   private key. For example,
           #   `-----BEGIN RSA PRIVATE KEY-----
           #   MIIEpQIBAAKCAQEAuyf/lNrH9ck8DmNyo3fGgvCI1l9s+cmBY3WIz+cUDqmxiieR.
           #   -----END RSA PRIVATE KEY-----`
-          # @param [Boolean] sandbox [APN only] use this credential for sending to
-          #   production or sandbox APNs (string `true` or `false`)
-          # @param [String] api_key [GCM only] This is the "API key" for project from Google
-          #   Developer console for your GCM Service application credential
-          # @param [String] secret [FCM only] This is the "Server key" of your project from
-          #   Firebase console under Settings / Cloud messaging.
+          # @param [Boolean] sandbox [APN only] Whether to send the credential to sandbox
+          #   APNs. Can be `true` to send to sandbox APNs or `false` to send to production.
+          # @param [String] api_key [GCM only] The API key for the project that was obtained
+          #   from the Google Developer console for your GCM Service application credential.
+          # @param [String] secret [FCM only] The **Server key** of your project from the
+          #   Firebase console, found under Settings / Cloud messaging.
           # @return [CredentialInstance] Newly created CredentialInstance
           def create(type: nil, friendly_name: :unset, certificate: :unset, private_key: :unset, sandbox: :unset, api_key: :unset, secret: :unset)
             data = Twilio::Values.of({
@@ -188,7 +189,8 @@ module Twilio
           ##
           # Initialize the CredentialContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The Twilio-provided string that uniquely identifies the
+          #   Credential resource to fetch.
           # @return [CredentialContext] CredentialContext
           def initialize(version, sid)
             super(version)
@@ -215,23 +217,24 @@ module Twilio
 
           ##
           # Update the CredentialInstance
-          # @param [String] friendly_name Friendly name for stored credential
-          # @param [String] certificate [APN only] URL encoded representation of the
-          #   certificate, e.g.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It can be up to 64 characters long.
+          # @param [String] certificate [APN only] The URL encoded representation of the
+          #   certificate. For example, 
           #   `-----BEGIN CERTIFICATE-----
           #   MIIFnTCCBIWgAwIBAgIIAjy9H849+E8wDQYJKoZIhvcNAQEFBQAwgZYxCzAJBgNV.....A==
           #   -----END CERTIFICATE-----`
-          # @param [String] private_key [APN only] URL encoded representation of the private
-          #   key, e.g.
+          # @param [String] private_key [APN only] The URL encoded representation of the
+          #   private key. For example,
           #   `-----BEGIN RSA PRIVATE KEY-----
           #   MIIEpQIBAAKCAQEAuyf/lNrH9ck8DmNyo3fGgvCI1l9s+cmBY3WIz+cUDqmxiieR.
           #   -----END RSA PRIVATE KEY-----`
-          # @param [Boolean] sandbox [APN only] use this credential for sending to
-          #   production or sandbox APNs (string `true` or `false`)
-          # @param [String] api_key [GCM only] This is the "API key" for project from Google
-          #   Developer console for your GCM Service application credential
-          # @param [String] secret [FCM only] This is the "Server key" of your project from
-          #   Firebase console under Settings / Cloud messaging.
+          # @param [Boolean] sandbox [APN only] Whether to send the credential to sandbox
+          #   APNs. Can be `true` to send to sandbox APNs or `false` to send to production.
+          # @param [String] api_key [GCM only] The API key for the project that was obtained
+          #   from the Google Developer console for your GCM Service application credential.
+          # @param [String] secret [FCM only] The **Server key** of your project from the
+          #   Firebase console, found under Settings / Cloud messaging.
           # @return [CredentialInstance] Updated CredentialInstance
           def update(friendly_name: :unset, certificate: :unset, private_key: :unset, sandbox: :unset, api_key: :unset, secret: :unset)
             data = Twilio::Values.of({
@@ -279,7 +282,8 @@ module Twilio
           # Initialize the CredentialInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The sid
+          # @param [String] sid The Twilio-provided string that uniquely identifies the
+          #   Credential resource to fetch.
           # @return [CredentialInstance] CredentialInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -313,49 +317,49 @@ module Twilio
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this resource.
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The unique id of the Account responsible for this resource.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The human-readable name of this resource.
+          # @return [String] The string that you assigned to describe the resource
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [credential.PushService] Indicates which push notifications service this credential is for - either gcm, fcm, or apn
+          # @return [credential.PushService] The type of push-notification service the credential is for
           def type
             @properties['type']
           end
 
           ##
-          # @return [String] [APN only] true when this resource should use the sandbox APN service.
+          # @return [String] [APN only] Whether to send the credential to sandbox APNs
           def sandbox
             @properties['sandbox']
           end
 
           ##
-          # @return [Time] The date that this resource was created.
+          # @return [Time] The RFC 2822 date and time in GMT when the resource was created
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date that this resource was last updated.
+          # @return [Time] The RFC 2822 date and time in GMT when the resource was last updated
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] An absolute URL for this credential resource.
+          # @return [String] The absolute URL of the Credential resource
           def url
             @properties['url']
           end
@@ -369,23 +373,24 @@ module Twilio
 
           ##
           # Update the CredentialInstance
-          # @param [String] friendly_name Friendly name for stored credential
-          # @param [String] certificate [APN only] URL encoded representation of the
-          #   certificate, e.g.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It can be up to 64 characters long.
+          # @param [String] certificate [APN only] The URL encoded representation of the
+          #   certificate. For example, 
           #   `-----BEGIN CERTIFICATE-----
           #   MIIFnTCCBIWgAwIBAgIIAjy9H849+E8wDQYJKoZIhvcNAQEFBQAwgZYxCzAJBgNV.....A==
           #   -----END CERTIFICATE-----`
-          # @param [String] private_key [APN only] URL encoded representation of the private
-          #   key, e.g.
+          # @param [String] private_key [APN only] The URL encoded representation of the
+          #   private key. For example,
           #   `-----BEGIN RSA PRIVATE KEY-----
           #   MIIEpQIBAAKCAQEAuyf/lNrH9ck8DmNyo3fGgvCI1l9s+cmBY3WIz+cUDqmxiieR.
           #   -----END RSA PRIVATE KEY-----`
-          # @param [Boolean] sandbox [APN only] use this credential for sending to
-          #   production or sandbox APNs (string `true` or `false`)
-          # @param [String] api_key [GCM only] This is the "API key" for project from Google
-          #   Developer console for your GCM Service application credential
-          # @param [String] secret [FCM only] This is the "Server key" of your project from
-          #   Firebase console under Settings / Cloud messaging.
+          # @param [Boolean] sandbox [APN only] Whether to send the credential to sandbox
+          #   APNs. Can be `true` to send to sandbox APNs or `false` to send to production.
+          # @param [String] api_key [GCM only] The API key for the project that was obtained
+          #   from the Google Developer console for your GCM Service application credential.
+          # @param [String] secret [FCM only] The **Server key** of your project from the
+          #   Firebase console, found under Settings / Cloud messaging.
           # @return [CredentialInstance] Updated CredentialInstance
           def update(friendly_name: :unset, certificate: :unset, private_key: :unset, sandbox: :unset, api_key: :unset, secret: :unset)
             context.update(

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

@@ -26,7 +26,8 @@ module Twilio
           ##
           # Retrieve a single page of ServiceInstance records from the API.
           # Request is executed immediately.
-          # @param [String] friendly_name Human-readable name for this service instance
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the new resource.
           # @return [ServiceInstance] Newly created ServiceInstance
           def create(friendly_name: nil)
             data = Twilio::Values.of({'FriendlyName' => friendly_name, })
@@ -162,7 +163,8 @@ module Twilio
           ##
           # Initialize the ServiceContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The Twilio-provided string that uniquely identifies the
+          #   Service resource to fetch.
           # @return [ServiceContext] ServiceContext
           def initialize(version, sid)
             super(version)
@@ -202,71 +204,95 @@ module Twilio
 
           ##
           # Update the ServiceInstance
-          # @param [String] friendly_name Human-readable name for this service instance
-          # @param [String] default_service_role_sid The default_service_role_sid
-          # @param [String] default_channel_role_sid Channel role assigned on channel join
-          #   (see [Roles](https://www.twilio.com/docs/chat/api/roles) data model for the
-          #   details)
-          # @param [String] default_channel_creator_role_sid Channel role assigned to
-          #   creator of channel when joining for first time
-          # @param [Boolean] read_status_enabled `true` if the member read status feature is
-          #   enabled, `false` if not.  Defaults to `true`.
-          # @param [Boolean] reachability_enabled `true` if the reachability feature should
-          #   be enabled.  Defaults to `false`
-          # @param [String] typing_indicator_timeout The duration in seconds indicating the
-          #   timeout after "started typing" event when client should assume that user is not
-          #   typing anymore even if no "ended typing" message received
-          # @param [String] consumption_report_interval The consumption_report_interval
-          # @param [Boolean] notifications_new_message_enabled The
-          #   notifications.new_message.enabled
-          # @param [String] notifications_new_message_template The
-          #   notifications.new_message.template
-          # @param [String] notifications_new_message_sound The
-          #   notifications.new_message.sound
-          # @param [Boolean] notifications_new_message_badge_count_enabled The
-          #   notifications.new_message.badge_count_enabled
-          # @param [Boolean] notifications_added_to_channel_enabled The
-          #   notifications.added_to_channel.enabled
-          # @param [String] notifications_added_to_channel_template The
-          #   notifications.added_to_channel.template
-          # @param [String] notifications_added_to_channel_sound The
-          #   notifications.added_to_channel.sound
-          # @param [Boolean] notifications_removed_from_channel_enabled The
-          #   notifications.removed_from_channel.enabled
-          # @param [String] notifications_removed_from_channel_template The
-          #   notifications.removed_from_channel.template
-          # @param [String] notifications_removed_from_channel_sound The
-          #   notifications.removed_from_channel.sound
-          # @param [Boolean] notifications_invited_to_channel_enabled The
-          #   notifications.invited_to_channel.enabled
-          # @param [String] notifications_invited_to_channel_template The
-          #   notifications.invited_to_channel.template
-          # @param [String] notifications_invited_to_channel_sound The
-          #   notifications.invited_to_channel.sound
-          # @param [String] pre_webhook_url The webhook URL for PRE-Event webhooks. See
-          #   [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more
-          #   details.
-          # @param [String] post_webhook_url The webhook URL for POST-Event webhooks. See
-          #   [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more
-          #   details.
-          # @param [String] webhook_method The webhook request format to use.  Must be POST
-          #   or GET. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events)
-          #   for more details.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource.
+          # @param [String] default_service_role_sid The service role assigned to users when
+          #   they are added to the service. See the [Roles
+          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          # @param [String] default_channel_role_sid The channel role assigned to users when
+          #   they are added to a channel. See the [Roles
+          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          # @param [String] default_channel_creator_role_sid The channel role assigned to a
+          #   channel creator when they join a new channel. See the [Roles
+          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          # @param [Boolean] read_status_enabled Whether to enable the [Message Consumption
+          #   Horizon](https://www.twilio.com/docs/chat/consumption-horizon) feature. The
+          #   default is `true`.
+          # @param [Boolean] reachability_enabled Whether to enable the [Reachability
+          #   Indicator](https://www.twilio.com/docs/chat/reachability-indicator) for this
+          #   Service instance. The default is `false`.
+          # @param [String] typing_indicator_timeout How long in seconds after a `started
+          #   typing` event until clients should assume that user is no longer typing, even if
+          #   no `ended typing` message was received.  The default is 5 seconds.
+          # @param [String] consumption_report_interval DEPRECATED. The interval in seconds
+          #   between consumption reports submission batches from client endpoints.
+          # @param [Boolean] notifications_new_message_enabled Whether to send a
+          #   notification when a new message is added to a channel. Can be: `true` or `false`
+          #   and the default is `false`.
+          # @param [String] notifications_new_message_template The template to use to create
+          #   the notification text displayed when a new message is added to a channel and
+          #   `notifications.new_message.enabled` is `true`.
+          # @param [String] notifications_new_message_sound The name of the sound to play
+          #   when a new message is added to a channel and `notifications.new_message.enabled`
+          #   is `true`.
+          # @param [Boolean] notifications_new_message_badge_count_enabled Whether the new
+          #   message badge is enabled. Can be: `true` or `false` and the default is `false`.
+          # @param [Boolean] notifications_added_to_channel_enabled Whether to send a
+          #   notification when a member is added to a channel. Can be: `true` or `false` and
+          #   the default is `false`.
+          # @param [String] notifications_added_to_channel_template The template to use to
+          #   create the notification text displayed when a member is added to a channel and
+          #   `notifications.added_to_channel.enabled` is `true`.
+          # @param [String] notifications_added_to_channel_sound The name of the sound to
+          #   play when a member is added to a channel and
+          #   `notifications.added_to_channel.enabled` is `true`.
+          # @param [Boolean] notifications_removed_from_channel_enabled Whether to send a
+          #   notification to a user when they are removed from a channel. Can be: `true` or
+          #   `false` and the default is `false`.
+          # @param [String] notifications_removed_from_channel_template The template to use
+          #   to create the notification text displayed to a user when they are removed from a
+          #   channel and `notifications.removed_from_channel.enabled` is `true`.
+          # @param [String] notifications_removed_from_channel_sound The name of the sound
+          #   to play to a user when they are removed from a channel and
+          #   `notifications.removed_from_channel.enabled` is `true`.
+          # @param [Boolean] notifications_invited_to_channel_enabled Whether to send a
+          #   notification when a user is invited to a channel. Can be: `true` or `false` and
+          #   the default is `false`.
+          # @param [String] notifications_invited_to_channel_template The template to use to
+          #   create the notification text displayed when a user is invited to a channel and
+          #   `notifications.invited_to_channel.enabled` is `true`.
+          # @param [String] notifications_invited_to_channel_sound The name of the sound to
+          #   play when a user is invited to a channel and
+          #   `notifications.invited_to_channel.enabled` is `true`.
+          # @param [String] pre_webhook_url The URL for pre-event webhooks, which are called
+          #   by using the `webhook_method`. See [Webhook
+          #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
+          # @param [String] post_webhook_url The URL for post-event webhooks, which are
+          #   called by using the `webhook_method`. See [Webhook
+          #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
+          # @param [String] webhook_method The HTTP method to use for calls to the
+          #   `pre_webhook_url` and `post_webhook_url` webhooks.  Can be: `POST` or `GET` and
+          #   the default is `POST`. See [Webhook
+          #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
           # @param [String] webhook_filters The list of WebHook events that are enabled for
           #   this Service instance. See [Webhook
           #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
           # @param [String] limits_channel_members The maximum number of Members that can be
-          #   added to Channels within this Service.  The maximum allowed value is 1,000
+          #   added to Channels within this Service. Can be up to 1,000.
           # @param [String] limits_user_channels The maximum number of Channels Users can be
-          #   a Member of within this Service.  The maximum value allowed is 1,000
-          # @param [String] media_compatibility_message The media.compatibility_message
-          # @param [String] pre_webhook_retry_count Count of times webhook will be retried
-          #   in case of timeout (5 seconds) or 429/503/504 HTTP responses. Default retry
-          #   count is 0 times.
-          # @param [String] post_webhook_retry_count Count of times webhook will be retried
-          #   in case of timeout (5 seconds) or 429/503/504 HTTP responses. Default retry
-          #   count is 0 times.
-          # @param [Boolean] notifications_log_enabled The notifications.log_enabled
+          #   a Member of within this Service. Can be up to 1,000.
+          # @param [String] media_compatibility_message The message to send when a media
+          #   message has no text. Can be used as placeholder message.
+          # @param [String] pre_webhook_retry_count The number of times to retry a call to
+          #   the `pre_webhook_url` if the request times out (after 5 seconds) or it receives
+          #   a 429, 503, or 504 HTTP response. Default retry count is 0 times, which means
+          #   the call won't be retried.
+          # @param [String] post_webhook_retry_count The number of times to retry a call to
+          #   the `post_webhook_url` if the request times out (after 5 seconds) or it receives
+          #   a 429, 503, or 504 HTTP response. The default is 0, which means the call won't
+          #   be retried.
+          # @param [Boolean] notifications_log_enabled Whether to log notifications. Can be:
+          #   `true` or `false` and the default is `false`.
           # @return [ServiceInstance] Updated ServiceInstance
           def update(friendly_name: :unset, default_service_role_sid: :unset, default_channel_role_sid: :unset, default_channel_creator_role_sid: :unset, read_status_enabled: :unset, reachability_enabled: :unset, typing_indicator_timeout: :unset, consumption_report_interval: :unset, notifications_new_message_enabled: :unset, notifications_new_message_template: :unset, notifications_new_message_sound: :unset, notifications_new_message_badge_count_enabled: :unset, notifications_added_to_channel_enabled: :unset, notifications_added_to_channel_template: :unset, notifications_added_to_channel_sound: :unset, notifications_removed_from_channel_enabled: :unset, notifications_removed_from_channel_template: :unset, notifications_removed_from_channel_sound: :unset, notifications_invited_to_channel_enabled: :unset, notifications_invited_to_channel_template: :unset, notifications_invited_to_channel_sound: :unset, pre_webhook_url: :unset, post_webhook_url: :unset, webhook_method: :unset, webhook_filters: :unset, limits_channel_members: :unset, limits_user_channels: :unset, media_compatibility_message: :unset, pre_webhook_retry_count: :unset, post_webhook_retry_count: :unset, notifications_log_enabled: :unset)
             data = Twilio::Values.of({
@@ -404,7 +430,8 @@ module Twilio
           # Initialize the ServiceInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The sid
+          # @param [String] sid The Twilio-provided string that uniquely identifies the
+          #   Service resource to fetch.
           # @return [ServiceInstance] ServiceInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -453,139 +480,139 @@ module Twilio
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this resource.
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The unique id of the Account responsible for this service.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The human-readable name of this service.
+          # @return [String] The string that you assigned to describe the resource
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [Time] The date that this resource was created
+          # @return [Time] The RFC 2822 date and time in GMT when the resource was created
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date that this resource was last updated
+          # @return [Time] The RFC 2822 date and time in GMT when the resource was last updated
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] The service role assigned to users when they are added to the service.
+          # @return [String] The service role assigned to users when they are added to the service
           def default_service_role_sid
             @properties['default_service_role_sid']
           end
 
           ##
-          # @return [String] The channel role assigned to users when they are added to a channel.
+          # @return [String] The channel role assigned to users when they are added to a channel
           def default_channel_role_sid
             @properties['default_channel_role_sid']
           end
 
           ##
-          # @return [String] The channel role assigned to a channel creator when joining a new channel.
+          # @return [String] The channel role assigned to a channel creator when they join a new channel
           def default_channel_creator_role_sid
             @properties['default_channel_creator_role_sid']
           end
 
           ##
-          # @return [Boolean] Enable the Message Consumption Horizon feature.
+          # @return [Boolean] Whether the Message Consumption Horizon feature is enabled
           def read_status_enabled
             @properties['read_status_enabled']
           end
 
           ##
-          # @return [Boolean] Indicates whether the  the Reachability feature is enabled for this Service instance.
+          # @return [Boolean] Whether the Reachability Indicator feature is enabled for this Service instance
           def reachability_enabled
             @properties['reachability_enabled']
           end
 
           ##
-          # @return [String] The amount of time in seconds after a "started typing" event when clients should assume that user is no longer typing, even if no "ended typing" message was received.
+          # @return [String] How long in seconds to wait before assuming the user is no longer typing
           def typing_indicator_timeout
             @properties['typing_indicator_timeout']
           end
 
           ##
-          # @return [String] DEPRECATED.
+          # @return [String] DEPRECATED
           def consumption_report_interval
             @properties['consumption_report_interval']
           end
 
           ##
-          # @return [Hash] Configuration for service instance level limits.
+          # @return [Hash] An object that describes the limits of the service instance
           def limits
             @properties['limits']
           end
 
           ##
-          # @return [String] The webhook URL for PRE-Event webhooks.
+          # @return [String] The webhook URL for pre-event webhooks
           def pre_webhook_url
             @properties['pre_webhook_url']
           end
 
           ##
-          # @return [String] The webhook URL for POST-Event webhooks.
+          # @return [String] The URL for post-event webhooks
           def post_webhook_url
             @properties['post_webhook_url']
           end
 
           ##
-          # @return [String] The webhook request format to use for both PRE and POST webhooks.
+          # @return [String] The HTTP method  to use for both PRE and POST webhooks
           def webhook_method
             @properties['webhook_method']
           end
 
           ##
-          # @return [String] The list of WebHook events that are enabled for this Service instance.
+          # @return [String] The list of WebHook events that are enabled for this Service instance
           def webhook_filters
             @properties['webhook_filters']
           end
 
           ##
-          # @return [String] Count of times webhook will be retried in case of timeout or 429/503/504 HTTP responses.
+          # @return [String] Count of times webhook will be retried in case of timeout or 429/503/504 HTTP responses
           def pre_webhook_retry_count
             @properties['pre_webhook_retry_count']
           end
 
           ##
-          # @return [String] Count of times webhook will be retried in case of timeout or 429/503/504 HTTP responses.
+          # @return [String] The number of times calls to the `post_webhook_url` will be retried
           def post_webhook_retry_count
             @properties['post_webhook_retry_count']
           end
 
           ##
-          # @return [Hash] Notification configuration for the Service instance.
+          # @return [Hash] The notification configuration for the Service instance
           def notifications
             @properties['notifications']
           end
 
           ##
-          # @return [Hash] The media
+          # @return [Hash] The properties of the media that the service supports
           def media
             @properties['media']
           end
 
           ##
-          # @return [String] An absolute URL for this service.
+          # @return [String] The absolute URL of the Service resource
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] URLs to access the Channels, Roles, and Users for this service.
+          # @return [String] The absolute URLs of the Service's Channels, Roles, and Users
           def links
             @properties['links']
           end
@@ -606,71 +633,95 @@ module Twilio
 
           ##
           # Update the ServiceInstance
-          # @param [String] friendly_name Human-readable name for this service instance
-          # @param [String] default_service_role_sid The default_service_role_sid
-          # @param [String] default_channel_role_sid Channel role assigned on channel join
-          #   (see [Roles](https://www.twilio.com/docs/chat/api/roles) data model for the
-          #   details)
-          # @param [String] default_channel_creator_role_sid Channel role assigned to
-          #   creator of channel when joining for first time
-          # @param [Boolean] read_status_enabled `true` if the member read status feature is
-          #   enabled, `false` if not.  Defaults to `true`.
-          # @param [Boolean] reachability_enabled `true` if the reachability feature should
-          #   be enabled.  Defaults to `false`
-          # @param [String] typing_indicator_timeout The duration in seconds indicating the
-          #   timeout after "started typing" event when client should assume that user is not
-          #   typing anymore even if no "ended typing" message received
-          # @param [String] consumption_report_interval The consumption_report_interval
-          # @param [Boolean] notifications_new_message_enabled The
-          #   notifications.new_message.enabled
-          # @param [String] notifications_new_message_template The
-          #   notifications.new_message.template
-          # @param [String] notifications_new_message_sound The
-          #   notifications.new_message.sound
-          # @param [Boolean] notifications_new_message_badge_count_enabled The
-          #   notifications.new_message.badge_count_enabled
-          # @param [Boolean] notifications_added_to_channel_enabled The
-          #   notifications.added_to_channel.enabled
-          # @param [String] notifications_added_to_channel_template The
-          #   notifications.added_to_channel.template
-          # @param [String] notifications_added_to_channel_sound The
-          #   notifications.added_to_channel.sound
-          # @param [Boolean] notifications_removed_from_channel_enabled The
-          #   notifications.removed_from_channel.enabled
-          # @param [String] notifications_removed_from_channel_template The
-          #   notifications.removed_from_channel.template
-          # @param [String] notifications_removed_from_channel_sound The
-          #   notifications.removed_from_channel.sound
-          # @param [Boolean] notifications_invited_to_channel_enabled The
-          #   notifications.invited_to_channel.enabled
-          # @param [String] notifications_invited_to_channel_template The
-          #   notifications.invited_to_channel.template
-          # @param [String] notifications_invited_to_channel_sound The
-          #   notifications.invited_to_channel.sound
-          # @param [String] pre_webhook_url The webhook URL for PRE-Event webhooks. See
-          #   [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more
-          #   details.
-          # @param [String] post_webhook_url The webhook URL for POST-Event webhooks. See
-          #   [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more
-          #   details.
-          # @param [String] webhook_method The webhook request format to use.  Must be POST
-          #   or GET. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events)
-          #   for more details.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource.
+          # @param [String] default_service_role_sid The service role assigned to users when
+          #   they are added to the service. See the [Roles
+          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          # @param [String] default_channel_role_sid The channel role assigned to users when
+          #   they are added to a channel. See the [Roles
+          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          # @param [String] default_channel_creator_role_sid The channel role assigned to a
+          #   channel creator when they join a new channel. See the [Roles
+          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          # @param [Boolean] read_status_enabled Whether to enable the [Message Consumption
+          #   Horizon](https://www.twilio.com/docs/chat/consumption-horizon) feature. The
+          #   default is `true`.
+          # @param [Boolean] reachability_enabled Whether to enable the [Reachability
+          #   Indicator](https://www.twilio.com/docs/chat/reachability-indicator) for this
+          #   Service instance. The default is `false`.
+          # @param [String] typing_indicator_timeout How long in seconds after a `started
+          #   typing` event until clients should assume that user is no longer typing, even if
+          #   no `ended typing` message was received.  The default is 5 seconds.
+          # @param [String] consumption_report_interval DEPRECATED. The interval in seconds
+          #   between consumption reports submission batches from client endpoints.
+          # @param [Boolean] notifications_new_message_enabled Whether to send a
+          #   notification when a new message is added to a channel. Can be: `true` or `false`
+          #   and the default is `false`.
+          # @param [String] notifications_new_message_template The template to use to create
+          #   the notification text displayed when a new message is added to a channel and
+          #   `notifications.new_message.enabled` is `true`.
+          # @param [String] notifications_new_message_sound The name of the sound to play
+          #   when a new message is added to a channel and `notifications.new_message.enabled`
+          #   is `true`.
+          # @param [Boolean] notifications_new_message_badge_count_enabled Whether the new
+          #   message badge is enabled. Can be: `true` or `false` and the default is `false`.
+          # @param [Boolean] notifications_added_to_channel_enabled Whether to send a
+          #   notification when a member is added to a channel. Can be: `true` or `false` and
+          #   the default is `false`.
+          # @param [String] notifications_added_to_channel_template The template to use to
+          #   create the notification text displayed when a member is added to a channel and
+          #   `notifications.added_to_channel.enabled` is `true`.
+          # @param [String] notifications_added_to_channel_sound The name of the sound to
+          #   play when a member is added to a channel and
+          #   `notifications.added_to_channel.enabled` is `true`.
+          # @param [Boolean] notifications_removed_from_channel_enabled Whether to send a
+          #   notification to a user when they are removed from a channel. Can be: `true` or
+          #   `false` and the default is `false`.
+          # @param [String] notifications_removed_from_channel_template The template to use
+          #   to create the notification text displayed to a user when they are removed from a
+          #   channel and `notifications.removed_from_channel.enabled` is `true`.
+          # @param [String] notifications_removed_from_channel_sound The name of the sound
+          #   to play to a user when they are removed from a channel and
+          #   `notifications.removed_from_channel.enabled` is `true`.
+          # @param [Boolean] notifications_invited_to_channel_enabled Whether to send a
+          #   notification when a user is invited to a channel. Can be: `true` or `false` and
+          #   the default is `false`.
+          # @param [String] notifications_invited_to_channel_template The template to use to
+          #   create the notification text displayed when a user is invited to a channel and
+          #   `notifications.invited_to_channel.enabled` is `true`.
+          # @param [String] notifications_invited_to_channel_sound The name of the sound to
+          #   play when a user is invited to a channel and
+          #   `notifications.invited_to_channel.enabled` is `true`.
+          # @param [String] pre_webhook_url The URL for pre-event webhooks, which are called
+          #   by using the `webhook_method`. See [Webhook
+          #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
+          # @param [String] post_webhook_url The URL for post-event webhooks, which are
+          #   called by using the `webhook_method`. See [Webhook
+          #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
+          # @param [String] webhook_method The HTTP method to use for calls to the
+          #   `pre_webhook_url` and `post_webhook_url` webhooks.  Can be: `POST` or `GET` and
+          #   the default is `POST`. See [Webhook
+          #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
           # @param [String] webhook_filters The list of WebHook events that are enabled for
           #   this Service instance. See [Webhook
           #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
           # @param [String] limits_channel_members The maximum number of Members that can be
-          #   added to Channels within this Service.  The maximum allowed value is 1,000
+          #   added to Channels within this Service. Can be up to 1,000.
           # @param [String] limits_user_channels The maximum number of Channels Users can be
-          #   a Member of within this Service.  The maximum value allowed is 1,000
-          # @param [String] media_compatibility_message The media.compatibility_message
-          # @param [String] pre_webhook_retry_count Count of times webhook will be retried
-          #   in case of timeout (5 seconds) or 429/503/504 HTTP responses. Default retry
-          #   count is 0 times.
-          # @param [String] post_webhook_retry_count Count of times webhook will be retried
-          #   in case of timeout (5 seconds) or 429/503/504 HTTP responses. Default retry
-          #   count is 0 times.
-          # @param [Boolean] notifications_log_enabled The notifications.log_enabled
+          #   a Member of within this Service. Can be up to 1,000.
+          # @param [String] media_compatibility_message The message to send when a media
+          #   message has no text. Can be used as placeholder message.
+          # @param [String] pre_webhook_retry_count The number of times to retry a call to
+          #   the `pre_webhook_url` if the request times out (after 5 seconds) or it receives
+          #   a 429, 503, or 504 HTTP response. Default retry count is 0 times, which means
+          #   the call won't be retried.
+          # @param [String] post_webhook_retry_count The number of times to retry a call to
+          #   the `post_webhook_url` if the request times out (after 5 seconds) or it receives
+          #   a 429, 503, or 504 HTTP response. The default is 0, which means the call won't
+          #   be retried.
+          # @param [Boolean] notifications_log_enabled Whether to log notifications. Can be:
+          #   `true` or `false` and the default is `false`.
           # @return [ServiceInstance] Updated ServiceInstance
           def update(friendly_name: :unset, default_service_role_sid: :unset, default_channel_role_sid: :unset, default_channel_creator_role_sid: :unset, read_status_enabled: :unset, reachability_enabled: :unset, typing_indicator_timeout: :unset, consumption_report_interval: :unset, notifications_new_message_enabled: :unset, notifications_new_message_template: :unset, notifications_new_message_sound: :unset, notifications_new_message_badge_count_enabled: :unset, notifications_added_to_channel_enabled: :unset, notifications_added_to_channel_template: :unset, notifications_added_to_channel_sound: :unset, notifications_removed_from_channel_enabled: :unset, notifications_removed_from_channel_template: :unset, notifications_removed_from_channel_sound: :unset, notifications_invited_to_channel_enabled: :unset, notifications_invited_to_channel_template: :unset, notifications_invited_to_channel_sound: :unset, pre_webhook_url: :unset, post_webhook_url: :unset, webhook_method: :unset, webhook_filters: :unset, limits_channel_members: :unset, limits_user_channels: :unset, media_compatibility_message: :unset, pre_webhook_retry_count: :unset, post_webhook_retry_count: :unset, notifications_log_enabled: :unset)
             context.update(