twilio-ruby 5.39.2 → 5.39.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71776e4fa40a71f0bbf50c4a47df1ba6f61d4cc803ced22a977db622fd2d1414
-  data.tar.gz: e9e0e1169bc3d9983393b937b6b1921aba4a64808c2350400df8070a2299a04c
+  metadata.gz: 841eb384db83b5c1a3a721c97098684d75d6d5b1ffb859131406d021a4622979
+  data.tar.gz: 7947f0f1a27572f6fc89029d822b58e91c7f27e60f04382a396677afdad1155c
 SHA512:
-  metadata.gz: ae3e0865ab57e2b34268fbc5eccbd246c92515e3665d55512becfacb45e7bd509251ca43fba9d58ffd97a56535c6fcab0efb1c4d78cdff532b988ebe32b891ff
-  data.tar.gz: d36bfcb14b0746e0d8e299f7dc6e2d788a2fc4f2e61d7b7311f97204649a861ec8ed839851a2486bfcce7ab241020138b2e7c7de6ec2ae8af26a861bf554a945
+  metadata.gz: b87be38b318fd24a402aaadb4127a34813380889563b77f6b531bcb63d02990f4de2b68fbe10d76bcc1ce6c81889e31922533094efbeb2510b5653b7a52d5453
+  data.tar.gz: 1a054d5e499e9561aa6549dcf63b93da6890e34e99d0449ad8d61bd3cfbde7f79cc4e4c61e0d58a51a463fe735a708b46b38cd264c7f8f4f1d0d1ce6b5c6bd8b

data/.travis.yml

@@ -36,7 +36,7 @@ deploy:
 
 notifications:
   slack:
-    if: branch = master
+    if: branch = main
     on_pull_requests: false
     on_success: never
     on_failure: change

data/CHANGES.md

@@ -1,6 +1,20 @@
 twilio-ruby changelog
 =====================
 
+[2020-08-05] Version 5.39.3
+---------------------------
+**Messaging**
+- Add rejection reason support to WhatsApp API
+- Removed status parameter for create and update in WhatsApp Templates API
+
+**Proxy**
+- Add FailOnParticipantConflict param to Proxy Session update
+
+**Verify**
+- Add `CustomFriendlyName` optional parameter on Verification creation.
+- Changes in `Challenge` resource to update documentation of both `details` and `hidden_details` properties.
+
+
 [2020-07-22] Version 5.39.2
 ---------------------------
 **Api**

data/ISSUE_TEMPLATE.md

@@ -1,5 +1,9 @@
 <!--
 If this is a feature request, make sure you search Issues for an existing request before creating a new one!
+
+Please utilize the template below to help us resolve your issue.
+
+Note that many issues can be resolved by updating to the latest version.
 -->
 
 ### Issue Summary
@@ -21,6 +25,6 @@ A summary of the issue and the environment in which it occurs. If suitable, incl
 ```
 
 ### Technical details:
-* twilio-ruby version:
+* twilio-ruby version: 
 * ruby version:
 

data/PULL_REQUEST_TEMPLATE.md

@@ -23,7 +23,7 @@ A short description of what this PR does.
 - [ ] I have made a material change to the repo (functionality, testing, spelling, grammar)
 - [ ] I have read the [Contribution Guidelines](CONTRIBUTING.md) and my PR follows them
 - [ ] I have titled the PR appropriately
-- [ ] I have updated my branch with the master branch
+- [ ] I have updated my branch with the main branch
 - [ ] I have added tests that prove my fix is effective or that my feature works
 - [ ] I have added necessary documentation about the functionality in the appropriate .md file
 - [ ] I have added inline documentation to the code I modified

data/README.md

@@ -4,6 +4,8 @@
 [![Gem Version](https://img.shields.io/gem/v/twilio-ruby.svg)](https://rubygems.org/gems/twilio-ruby)
 [![Learn with TwilioQuest](https://img.shields.io/static/v1?label=TwilioQuest&message=Learn%20to%20contribute%21&color=F22F46&labelColor=1f243c&style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAMAAAD04JH5AAAASFBMVEUAAAAZGRkcHBwjIyMoKCgAAABgYGBoaGiAgICMjIyzs7PJycnMzMzNzc3UoBfd3d3m5ubqrhfrMEDu7u739/f4vSb/3AD///9tbdyEAAAABXRSTlMAAAAAAMJrBrEAAAKoSURBVHgB7ZrRcuI6EESdyxXGYoNFvMD//+l2bSszRgyUYpFAsXOeiJGmj4NkuWx1Qeh+Ekl9DgEXOBwOx+Px5xyQhDykfgq4wG63MxxaR4ddIkg6Ul3g84vCIcjPBA5gmUMeXESrlukuoK33+33uID8TWeLAdOWsKpJYzwVMB7bOzYSGOciyUlXSn0/ABXTosJ1M1SbypZ4O4MbZuIDMU02PMbauhhHMHXbmebmALIiEbbbbbUrpF1gwE9kFfRNAJaP+FQEXCCTGyJ4ngDrjOFo3jEL5JdqjF/pueR4cCeCGgAtwmuRS6gDwaRiGvu+DMFwSBLTE3+jF8JyuV1okPZ+AC4hDFhCHyHQjdjPHUKFDlHSJkHQXMB3KpSwXNGJPcwwTdZiXlRN0gSp0zpWxNtM0beYE0nRH6QIbO7rawwXaBYz0j78gxjokDuv12gVeUuBD0MDi0OQCLvDaAho4juP1Q/jkAncXqIcCfd+7gAu4QLMACCLxpRsSuQh0igu0C9Svhi7weAGZg50L3IE3cai4IfkNZAC8dfdhsUD3CgKBVC9JE5ABAFzg4QL/taYPAAWrHdYcgfLaIgAXWJ7OV38n1LEF8tt2TH29E+QAoDoO5Ve/LtCQDmKM9kPbvCEBApK+IXzbcSJ0cIGF6e8gpcRhUDogWZ8JnaWjPXc/fNnBBUKRngiHgTUSivSzDRDgHZQOLvBQgf8rRt+VdBUUhwkU6VpJ+xcOwQUqZr+mR0kvBUgv6cB4+37hQAkXqE8PwGisGhJtN4xAHMzrsgvI7rccXqSvKh6jltGlrOHA3Xk1At3LC4QiPdX9/0ndHpGVvTjR4bZA1ypAKgVcwE5vx74ulwIugDt8e/X7JgfkucBMIAr26ndnB4UCLnDOqvteQsHlgX9N4A+c4cW3DXSPbwAAAABJRU5ErkJggg==)](https://twil.io/learn-open-source)
 
+**The default branch name for this repository has been changed to `main` as of 07/27/2020.**
+
 ## Documentation
 
 The documentation for the Twilio API can be found [here][apidocs].
@@ -32,13 +34,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.39.2'
+gem 'twilio-ruby', '~> 5.39.3'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.39.2
+gem install twilio-ruby -v 5.39.3
 ```
 
 To build and install the development branch yourself from the latest source:

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

@@ -36,50 +36,59 @@ module Twilio
 
               ##
               # Create the PaymentInstance
-              # @param [String] idempotency_key A unique token for each payment session that
-              #   should be provided to maintain idempotency of the session.
-              # @param [String] status_callback The URL we should call using the
-              #   `status_callback` to send status information of payment session.
-              # @param [payment.BankAccountType] bank_account_type If Payment source is ACH,
-              #   type of bank account. Can be: `consumer-checking`, `consumer-savings`,
+              # @param [String] idempotency_key A unique token that will be used to ensure that
+              #   multiple API calls with the same information do not result in multiple
+              #   transactions. This should be a unique string value per API call and can be a
+              #   randomly generated.
+              # @param [String] status_callback Provide an absolute or relative URL to receive
+              #   status updates regarding your Pay session. Read more about the [expected
+              #   StatusCallback
+              #   values](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback)
+              # @param [payment.BankAccountType] bank_account_type Type of bank account if
+              #   payment source is ACH. One of `consumer-checking`, `consumer-savings`, or
               #   `commercial-checking`. The default value is `consumer-checking`.
-              # @param [String] charge_amount If this field is present and greater than `0.0`
-              #   payment source will be charged. Otherwise payment source will be tokenized.
-              # @param [String] currency Currency `charge_amount` is in. It's format should be
-              #   as specified in [ISO
+              # @param [String] charge_amount A positive decimal value less than 1,000,000 to
+              #   charge against the credit card or bank account. Default currency can be
+              #   overwritten with `currency` field. Leave blank or set to 0 to tokenize.
+              # @param [String] currency The currency of the `charge_amount`, formatted as [ISO
               #   4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format. The
-              #   default value is `USD`.
-              # @param [String] description Decription of the charge.
-              # @param [String] input Kind of medium customer would enter payment source
-              #   information in. Currently only 'DTMF' is supported, which means customer would
-              #   use keypad of their phone to enter card number etc.
-              # @param [String] min_postal_code_length If postal code is expected, minimum
-              #   length of the postal code. When user enters postal code, this value will be used
-              #   to validate.
-              # @param [Hash] parameter Additonal data to be sent over to payment provider. It
-              #   has to be a JSON string with only one level object. This parameter can be used
-              #   to send information such as customer name, phone number etc. Refer to specific
-              #   payment provider's documentation in Twilio console for supported
-              #   names/values/format.
-              # @param [String] payment_connector Payment connector that you would like Twilio
-              #   to use for processing payments. The default value is `Default`, which means you
-              #   need to have at least one payment connector configured in Twilio with name
-              #   'Default'. If not you must provide connector configuration name here.
-              # @param [payment.PaymentMethod] payment_method Payment source type. Can be:
-              #   `credit-card`, `ach-debit`. The default value is `credit-card`.
-              # @param [Boolean] postal_code Whether to expect postal code during payment source
-              #   data gathering. Can be: `true`, `false`. The default value is `true`.
-              # @param [Boolean] security_code Whether to expect security code during payment
-              #   source data gathering. Can be: `true`, `false`. The default value is `true`.
-              # @param [String] timeout The number of seconds that we should allow customer to
-              #   enter payment information. Can be an integer between `5` and `600`, inclusive.
-              #   The default value is `5`.
-              # @param [payment.TokenType] token_type If tokenization of payment source is
-              #   desired, this represents type of token. Can be: `one-time`, `reusable`. The
-              #   default value is `reusable`.
-              # @param [String] valid_card_types List of card types accepted with each card
-              #   types separated by space. Can be:
-              #   `visa`,`nmastercard`,`amex`,`maestro`,`discover`,`optima`,`jcb`,`diners-club`,`enroute`. The default value is `visa mastercard amex`.
+              #   default value is `USD` and all values allowed from the <Pay> Connector are
+              #   accepted.
+              # @param [String] description The description can be used to provide more details
+              #   regarding the transaction. This information is submitted along with the payment
+              #   details to the Payment Connector which are then posted on the transactions.
+              # @param [String] input A list of inputs that should be accepted. Currently only
+              #   `dtmf` is supported. All digits captured during a pay session are redacted from
+              #   the logs.
+              # @param [String] min_postal_code_length A positive integer that is used to
+              #   validate the length of the `PostalCode` inputted by the user. User must enter
+              #   this many digits.
+              # @param [Hash] parameter A single level JSON string that is required when
+              #   accepting certain information specific only to ACH payments. The information
+              #   that has to be included here depends on the <Pay> Connector. [Read
+              #   more](https://www.twilio.com/console/voice/pay-connectors).
+              # @param [String] payment_connector This is the unique name corresponding to the
+              #   Payment Gateway Connector installed in the Twilio Add-ons. Learn more about
+              #   [<Pay> Connectors](https://www.twilio.com/console/voice/pay-connectors). The
+              #   default value is `Default`.
+              # @param [payment.PaymentMethod] payment_method Type of payment being captured.
+              #   One of `credit-card` or `ach-debit`. The default value is `credit-card`.
+              # @param [Boolean] postal_code Indicates whether the credit card postal code (zip
+              #   code) is a required piece of payment information that must be provided by the
+              #   caller. The default is `true`.
+              # @param [Boolean] security_code Indicates whether the credit card security code
+              #   is a required piece of payment information that must be provided by the caller.
+              #   The default is `true`.
+              # @param [String] timeout The number of seconds that <Pay> should wait for the
+              #   caller to press a digit between each subsequent digit, after the first one,
+              #   before moving on to validate the digits captured. The default is `5`, maximum is
+              #   `600`.
+              # @param [payment.TokenType] token_type Indicates whether the payment method
+              #   should be tokenized as a `one-time` or `reusable` token. The default value is
+              #   `reusable`. Do not enter a charge amount when tokenizing. If a charge amount is
+              #   entered, the payment method will be charged and not tokenized.
+              # @param [String] valid_card_types Credit card types separated by space that Pay
+              #   should accept. The default value is `visa mastercard amex`
               # @return [PaymentInstance] Created PaymentInstance
               def create(idempotency_key: nil, status_callback: nil, bank_account_type: :unset, charge_amount: :unset, currency: :unset, description: :unset, input: :unset, min_postal_code_length: :unset, parameter: :unset, payment_connector: :unset, payment_method: :unset, postal_code: :unset, security_code: :unset, timeout: :unset, token_type: :unset, valid_card_types: :unset)
                 data = Twilio::Values.of({
@@ -177,15 +186,20 @@ module Twilio
 
               ##
               # Update the PaymentInstance
-              # @param [String] idempotency_key A unique token for each payment session that
-              #   should be provided to maintain idempotency of the session.
-              # @param [String] status_callback The URL we should call using the
-              #   `status_callback` to send status information of payment session.
-              # @param [payment.Capture] capture Specific payment source information to expect.
-              #   Can be:
-              #   `payment-card-number`,`expiration-date`,`security-code`,`postal-code`,`bank-routing-number`,`bank-account-number`.
-              # @param [payment.Status] status Instruction to complete or cancel the
-              #   transaction. Can be: `complete`, `cancel.`
+              # @param [String] idempotency_key A unique token that will be used to ensure that
+              #   multiple API calls with the same information do not result in multiple
+              #   transactions. This should be a unique string value per API call and can be a
+              #   randomly generated.
+              # @param [String] status_callback Provide an absolute or relative URL to receive
+              #   status updates regarding your Pay session. Read more about the
+              #   [Update](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-update) and [Complete/Cancel](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-cancelcomplete) POST requests.
+              # @param [payment.Capture] capture The piece of payment information that you wish
+              #   the caller to enter. Must be one of `payment-card-number`, `expiration-date`,
+              #   `security-code`, `postal-code`, `bank-routing-number`, or `bank-account-number`.
+              # @param [payment.Status] status Indicates whether the current payment session
+              #   should be cancelled or completed. When `cancel` the payment session is
+              #   cancelled. When `complete`, Twilio sends the payment information to the selected
+              #   <Pay> connector for processing.
               # @return [PaymentInstance] Updated PaymentInstance
               def update(idempotency_key: nil, status_callback: nil, capture: :unset, status: :unset)
                 data = Twilio::Values.of({
@@ -309,15 +323,20 @@ module Twilio
 
               ##
               # Update the PaymentInstance
-              # @param [String] idempotency_key A unique token for each payment session that
-              #   should be provided to maintain idempotency of the session.
-              # @param [String] status_callback The URL we should call using the
-              #   `status_callback` to send status information of payment session.
-              # @param [payment.Capture] capture Specific payment source information to expect.
-              #   Can be:
-              #   `payment-card-number`,`expiration-date`,`security-code`,`postal-code`,`bank-routing-number`,`bank-account-number`.
-              # @param [payment.Status] status Instruction to complete or cancel the
-              #   transaction. Can be: `complete`, `cancel.`
+              # @param [String] idempotency_key A unique token that will be used to ensure that
+              #   multiple API calls with the same information do not result in multiple
+              #   transactions. This should be a unique string value per API call and can be a
+              #   randomly generated.
+              # @param [String] status_callback Provide an absolute or relative URL to receive
+              #   status updates regarding your Pay session. Read more about the
+              #   [Update](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-update) and [Complete/Cancel](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-cancelcomplete) POST requests.
+              # @param [payment.Capture] capture The piece of payment information that you wish
+              #   the caller to enter. Must be one of `payment-card-number`, `expiration-date`,
+              #   `security-code`, `postal-code`, `bank-routing-number`, or `bank-account-number`.
+              # @param [payment.Status] status Indicates whether the current payment session
+              #   should be cancelled or completed. When `cancel` the payment session is
+              #   cancelled. When `complete`, Twilio sends the payment information to the selected
+              #   <Pay> connector for processing.
               # @return [PaymentInstance] Updated PaymentInstance
               def update(idempotency_key: nil, status_callback: nil, capture: :unset, status: :unset)
                 context.update(

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

@@ -322,6 +322,7 @@ module Twilio
                     'status_callback_method' => payload['status_callback_method'],
                     'trunk_sid' => payload['trunk_sid'],
                     'uri' => payload['uri'],
+                    'voice_receive_mode' => payload['voice_receive_mode'],
                     'voice_application_sid' => payload['voice_application_sid'],
                     'voice_caller_id_lookup' => payload['voice_caller_id_lookup'],
                     'voice_fallback_method' => payload['voice_fallback_method'],
@@ -331,6 +332,7 @@ module Twilio
                     'emergency_status' => payload['emergency_status'],
                     'emergency_address_sid' => payload['emergency_address_sid'],
                     'bundle_sid' => payload['bundle_sid'],
+                    'status' => payload['status'],
                 }
               end
 
@@ -466,6 +468,12 @@ module Twilio
                 @properties['uri']
               end
 
+              ##
+              # @return [local.VoiceReceiveMode] The voice_receive_mode
+              def voice_receive_mode
+                @properties['voice_receive_mode']
+              end
+
               ##
               # @return [String] The SID of the application that handles calls to the phone number
               def voice_application_sid
@@ -520,6 +528,12 @@ module Twilio
                 @properties['bundle_sid']
               end
 
+              ##
+              # @return [String] The status
+              def status
+                @properties['status']
+              end
+
               ##
               # Provide a user friendly representation
               def to_s

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

@@ -321,6 +321,7 @@ module Twilio
                     'status_callback_method' => payload['status_callback_method'],
                     'trunk_sid' => payload['trunk_sid'],
                     'uri' => payload['uri'],
+                    'voice_receive_mode' => payload['voice_receive_mode'],
                     'voice_application_sid' => payload['voice_application_sid'],
                     'voice_caller_id_lookup' => payload['voice_caller_id_lookup'],
                     'voice_fallback_method' => payload['voice_fallback_method'],
@@ -330,6 +331,7 @@ module Twilio
                     'emergency_status' => payload['emergency_status'],
                     'emergency_address_sid' => payload['emergency_address_sid'],
                     'bundle_sid' => payload['bundle_sid'],
+                    'status' => payload['status'],
                 }
               end
 
@@ -465,6 +467,12 @@ module Twilio
                 @properties['uri']
               end
 
+              ##
+              # @return [mobile.VoiceReceiveMode] The voice_receive_mode
+              def voice_receive_mode
+                @properties['voice_receive_mode']
+              end
+
               ##
               # @return [String] The SID of the application that handles calls to the phone number
               def voice_application_sid
@@ -519,6 +527,12 @@ module Twilio
                 @properties['bundle_sid']
               end
 
+              ##
+              # @return [String] The status
+              def status
+                @properties['status']
+              end
+
               ##
               # Provide a user friendly representation
               def to_s

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

@@ -321,6 +321,7 @@ module Twilio
                     'status_callback_method' => payload['status_callback_method'],
                     'trunk_sid' => payload['trunk_sid'],
                     'uri' => payload['uri'],
+                    'voice_receive_mode' => payload['voice_receive_mode'],
                     'voice_application_sid' => payload['voice_application_sid'],
                     'voice_caller_id_lookup' => payload['voice_caller_id_lookup'],
                     'voice_fallback_method' => payload['voice_fallback_method'],
@@ -330,6 +331,7 @@ module Twilio
                     'emergency_status' => payload['emergency_status'],
                     'emergency_address_sid' => payload['emergency_address_sid'],
                     'bundle_sid' => payload['bundle_sid'],
+                    'status' => payload['status'],
                 }
               end
 
@@ -465,6 +467,12 @@ module Twilio
                 @properties['uri']
               end
 
+              ##
+              # @return [toll_free.VoiceReceiveMode] The voice_receive_mode
+              def voice_receive_mode
+                @properties['voice_receive_mode']
+              end
+
               ##
               # @return [String] The SID of the application that handles calls to the phone number
               def voice_application_sid
@@ -519,6 +527,12 @@ module Twilio
                 @properties['bundle_sid']
               end
 
+              ##
+              # @return [String] The status
+              def status
+                @properties['status']
+              end
+
               ##
               # Provide a user friendly representation
               def to_s

data/lib/twilio-ruby/rest/proxy/v1/service/session.rb

@@ -230,12 +230,21 @@ module Twilio
             #   is measured from the last Session create or the Session's last Interaction.
             # @param [session.Status] status The new status of the resource. Can be:
             #   `in-progress` to re-open a session or `closed` to close a session.
+            # @param [Boolean] fail_on_participant_conflict Setting to true (recommended),
+            #   enables Proxy to return a 400 error (Twilio error code 80604) when a request to
+            #   set a Session to in-progress would cause Participants with the same
+            #   identifier/proxy_identifier pair to be active in multiple Sessions. If not
+            #   provided, or if set to false, requests will be allowed to succeed and a Debugger
+            #   event (80801) will be emitted. This causes calls and messages from affected
+            #   Participants to be routed incorrectly. Please note, in a future release, the
+            #   default behavior will be to reject the request with a 400 error.
             # @return [SessionInstance] Updated SessionInstance
-            def update(date_expiry: :unset, ttl: :unset, status: :unset)
+            def update(date_expiry: :unset, ttl: :unset, status: :unset, fail_on_participant_conflict: :unset)
               data = Twilio::Values.of({
                   'DateExpiry' => Twilio.serialize_iso8601_datetime(date_expiry),
                   'Ttl' => ttl,
                   'Status' => status,
+                  'FailOnParticipantConflict' => fail_on_participant_conflict,
               })
 
               payload = @version.update('POST', @uri, data: data)
@@ -473,9 +482,22 @@ module Twilio
             #   is measured from the last Session create or the Session's last Interaction.
             # @param [session.Status] status The new status of the resource. Can be:
             #   `in-progress` to re-open a session or `closed` to close a session.
+            # @param [Boolean] fail_on_participant_conflict Setting to true (recommended),
+            #   enables Proxy to return a 400 error (Twilio error code 80604) when a request to
+            #   set a Session to in-progress would cause Participants with the same
+            #   identifier/proxy_identifier pair to be active in multiple Sessions. If not
+            #   provided, or if set to false, requests will be allowed to succeed and a Debugger
+            #   event (80801) will be emitted. This causes calls and messages from affected
+            #   Participants to be routed incorrectly. Please note, in a future release, the
+            #   default behavior will be to reject the request with a 400 error.
             # @return [SessionInstance] Updated SessionInstance
-            def update(date_expiry: :unset, ttl: :unset, status: :unset)
-              context.update(date_expiry: date_expiry, ttl: ttl, status: status, )
+            def update(date_expiry: :unset, ttl: :unset, status: :unset, fail_on_participant_conflict: :unset)
+              context.update(
+                  date_expiry: date_expiry,
+                  ttl: ttl,
+                  status: status,
+                  fail_on_participant_conflict: fail_on_participant_conflict,
+              )
             end
 
             ##

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

@@ -47,10 +47,14 @@ module Twilio
           # @param [Boolean] custom_code_enabled Whether to allow sending verifications with
           #   a custom code instead of a randomly generated one. Not available for all
           #   customers.
-          # @param [Hash] push The optional service level push factors configuration. If
-          #   present it must be a json string with the following format:
+          # @param [Hash] push Configurations for the Push factors (channel) created under
+          #   this Service. If present, it must be a json string with the following format:
           #   {"notify_service_sid": "ISXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "include_date":
-          #   true}
+          #   true}. If `include_date` is set to `true`, which is the default, that means that
+          #   the push challenge’s response will include the date created value. If
+          #   `include_date` is set to `false`, then the date created value will not be
+          #   included. See [Challenge](https://www.twilio.com/docs/verify/api/challenge)
+          #   resource’s details parameter for more info
           # @return [ServiceInstance] Created ServiceInstance
           def create(friendly_name: nil, code_length: :unset, lookup_enabled: :unset, skip_sms_to_landlines: :unset, dtmf_input_required: :unset, tts_name: :unset, psd2_enabled: :unset, do_not_share_warning_enabled: :unset, custom_code_enabled: :unset, push: :unset)
             data = Twilio::Values.of({
@@ -249,10 +253,14 @@ module Twilio
           # @param [Boolean] custom_code_enabled Whether to allow sending verifications with
           #   a custom code instead of a randomly generated one. Not available for all
           #   customers.
-          # @param [Hash] push The optional service level push factors configuration. If
-          #   present it must be a json string with the following format:
+          # @param [Hash] push Configurations for the Push factors (channel) created under
+          #   this Service. If present, it must be a json string with the following format:
           #   {"notify_service_sid": "ISXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "include_date":
-          #   true}
+          #   true}. If `include_date` is set to `true`, which is the default, that means that
+          #   the push challenge’s response will include the date created value. If
+          #   `include_date` is set to `false`, then the date created value will not be
+          #   included. See [Challenge](https://www.twilio.com/docs/verify/api/challenge)
+          #   resource’s details parameter for more info
           # @return [ServiceInstance] Updated ServiceInstance
           def update(friendly_name: :unset, code_length: :unset, lookup_enabled: :unset, skip_sms_to_landlines: :unset, dtmf_input_required: :unset, tts_name: :unset, psd2_enabled: :unset, do_not_share_warning_enabled: :unset, custom_code_enabled: :unset, push: :unset)
             data = Twilio::Values.of({
@@ -581,10 +589,14 @@ module Twilio
           # @param [Boolean] custom_code_enabled Whether to allow sending verifications with
           #   a custom code instead of a randomly generated one. Not available for all
           #   customers.
-          # @param [Hash] push The optional service level push factors configuration. If
-          #   present it must be a json string with the following format:
+          # @param [Hash] push Configurations for the Push factors (channel) created under
+          #   this Service. If present, it must be a json string with the following format:
           #   {"notify_service_sid": "ISXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "include_date":
-          #   true}
+          #   true}. If `include_date` is set to `true`, which is the default, that means that
+          #   the push challenge’s response will include the date created value. If
+          #   `include_date` is set to `false`, then the date created value will not be
+          #   included. See [Challenge](https://www.twilio.com/docs/verify/api/challenge)
+          #   resource’s details parameter for more info
           # @return [ServiceInstance] Updated ServiceInstance
           def update(friendly_name: :unset, code_length: :unset, lookup_enabled: :unset, skip_sms_to_landlines: :unset, dtmf_input_required: :unset, tts_name: :unset, psd2_enabled: :unset, do_not_share_warning_enabled: :unset, custom_code_enabled: :unset, push: :unset)
             context.update(