twilio-ruby 5.27.0 → 5.27.1

data/lib/twilio-ruby/rest/messaging/v1/session/message.rb

@@ -17,8 +17,7 @@ module Twilio
             ##
             # Initialize the MessageList
             # @param [Version] version Version that contains the resource
-            # @param [String] session_sid The unique id of the
-            #   [Session](https://www.twilio.com/docs/sessions/api/session) for this message.
+            # @param [String] session_sid The SID of the Session for the message.
             # @return [MessageList] MessageList
             def initialize(version, session_sid: nil)
               super(version)
@@ -31,15 +30,16 @@ module Twilio
             ##
             # Retrieve a single page of MessageInstance records from the API.
             # Request is executed immediately.
-            # @param [String] author The
-            #   [identity](https://www.twilio.com/docs/api/chat/guides/identity) of the
-            #   message's author. Defaults to `system`.
-            # @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.
-            # @param [Time] date_created The date that this resource was created.
-            # @param [Time] date_updated The date that this resource was last updated. `null`
-            #   if the message has not been edited.
-            # @param [String] body The contents of the message.
+            # @param [String] author The [identity](https://www.twilio.com/docs/chat/identity)
+            #   of the message's author. Defaults to `system`.
+            # @param [String] attributes A JSON string that stores application-specific data.
+            # @param [Time] date_created The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was created.
+            # @param [Time] date_updated The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was last updated.
+            # @param [String] body The message body.
             # @return [MessageInstance] Newly created MessageInstance
             def create(author: :unset, attributes: :unset, date_created: :unset, date_updated: :unset, body: :unset)
               data = Twilio::Values.of({
@@ -185,10 +185,8 @@ module Twilio
             ##
             # Initialize the MessageContext
             # @param [Version] version Version that contains the resource
-            # @param [String] session_sid The unique id of the
-            #   [Session](https://www.twilio.com/docs/sessions/api/session) for this message.
-            # @param [String] sid A 34 character string that uniquely identifies this
-            #   resource.
+            # @param [String] session_sid The SID of the Session with the message to fetch.
+            # @param [String] sid The SID of the SessionMessage resource to fetch.
             # @return [MessageContext] MessageContext
             def initialize(version, session_sid, sid)
               super(version)
@@ -215,15 +213,16 @@ module Twilio
 
             ##
             # Update the MessageInstance
-            # @param [String] author The
-            #   [identity](https://www.twilio.com/docs/api/chat/guides/identity) of the
-            #   message's author. Defaults to `system`.
-            # @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.
-            # @param [Time] date_created The date that this resource was created.
-            # @param [Time] date_updated The date that this resource was last updated. `null`
-            #   if the message has not been edited.
-            # @param [String] body The contents of the message.
+            # @param [String] author The [identity](https://www.twilio.com/docs/chat/identity)
+            #   of the message's author. Defaults to `system`.
+            # @param [String] attributes A JSON string that stores application-specific data.
+            # @param [Time] date_created The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was created.
+            # @param [Time] date_updated The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was last updated.
+            # @param [String] body The message body.
             # @return [MessageInstance] Updated MessageInstance
             def update(author: :unset, attributes: :unset, date_created: :unset, date_updated: :unset, body: :unset)
               data = Twilio::Values.of({
@@ -272,10 +271,8 @@ module Twilio
             # Initialize the MessageInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] session_sid The unique id of the
-            #   [Session](https://www.twilio.com/docs/sessions/api/session) for this message.
-            # @param [String] sid A 34 character string that uniquely identifies this
-            #   resource.
+            # @param [String] session_sid The SID of the Session for the message.
+            # @param [String] sid The SID of the SessionMessage resource to fetch.
             # @return [MessageInstance] MessageInstance
             def initialize(version, payload, session_sid: nil, sid: nil)
               super(version)
@@ -313,31 +310,31 @@ module Twilio
             end
 
             ##
-            # @return [String] The unique id of the Account responsible for this message.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The unique id of the Chat Service this message belongs to.
+            # @return [String] The SID of the Service that the resource is associated with
             def service_sid
               @properties['service_sid']
             end
 
             ##
-            # @return [String] The unique id of the SMS Service this message belongs to.
+            # @return [String] The SID of the Messaging Service the message belongs to
             def messaging_service_sid
               @properties['messaging_service_sid']
             end
 
             ##
-            # @return [String] The unique id of the Session for this message.
+            # @return [String] The SID of the Session for the message
             def session_sid
               @properties['session_sid']
             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
@@ -349,37 +346,37 @@ module Twilio
             end
 
             ##
-            # @return [String] The identity or the address of the device of the message's author.
+            # @return [String] The identity or the address of the device of the message's author
             def author
               @properties['author']
             end
 
             ##
-            # @return [String] The contents of the message.
+            # @return [String] The message body
             def body
               @properties['body']
             end
 
             ##
-            # @return [String] A string metadata field you can use to store any data you wish.
+            # @return [String] The JSON string that stores application-specific data
             def attributes
               @properties['attributes']
             end
 
             ##
-            # @return [Time] The date that this resource was created.
+            # @return [Time] The ISO 8601 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 ISO 8601 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 message.
+            # @return [String] The absolute URL of the message
             def url
               @properties['url']
             end
@@ -393,15 +390,16 @@ module Twilio
 
             ##
             # Update the MessageInstance
-            # @param [String] author The
-            #   [identity](https://www.twilio.com/docs/api/chat/guides/identity) of the
-            #   message's author. Defaults to `system`.
-            # @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.
-            # @param [Time] date_created The date that this resource was created.
-            # @param [Time] date_updated The date that this resource was last updated. `null`
-            #   if the message has not been edited.
-            # @param [String] body The contents of the message.
+            # @param [String] author The [identity](https://www.twilio.com/docs/chat/identity)
+            #   of the message's author. Defaults to `system`.
+            # @param [String] attributes A JSON string that stores application-specific data.
+            # @param [Time] date_created The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was created.
+            # @param [Time] date_updated The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was last updated.
+            # @param [String] body The message body.
             # @return [MessageInstance] Updated MessageInstance
             def update(author: :unset, attributes: :unset, date_created: :unset, date_updated: :unset, body: :unset)
               context.update(

data/lib/twilio-ruby/rest/messaging/v1/session/participant.rb

@@ -17,9 +17,7 @@ module Twilio
             ##
             # Initialize the ParticipantList
             # @param [Version] version Version that contains the resource
-            # @param [String] session_sid The unique id of the
-            #   [Session](https://www.twilio.com/docs/sessions/api/session) for this
-            #   participant.
+            # @param [String] session_sid The SID of the Session for the participant.
             # @return [ParticipantList] ParticipantList
             def initialize(version, session_sid: nil)
               super(version)
@@ -32,28 +30,28 @@ module Twilio
             ##
             # Retrieve a single page of ParticipantInstance records from the API.
             # Request is executed immediately.
-            # @param [String] attributes An optional 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] twilio_address The address of the Twilio phone number (or
-            #   WhatsApp number, or Messenger Page ID) that the participant is in contact with.
-            #   This field, together with user_address, is only null when the participant is
+            # @param [String] attributes A JSON string that stores application-specific data.
+            # @param [String] twilio_address The address of the Twilio phone number, WhatsApp
+            #   number, or Messenger Page ID that the participant is in contact with. This
+            #   field, together with user_address, is only null when the participant is
             #   interacting from a Chat endpoint (see the 'identity' field).
-            # @param [Time] date_created The date that this resource was created. This is most
-            #   often useful when bulk-importing messages from another system, as the provided
-            #   value will be trusted and displayed on SDK clients.
-            # @param [Time] date_updated The date that this resource was last updated. This is
-            #   most often provided when bulk-importing messages from another system, as the
-            #   provided value will be trusted and displayed on SDK clients.
-            # @param [String] identity A unique string identifier for the session participant
-            #   as [Chat User](https://www.twilio.com/docs/api/chat/rest/users). This parameter
-            #   is non-null if (and only if) the participant is using the Programmable Chat SDK
-            #   to communicate.
-            # @param [String] user_address The address of the participant's device, e.g. a
+            # @param [Time] date_created The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was created. This is used when importing messages from another
+            #   system, as the provided value will be trusted and displayed on SDK clients.
+            # @param [Time] date_updated The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was last updated. This is used when importing messages from
+            #   another system, as the provided value will be trusted and displayed on SDK
+            #   clients.
+            # @param [String] identity The application-defined string that uniquely identifies
+            #   the [Chat User](https://www.twilio.com/docs/chat/rest/user-resource) as the
+            #   session participant. This parameter is null unless the participant is using the
+            #   Programmable Chat SDK to communicate.
+            # @param [String] user_address The address of the participant's device. Can be a
             #   phone number or Messenger ID. Together with the Twilio Address, this determines
-            #   a participant uniquely. This field (with twilio_address) is only null when the
-            #   participant is interacting from a Chat endpoint (see the 'identity' field).
+            #   a participant uniquely. This field (with twilio_address) is null when the
+            #   participant is interacting from a Chat endpoint (see the `identity` field).
             # @return [ParticipantInstance] Newly created ParticipantInstance
             def create(attributes: :unset, twilio_address: :unset, date_created: :unset, date_updated: :unset, identity: :unset, user_address: :unset)
               data = Twilio::Values.of({
@@ -200,11 +198,9 @@ module Twilio
             ##
             # Initialize the ParticipantContext
             # @param [Version] version Version that contains the resource
-            # @param [String] session_sid The unique id of the
-            #   [Session](https://www.twilio.com/docs/sessions/api/session) for this
-            #   participant.
-            # @param [String] sid A 34 character string that uniquely identifies this
-            #   resource.
+            # @param [String] session_sid The SID of the Session with the participant to
+            #   fetch.
+            # @param [String] sid The SID of the SessionParticipant resource to fetch.
             # @return [ParticipantContext] ParticipantContext
             def initialize(version, session_sid, sid)
               super(version)
@@ -216,14 +212,14 @@ module Twilio
 
             ##
             # Update the ParticipantInstance
-            # @param [String] attributes An optional 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 [Time] date_created The date that this resource was created. This is
-            #   useful when bulk-importing messages from another system, as the provided value
-            #   will be trusted and displayed on SDK clients.
-            # @param [Time] date_updated The date that this resource was last updated.
+            # @param [String] attributes A JSON string that stores application-specific data.
+            # @param [Time] date_created The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was created. This is used when importing messages from another
+            #   system, as the provided value will be trusted and displayed on SDK clients.
+            # @param [Time] date_updated The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was last updated.
             # @return [ParticipantInstance] Updated ParticipantInstance
             def update(attributes: :unset, date_created: :unset, date_updated: :unset)
               data = Twilio::Values.of({
@@ -295,11 +291,8 @@ module Twilio
             # Initialize the ParticipantInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] session_sid The unique id of the
-            #   [Session](https://www.twilio.com/docs/sessions/api/session) for this
-            #   participant.
-            # @param [String] sid A 34 character string that uniquely identifies this
-            #   resource.
+            # @param [String] session_sid The SID of the Session for the participant.
+            # @param [String] sid The SID of the SessionParticipant resource to fetch.
             # @return [ParticipantInstance] ParticipantInstance
             def initialize(version, payload, session_sid: nil, sid: nil)
               super(version)
@@ -338,93 +331,93 @@ module Twilio
             end
 
             ##
-            # @return [String] The unique id of the Account responsible for this session.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The unique id of the Chat Service this session belongs to.
+            # @return [String] The SID of the Service the session belongs to
             def service_sid
               @properties['service_sid']
             end
 
             ##
-            # @return [String] The unique id of the SMS Service this session belongs to.
+            # @return [String] The SID of the SMS Service the session belongs to
             def messaging_service_sid
               @properties['messaging_service_sid']
             end
 
             ##
-            # @return [String] The unique id of the Session for this participant.
+            # @return [String] The SID of the Session for the participant
             def session_sid
               @properties['session_sid']
             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] A unique string identifier for the session participant as Chat User.
+            # @return [String] The string that identifies the resource's User
             def identity
               @properties['identity']
             end
 
             ##
-            # @return [String] The address of the Twilio phone number that the participant is in contact with.
+            # @return [String] The address of the Twilio phone number that the participant is in contact with
             def twilio_address
               @properties['twilio_address']
             end
 
             ##
-            # @return [String] The address of the participant's device.
+            # @return [String] The address of the participant's device
             def user_address
               @properties['user_address']
             end
 
             ##
-            # @return [String] An optional string metadata field you can use to store any data you wish.
+            # @return [String] The JSON string that stores application-specific data
             def attributes
               @properties['attributes']
             end
 
             ##
-            # @return [participant.ParticipantType] The type of twilio product, participant is a user of.
+            # @return [participant.ParticipantType] The type of messaging used by the participant
             def type
               @properties['type']
             end
 
             ##
-            # @return [Time] The date that this resource was created.
+            # @return [Time] The ISO 8601 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 ISO 8601 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 participant.
+            # @return [String] The absolute URL of the participant
             def url
               @properties['url']
             end
 
             ##
             # Update the ParticipantInstance
-            # @param [String] attributes An optional 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 [Time] date_created The date that this resource was created. This is
-            #   useful when bulk-importing messages from another system, as the provided value
-            #   will be trusted and displayed on SDK clients.
-            # @param [Time] date_updated The date that this resource was last updated.
+            # @param [String] attributes A JSON string that stores application-specific data.
+            # @param [Time] date_created The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was created. This is used when importing messages from another
+            #   system, as the provided value will be trusted and displayed on SDK clients.
+            # @param [Time] date_updated The date, specified in [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+            #   as the date it was last updated.
             # @return [ParticipantInstance] Updated ParticipantInstance
             def update(attributes: :unset, date_created: :unset, date_updated: :unset)
               context.update(attributes: attributes, date_created: date_created, date_updated: date_updated, )

data/lib/twilio-ruby/rest/messaging/v1/session/webhook.rb

@@ -17,8 +17,7 @@ module Twilio
             ##
             # Initialize the WebhookList
             # @param [Version] version Version that contains the resource
-            # @param [String] session_sid The unique id of the
-            #   [Session](https://www.twilio.com/docs/sessions/api/session) for this webhook.
+            # @param [String] session_sid The SID of the Session for the webhook.
             # @return [WebhookList] WebhookList
             def initialize(version, session_sid: nil)
               super(version)
@@ -113,25 +112,25 @@ module Twilio
             ##
             # Retrieve a single page of WebhookInstance records from the API.
             # Request is executed immediately.
-            # @param [webhook.Target] target The target of this webhook.
-            # @param [String] configuration_url The absolute url the webhook request should be
+            # @param [webhook.Target] target The target of the webhook.
+            # @param [String] configuration_url The absolute URL the webhook request should be
             #   sent to.
-            # @param [webhook.Method] configuration_method The HTTP method to be used when
-            #   sending a webhook request.
-            # @param [String] configuration_filters The list of events, firing webhook event
-            #   for this Session.
+            # @param [webhook.Method] configuration_method The HTTP method we should use when
+            #   sending a webhook request to `url`. Can be `POST` or `GET`.
+            # @param [String] configuration_filters The list of events that trigger a webhook
+            #   event for the Session.
             # @param [String] configuration_triggers The list of keywords, firing webhook
-            #   event for this Session.
-            # @param [String] configuration_flow_sid The studio flow sid, where the webhook
-            #   should be sent to.
-            # @param [String] configuration_retry_count The number of retries in case of
-            #   webhook request failures. Maximum 3 retries are allowed, the default value is 0.
-            # @param [String] configuration_replay_after The message index for which and it's
-            #   successors the webhook will be replayed. Not set by default
-            # @param [Boolean] configuration_buffer_messages The flag whether buffering should
-            #   be applied to messages. Not set by default
-            # @param [String] configuration_buffer_window The period of buffering messages.
-            #   Default is 3000 ms.
+            #   event for the Session.
+            # @param [String] configuration_flow_sid The SID of the studio flow where the
+            #   webhook should be sent to.
+            # @param [String] configuration_retry_count The number of times to call the
+            #   webhook request if the first attempt fails. Can be up to 3 and the default is 0.
+            # @param [String] configuration_replay_after The message index for which and its
+            #   successors the webhook will be replayed. Not set by default.
+            # @param [Boolean] configuration_buffer_messages Whether buffering should be
+            #   applied to messages. Not set by default.
+            # @param [String] configuration_buffer_window The period to buffer messages in
+            #   milliseconds. Default is 3,000 ms.
             # @return [WebhookInstance] Newly created WebhookInstance
             def create(target: nil, configuration_url: :unset, configuration_method: :unset, configuration_filters: :unset, configuration_triggers: :unset, configuration_flow_sid: :unset, configuration_retry_count: :unset, configuration_replay_after: :unset, configuration_buffer_messages: :unset, configuration_buffer_window: :unset)
               data = Twilio::Values.of({
@@ -200,10 +199,9 @@ module Twilio
             ##
             # Initialize the WebhookContext
             # @param [Version] version Version that contains the resource
-            # @param [String] session_sid The unique id of the
-            #   [Session](https://www.twilio.com/docs/sessions/api/session) for this webhook.
-            # @param [String] sid A 34 character string that uniquely identifies this
-            #   resource.
+            # @param [String] session_sid The SID of the Session with the Webhook resource to
+            #   fetch.
+            # @param [String] sid The SID of the resource to fetch.
             # @return [WebhookContext] WebhookContext
             def initialize(version, session_sid, sid)
               super(version)
@@ -230,22 +228,22 @@ module Twilio
 
             ##
             # Update the WebhookInstance
-            # @param [String] configuration_url The absolute url the webhook request should be
+            # @param [String] configuration_url The absolute URL the webhook request should be
             #   sent to.
-            # @param [webhook.Method] configuration_method The HTTP method to be used when
-            #   sending a webhook request.
-            # @param [String] configuration_filters The list of events, firing webhook event
-            #   for this Session.
-            # @param [String] configuration_triggers The list of keywords, firing webhook
-            #   event for this Session.
-            # @param [String] configuration_flow_sid The studio flow sid, where the webhook
-            #   should be sent to.
-            # @param [String] configuration_retry_count The number of retries in case of
-            #   webhook request failures. Maximum 3 retries are allowed, the default value is 0.
-            # @param [Boolean] configuration_buffer_messages The flag whether buffering should
-            #   be applied to messages. Not set by default
-            # @param [String] configuration_buffer_window The period of buffering messages.
-            #   Default is 3000 ms.
+            # @param [webhook.Method] configuration_method The HTTP method we should use when
+            #   sending a webhook request to `url`. Can be `POST` or `GET`.
+            # @param [String] configuration_filters The list of events that trigger a webhook
+            #   event for the Session.
+            # @param [String] configuration_triggers The list of keywords that trigger a
+            #   webhook event for the Session.
+            # @param [String] configuration_flow_sid The SID of the studio flow where the
+            #   webhook should be sent to.
+            # @param [String] configuration_retry_count The number of times to try the webhook
+            #   request if the first attempt fails. Can be up to 3 and the default is 0.
+            # @param [Boolean] configuration_buffer_messages Whether buffering should be
+            #   applied to messages. Not set by default.
+            # @param [String] configuration_buffer_window The period to buffer messages in
+            #   milliseconds. Default is 3,000 ms.
             # @return [WebhookInstance] Updated WebhookInstance
             def update(configuration_url: :unset, configuration_method: :unset, configuration_filters: :unset, configuration_triggers: :unset, configuration_flow_sid: :unset, configuration_retry_count: :unset, configuration_buffer_messages: :unset, configuration_buffer_window: :unset)
               data = Twilio::Values.of({
@@ -297,10 +295,8 @@ module Twilio
             # Initialize the WebhookInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] session_sid The unique id of the
-            #   [Session](https://www.twilio.com/docs/sessions/api/session) for this webhook.
-            # @param [String] sid A 34 character string that uniquely identifies this
-            #   resource.
+            # @param [String] session_sid The SID of the Session for the webhook.
+            # @param [String] sid The SID of the resource to fetch.
             # @return [WebhookInstance] WebhookInstance
             def initialize(version, payload, session_sid: nil, sid: nil)
               super(version)
@@ -334,49 +330,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 session.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The unique id of the Session for this webhook.
+            # @return [String] The SID of the Session for the webhook
             def session_sid
               @properties['session_sid']
             end
 
             ##
-            # @return [String] The target of this webhook.
+            # @return [String] The target of the webhook
             def target
               @properties['target']
             end
 
             ##
-            # @return [String] An absolute URL for this webhook.
+            # @return [String] The absolute URL of the webhook
             def url
               @properties['url']
             end
 
             ##
-            # @return [Hash] The configuration of this webhook.
+            # @return [Hash] The configuration of the webhook
             def configuration
               @properties['configuration']
             end
 
             ##
-            # @return [Time] The date that this resource was created.
+            # @return [Time] The ISO 8601 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 ISO 8601 date and time in GMT when the resource was last updated
             def date_updated
               @properties['date_updated']
             end
@@ -390,22 +386,22 @@ module Twilio
 
             ##
             # Update the WebhookInstance
-            # @param [String] configuration_url The absolute url the webhook request should be
+            # @param [String] configuration_url The absolute URL the webhook request should be
             #   sent to.
-            # @param [webhook.Method] configuration_method The HTTP method to be used when
-            #   sending a webhook request.
-            # @param [String] configuration_filters The list of events, firing webhook event
-            #   for this Session.
-            # @param [String] configuration_triggers The list of keywords, firing webhook
-            #   event for this Session.
-            # @param [String] configuration_flow_sid The studio flow sid, where the webhook
-            #   should be sent to.
-            # @param [String] configuration_retry_count The number of retries in case of
-            #   webhook request failures. Maximum 3 retries are allowed, the default value is 0.
-            # @param [Boolean] configuration_buffer_messages The flag whether buffering should
-            #   be applied to messages. Not set by default
-            # @param [String] configuration_buffer_window The period of buffering messages.
-            #   Default is 3000 ms.
+            # @param [webhook.Method] configuration_method The HTTP method we should use when
+            #   sending a webhook request to `url`. Can be `POST` or `GET`.
+            # @param [String] configuration_filters The list of events that trigger a webhook
+            #   event for the Session.
+            # @param [String] configuration_triggers The list of keywords that trigger a
+            #   webhook event for the Session.
+            # @param [String] configuration_flow_sid The SID of the studio flow where the
+            #   webhook should be sent to.
+            # @param [String] configuration_retry_count The number of times to try the webhook
+            #   request if the first attempt fails. Can be up to 3 and the default is 0.
+            # @param [Boolean] configuration_buffer_messages Whether buffering should be
+            #   applied to messages. Not set by default.
+            # @param [String] configuration_buffer_window The period to buffer messages in
+            #   milliseconds. Default is 3,000 ms.
             # @return [WebhookInstance] Updated WebhookInstance
             def update(configuration_url: :unset, configuration_method: :unset, configuration_filters: :unset, configuration_triggers: :unset, configuration_flow_sid: :unset, configuration_retry_count: :unset, configuration_buffer_messages: :unset, configuration_buffer_window: :unset)
               context.update(