twilio-ruby 5.27.0 → 5.27.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: baa7dce555a4ad4de4227461d7a72ec110497c8b
-  data.tar.gz: bbc2be81ddf4ba27d70771882365d9a7e6f37e1e
+SHA256:
+  metadata.gz: 3e83808d846b8e8beaef1ac91c237b5b4abc5836b04606faec7b47d1d360e9a3
+  data.tar.gz: ab8700209a80759c0a5c3572395d826cdac1896d3fccf69fae9b1a62f3792b17
 SHA512:
-  metadata.gz: a5346f6f6ca92b82f445cd38581da67d1db3fd3c4dd23b8e05c14a59473ce2bf6e4cc523b070bd747d01391ec14bb9c2219a4383eeba01878f7dc08c83e1edf0
-  data.tar.gz: 9c4308bdc71dc730ec1aee203759aa5d0c00f56889efe315d37b0e95cef5a0d0cc6e338923afd0ebbdba1fd6fcd0c0a511a64a2c31a733bfc60bae34d1b353eb
+  metadata.gz: a9e69978d25fd39b226689011b091e5084f3b6223712300a1200b31b344160c05de052dc8e43e8c3d7b0b60eb57f9072e45dfad77fd0239776be1bb204db84ce
+  data.tar.gz: 655550d2e0e1410a9ca6cf6db0c0a4c1612dc8123274c79d3b7ee447b5d7ce829f880fd7b6efb98ae0730999d0c1c0bb7338125af6a8c7c6136018adfe1edb6b

data/.dockerignore

@@ -0,0 +1 @@
+Gemfile.lock

data/CHANGES.md

@@ -1,6 +1,19 @@
 twilio-ruby changelog
 =====================
 
+[2019-10-02] Version 5.27.1
+---------------------------
+**Library**
+- [PR #473](https://github.com/twilio/twilio-ruby/pull/473): Wrap any Faraday error as a TwilioError. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #472](https://github.com/twilio/twilio-ruby/pull/472): Fix the Dockerfile to use the latest Ruby 2.4 and ignore the Gem lock file. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Conversations**
+- Add media to Conversations Message resource
+
+**Supersim**
+- Add List endpoint to Sims resource for Super Sim Pilot
+
+
 [2019-09-18] Version 5.27.0
 ----------------------------
 **Library**

data/CONTRIBUTING.md

@@ -11,6 +11,7 @@ even better than it is today! Here are the guidelines we'd like you to follow:
  - [Submission Guidelines](#submit)
  - [Coding Rules](#rules)
 
+
 ## <a name="coc"></a> Code of Conduct
 
 Help us keep `twilio-ruby` open and inclusive. Please be kind to and considerate
@@ -154,6 +155,7 @@ you are working:
 * All features or bug fixes **must be tested** by one or more tests.
 * All classes and methods **must be documented**.
 
+
 [docs-link]: https://www.twilio.com/docs/libraries/ruby
 [issue-link]: https://github.com/twilio/twilio-ruby/issues/new
 [github]: https://github.com/twilio/twilio-ruby

data/Dockerfile

@@ -1,9 +1,9 @@
-FROM ruby:2.4.0
+FROM ruby:2.4
 
 RUN mkdir /twilio
 WORKDIR /twilio
 
 COPY . .
 
-RUN bundle install 
+RUN bundle install
 RUN bundle exec rake install

data/README.md

@@ -29,13 +29,13 @@ in-line code documentation here in the library.
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.27.0'
+gem 'twilio-ruby', '~> 5.27.1'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.27.0
+gem install twilio-ruby -v 5.27.1
 ```
 
 To build and install the development branch yourself from the latest source:

data/lib/twilio-ruby/http/http_client.rb

@@ -54,7 +54,7 @@ module Twilio
         @connection.send(request.method.downcase.to_sym,
                          request.url,
                          request.method == 'GET' ? request.params : request.data)
-      rescue Faraday::ClientError => e
+      rescue Faraday::Error => e
         raise Twilio::REST::TwilioError, e
       end
 

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

@@ -187,12 +187,12 @@ module Twilio
             # @param [call.Status] status The status of the calls to include. Can be:
             #   `queued`, `ringing`, `in-progress`, `canceled`, `completed`, `failed`, `busy`,
             #   or `no-answer`.
-            # @param [Time] start_time_before Only include calls that started on or after this date
-            # @param [Time] start_time Only include calls that started on or after this date
-            # @param [Time] start_time_after Only include calls that started on or after this date
-            # @param [Time] end_time_before Only include usage that occurred on or before this date
-            # @param [Time] end_time Only include usage that occurred on or before this date
-            # @param [Time] end_time_after Only include usage that occurred on or before this date
+            # @param [Time] start_time_before Only include calls that started on this date
+            # @param [Time] start_time Only include calls that started on this date
+            # @param [Time] start_time_after Only include calls that started on this date
+            # @param [Time] end_time_before Only include calls that ended on this date
+            # @param [Time] end_time Only include calls that ended on this date
+            # @param [Time] end_time_after Only include calls that ended on this date
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -230,12 +230,12 @@ module Twilio
             # @param [call.Status] status The status of the calls to include. Can be:
             #   `queued`, `ringing`, `in-progress`, `canceled`, `completed`, `failed`, `busy`,
             #   or `no-answer`.
-            # @param [Time] start_time_before Only include calls that started on or after this date
-            # @param [Time] start_time Only include calls that started on or after this date
-            # @param [Time] start_time_after Only include calls that started on or after this date
-            # @param [Time] end_time_before Only include usage that occurred on or before this date
-            # @param [Time] end_time Only include usage that occurred on or before this date
-            # @param [Time] end_time_after Only include usage that occurred on or before this date
+            # @param [Time] start_time_before Only include calls that started on this date
+            # @param [Time] start_time Only include calls that started on this date
+            # @param [Time] start_time_after Only include calls that started on this date
+            # @param [Time] end_time_before Only include calls that ended on this date
+            # @param [Time] end_time Only include calls that ended on this date
+            # @param [Time] end_time_after Only include calls that ended on this date
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -289,12 +289,12 @@ module Twilio
             # @param [call.Status] status The status of the calls to include. Can be:
             #   `queued`, `ringing`, `in-progress`, `canceled`, `completed`, `failed`, `busy`,
             #   or `no-answer`.
-            # @param [Time] start_time_before Only include calls that started on or after this date
-            # @param [Time] start_time Only include calls that started on or after this date
-            # @param [Time] start_time_after Only include calls that started on or after this date
-            # @param [Time] end_time_before Only include usage that occurred on or before this date
-            # @param [Time] end_time Only include usage that occurred on or before this date
-            # @param [Time] end_time_after Only include usage that occurred on or before this date
+            # @param [Time] start_time_before Only include calls that started on this date
+            # @param [Time] start_time Only include calls that started on this date
+            # @param [Time] start_time_after Only include calls that started on this date
+            # @param [Time] end_time_before Only include calls that ended on this date
+            # @param [Time] end_time Only include calls that ended on this date
+            # @param [Time] end_time_after Only include calls that ended on this date
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
             # @param [Integer] page_size Number of records to return, defaults to 50

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

@@ -34,9 +34,9 @@ module Twilio
               # Lists MediaInstance records from the API as a list.
               # Unlike stream(), this operation is eager and will load `limit` records into
               # memory before returning.
-              # @param [Time] date_created_before The `YYYY-MM-DD` value of the resources to read
-              # @param [Time] date_created The `YYYY-MM-DD` value of the resources to read
-              # @param [Time] date_created_after The `YYYY-MM-DD` value of the resources to read
+              # @param [Time] date_created_before Only include media that was created on this date
+              # @param [Time] date_created Only include media that was created on this date
+              # @param [Time] date_created_after Only include media that was created on this date
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit.  Default is no limit
               # @param [Integer] page_size Number of records to fetch per request, when
@@ -58,9 +58,9 @@ module Twilio
               # Streams MediaInstance records from the API as an Enumerable.
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
-              # @param [Time] date_created_before The `YYYY-MM-DD` value of the resources to read
-              # @param [Time] date_created The `YYYY-MM-DD` value of the resources to read
-              # @param [Time] date_created_after The `YYYY-MM-DD` value of the resources to read
+              # @param [Time] date_created_before Only include media that was created on this date
+              # @param [Time] date_created Only include media that was created on this date
+              # @param [Time] date_created_after Only include media that was created on this date
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit. Default is no limit.
               # @param [Integer] page_size Number of records to fetch per request, when
@@ -98,9 +98,9 @@ module Twilio
               ##
               # Retrieve a single page of MediaInstance records from the API.
               # Request is executed immediately.
-              # @param [Time] date_created_before The `YYYY-MM-DD` value of the resources to read
-              # @param [Time] date_created The `YYYY-MM-DD` value of the resources to read
-              # @param [Time] date_created_after The `YYYY-MM-DD` value of the resources to read
+              # @param [Time] date_created_before Only include media that was created on this date
+              # @param [Time] date_created Only include media that was created on this date
+              # @param [Time] date_created_after Only include media that was created on this date
               # @param [String] page_token PageToken provided by the API
               # @param [Integer] page_number Page Number, this value is simply for client state
               # @param [Integer] page_size Number of records to return, defaults to 50

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

@@ -31,9 +31,9 @@ module Twilio
             # Lists RecordingInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [Time] date_created_before The `YYYY-MM-DD` value of the resources to read
-            # @param [Time] date_created The `YYYY-MM-DD` value of the resources to read
-            # @param [Time] date_created_after The `YYYY-MM-DD` value of the resources to read
+            # @param [Time] date_created_before Only include recordings that were created on this date
+            # @param [Time] date_created Only include recordings that were created on this date
+            # @param [Time] date_created_after Only include recordings that were created on this date
             # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
             #   SID of the resources to read.
             # @param [String] conference_sid The Conference SID that identifies the conference
@@ -61,9 +61,9 @@ module Twilio
             # Streams RecordingInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [Time] date_created_before The `YYYY-MM-DD` value of the resources to read
-            # @param [Time] date_created The `YYYY-MM-DD` value of the resources to read
-            # @param [Time] date_created_after The `YYYY-MM-DD` value of the resources to read
+            # @param [Time] date_created_before Only include recordings that were created on this date
+            # @param [Time] date_created Only include recordings that were created on this date
+            # @param [Time] date_created_after Only include recordings that were created on this date
             # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
             #   SID of the resources to read.
             # @param [String] conference_sid The Conference SID that identifies the conference
@@ -107,9 +107,9 @@ module Twilio
             ##
             # Retrieve a single page of RecordingInstance records from the API.
             # Request is executed immediately.
-            # @param [Time] date_created_before The `YYYY-MM-DD` value of the resources to read
-            # @param [Time] date_created The `YYYY-MM-DD` value of the resources to read
-            # @param [Time] date_created_after The `YYYY-MM-DD` value of the resources to read
+            # @param [Time] date_created_before Only include recordings that were created on this date
+            # @param [Time] date_created Only include recordings that were created on this date
+            # @param [Time] date_created_after Only include recordings that were created on this date
             # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
             #   SID of the resources to read.
             # @param [String] conference_sid The Conference SID that identifies the conference

data/lib/twilio-ruby/rest/autopilot/v1/assistant/query.rb

@@ -38,7 +38,7 @@ module Twilio
             # @param [String] model_build The SID or unique name of the [Model
             #   Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
             # @param [String] status The status of the resources to read. Can be:
-            #   `pending_review`, `reviewed`, or `discarded`
+            #   `pending-review`, `reviewed`, or `discarded`
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -65,7 +65,7 @@ module Twilio
             # @param [String] model_build The SID or unique name of the [Model
             #   Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
             # @param [String] status The status of the resources to read. Can be:
-            #   `pending_review`, `reviewed`, or `discarded`
+            #   `pending-review`, `reviewed`, or `discarded`
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -108,7 +108,7 @@ module Twilio
             # @param [String] model_build The SID or unique name of the [Model
             #   Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
             # @param [String] status The status of the resources to read. Can be:
-            #   `pending_review`, `reviewed`, or `discarded`
+            #   `pending-review`, `reviewed`, or `discarded`
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
             # @param [Integer] page_size Number of records to return, defaults to 50
@@ -252,7 +252,7 @@ module Twilio
             # @param [String] sample_sid The SID of an optional reference to the
             #   [Sample](https://www.twilio.com/docs/autopilot/api/task-sample) created from the
             #   query.
-            # @param [String] status The new status of the resource. Can be: `pending_review`,
+            # @param [String] status The new status of the resource. Can be: `pending-review`,
             #   `reviewed`, or `discarded`
             # @return [QueryInstance] Updated QueryInstance
             def update(sample_sid: :unset, status: :unset)
@@ -428,7 +428,7 @@ module Twilio
             # @param [String] sample_sid The SID of an optional reference to the
             #   [Sample](https://www.twilio.com/docs/autopilot/api/task-sample) created from the
             #   query.
-            # @param [String] status The new status of the resource. Can be: `pending_review`,
+            # @param [String] status The new status of the resource. Can be: `pending-review`,
             #   `reviewed`, or `discarded`
             # @return [QueryInstance] Updated QueryInstance
             def update(sample_sid: :unset, status: :unset)

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

@@ -41,14 +41,16 @@ module Twilio
             # @param [String] attributes A string metadata field you can use to store any data
             #   you wish. The string value must contain structurally valid JSON if specified.
             #   **Note** that if the attributes are not set "{}" will be returned.
+            # @param [String] media_sid The Media Sid to be attached to the new Message.
             # @return [MessageInstance] Newly created MessageInstance
-            def create(author: :unset, body: :unset, date_created: :unset, date_updated: :unset, attributes: :unset)
+            def create(author: :unset, body: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, media_sid: :unset)
               data = Twilio::Values.of({
                   'Author' => author,
                   'Body' => body,
                   'DateCreated' => Twilio.serialize_iso8601_datetime(date_created),
                   'DateUpdated' => Twilio.serialize_iso8601_datetime(date_updated),
                   'Attributes' => attributes,
+                  'MediaSid' => media_sid,
               })
 
               payload = @version.create(
@@ -300,6 +302,7 @@ module Twilio
                   'index' => payload['index'].to_i,
                   'author' => payload['author'],
                   'body' => payload['body'],
+                  'media' => payload['media'],
                   'attributes' => payload['attributes'],
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
@@ -358,6 +361,12 @@ module Twilio
               @properties['body']
             end
 
+            ##
+            # @return [Hash] An array of objects that describe the Message's media if attached, otherwise, null.
+            def media
+              @properties['media']
+            end
+
             ##
             # @return [String] A string metadata field you can use to store any data you wish.
             def attributes

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

@@ -32,7 +32,7 @@ module Twilio
             # Retrieve a single page of ParticipantInstance records from the API.
             # Request is executed immediately.
             # @param [String] identity A unique string identifier for the conversation
-            #   participant as [Chat User](https://www.twilio.com/docs/api/chat/rest/users).
+            #   participant as [Chat User](https://www.twilio.com/docs/chat/rest/user-resource).
             #   This parameter is non-null if (and only if) the participant is using the
             #   Programmable Chat SDK to communicate. Limited to 256 characters.
             # @param [String] messaging_binding_address The address of the participant's

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

@@ -160,16 +160,16 @@ module Twilio
           # @param [String] to The phone number to receive the fax in
           #   [E.164](https://www.twilio.com/docs/glossary/what-e164) format or the
           #   recipient's SIP URI.
-          # @param [String] media_url The Twilio-hosted URL of the PDF that contains the
-          #   fax. See our [security](https://www.twilio.com/docs/usage/security) page for
-          #   information on how to ensure the request for your media comes from Twilio.
+          # @param [String] media_url The URL of the PDF that contains the fax. See our
+          #   [security](https://www.twilio.com/docs/usage/security) page for information on
+          #   how to ensure the request for your media comes from Twilio.
           # @param [fax.Quality] quality The [Fax Quality
-          #   value](https://www.twilio.com/docs/fax/api/faxes-resource#fax-quality-values)
-          #   that describes the fax quality. Can be: `standard`, `fine`, or `superfine` and
+          #   value](https://www.twilio.com/docs/fax/api/fax-resource#fax-quality-values) that
+          #   describes the fax quality. Can be: `standard`, `fine`, or `superfine` and
           #   defaults to `fine`.
           # @param [String] status_callback The URL we should call using the `POST` method
           #   to send [status
-          #   information](https://www.twilio.com/docs/fax/api/faxes-resource#fax-status-callback) to your application when the status of the fax changes.
+          #   information](https://www.twilio.com/docs/fax/api/fax-resource#fax-status-callback) to your application when the status of the fax changes.
           # @param [String] from The number the fax was sent from. Can be the phone number
           #   in [E.164](https://www.twilio.com/docs/glossary/what-e164) format or the SIP
           #   `from` value. The caller ID displayed to the recipient uses this value. If this
@@ -285,9 +285,9 @@ module Twilio
           ##
           # Update the FaxInstance
           # @param [fax.UpdateStatus] status The new
-          #   [status](https://www.twilio.com/docs/fax/api/faxes-resource#fax-status-values)
-          #   of the resource. Can be only `canceled`. This may fail if transmission has
-          #   already started.
+          #   [status](https://www.twilio.com/docs/fax/api/fax-resource#fax-status-values) of
+          #   the resource. Can be only `canceled`. This may fail if transmission has already
+          #   started.
           # @return [FaxInstance] Updated FaxInstance
           def update(status: :unset)
             data = Twilio::Values.of({'Status' => status, })
@@ -510,9 +510,9 @@ module Twilio
           ##
           # Update the FaxInstance
           # @param [fax.UpdateStatus] status The new
-          #   [status](https://www.twilio.com/docs/fax/api/faxes-resource#fax-status-values)
-          #   of the resource. Can be only `canceled`. This may fail if transmission has
-          #   already started.
+          #   [status](https://www.twilio.com/docs/fax/api/fax-resource#fax-status-values) of
+          #   the resource. Can be only `canceled`. This may fail if transmission has already
+          #   started.
           # @return [FaxInstance] Updated FaxInstance
           def update(status: :unset)
             context.update(status: status, )

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

@@ -29,7 +29,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid The unique ID of the FlexFlow
+      # @param [String] sid The unique string that we created to identify the FlexFlow
+      #   resource.
       # @return [Twilio::REST::Flex_api::V1::FlexFlowInstance] if sid was passed.
       # @return [Twilio::REST::Flex_api::V1::FlexFlowList]
       def flex_flow(sid=:unset)
@@ -37,7 +38,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid The unique SID identifier of the Flex Chat Channel
+      # @param [String] sid The unique string that we created to identify the Channel
+      #   resource.
       # @return [Twilio::REST::Flex_api::V1::ChannelInstance] if sid was passed.
       # @return [Twilio::REST::Flex_api::V1::ChannelList]
       def channel(sid=:unset)
@@ -45,7 +47,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid The unique SID identifier of the Flex Chat Channel
+      # @param [String] sid The unique string that we created to identify the WebChannel
+      #   resource.
       # @return [Twilio::REST::Flex_api::V1::WebChannelInstance] if sid was passed.
       # @return [Twilio::REST::Flex_api::V1::WebChannelList]
       def web_channel(sid=:unset)

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

@@ -22,7 +22,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid The unique ID of the FlexFlow
+        # @param [String] sid The SID of the FlexFlow 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)
@@ -36,7 +36,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid The unique SID identifier of the Flex Chat Channel
+        # @param [String] sid The SID of the Flex chat channel resource to fetch.
         # @return [Twilio::REST::Flex_api::V1::ChannelContext] if sid was passed.
         # @return [Twilio::REST::Flex_api::V1::ChannelList]
         def channel(sid=:unset)
@@ -50,7 +50,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid The unique SID identifier of the Flex Chat Channel
+        # @param [String] sid The SID of the WebChannel resource to fetch.
         # @return [Twilio::REST::Flex_api::V1::WebChannelContext] if sid was passed.
         # @return [Twilio::REST::Flex_api::V1::WebChannelList]
         def web_channel(sid=:unset)

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

@@ -108,19 +108,19 @@ module Twilio
           ##
           # Retrieve a single page of ChannelInstance records from the API.
           # Request is executed immediately.
-          # @param [String] flex_flow_sid The unique ID of the FlexFlow
-          # @param [String] identity Chat User identity
-          # @param [String] chat_user_friendly_name Customer friendly name (chat
-          #   participant)
-          # @param [String] chat_friendly_name Chat channel friendly name
-          # @param [String] target Target Contact Identity, for example phone number for SMS
-          # @param [String] chat_unique_name Chat channel unique name
-          # @param [String] pre_engagement_data Pre-engagement data
-          # @param [String] task_sid The unique SID identifier of the Taskrouter task
-          # @param [String] task_attributes Task attributes to be added for the TaskRouter
-          #   Task
-          # @param [Boolean] long_lived Boolean flag determining whether channel is created
-          #   as long lived or not
+          # @param [String] flex_flow_sid The SID of the FlexFlow.
+          # @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.
+          # @param [String] chat_friendly_name The chat channel's friendly name.
+          # @param [String] target The Target Contact Identity, for example the phone number
+          #   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
+          #   TaskRouter Task.
+          # @param [Boolean] long_lived Whether to create the channel as long-lived.
           # @return [ChannelInstance] Newly 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({
@@ -185,7 +185,7 @@ module Twilio
           ##
           # Initialize the ChannelContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The unique SID identifier of the Flex Chat Channel
+          # @param [String] sid The SID of the Flex chat channel resource to fetch.
           # @return [ChannelContext] ChannelContext
           def initialize(version, sid)
             super(version)
@@ -237,7 +237,7 @@ module Twilio
           # Initialize the ChannelInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The unique SID identifier of the Flex Chat Channel
+          # @param [String] sid The SID of the Flex chat channel resource to fetch.
           # @return [ChannelInstance] ChannelInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -271,49 +271,49 @@ module Twilio
           end
 
           ##
-          # @return [String] The ID of the account that owns this Workflow
+          # @return [String] The SID of the Account that created the resource and owns this Workflow
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The unique ID of the FlexFlow
+          # @return [String] The SID of the FlexFlow
           def flex_flow_sid
             @properties['flex_flow_sid']
           end
 
           ##
-          # @return [String] Flex Chat Channel Sid
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] Chat User Sid.
+          # @return [String] The SID of the chat user
           def user_sid
             @properties['user_sid']
           end
 
           ##
-          # @return [String] TaskRouter Task Sid.
+          # @return [String] The SID of the TaskRouter task
           def task_sid
             @properties['task_sid']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The absolute URL of the Flex chat channel resource
           def url
             @properties['url']
           end
 
           ##
-          # @return [Time] The time the Flex Chat Channel was created, given as GMT in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the Flex chat channel was created
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The time the Flex Chat Channel was last updated, given as GMT in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the Flex chat channel was last updated
           def date_updated
             @properties['date_updated']
           end