twilio-ruby 5.12.3 → 5.12.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b393c5f2aaf85befaca045f95bb55d03e4509791
-  data.tar.gz: e3291c819d7bca3986b27e880a4a58a7aec0a5d3
+  metadata.gz: 1067889a70a6093ed700c5b18b1bdb9905974d9a
+  data.tar.gz: 179b4ad89db463e0dfa97eac08064c58dfa449c0
 SHA512:
-  metadata.gz: 1a5cbec255f1c395ba75f7df0dba3396bd2d2fb993dc5425fcf50d62e4a5e479be4eb423a99def8253a1b37813d2cf401131582584e301c39266668ed7c50e28
-  data.tar.gz: 88172d73e791244096a7d7f3e94951435dbf0499c247fb36b3a4dcb667a5c73ec23ef4b4575f2d96e7e766277eb84db61688f41ffbf2ee77404766b665ecdb86
+  metadata.gz: e8ab39d6718adfb193361c499e862c2783502692568a6244d8424c0da54195074a954bcb1791248bf5987d1eca03cc3178fc518b84b6623850f69da0973b0a14
+  data.tar.gz: bcf88f2120c5373af54170bc6831e58d44ab67081e43b355883302df1ed145365f0cd6ac92ac0fa16237af0cf466ef1d0e5b614a67930d243b8b92240321f259

data/CHANGES.md

@@ -1,6 +1,19 @@
 twilio-ruby changelog
 =====================
 
+[2018-08-31] Version 5.12.4
+----------------------------
+**Library**
+- PR #427: VCORE-3651 Add support for *for* attribute in twiml element. Thanks to @nmahure!
+
+**Api**
+- Add `call_sid_to_coach` parameter to participant create request
+- Add `voice_receive_mode` param to IncomingPhoneNumbers create
+
+**Video**
+- [Recordings] Expose `offset` property in resource
+
+
 [2018-08-23] Version 5.12.3
 ----------------------------
 **Chat**

data/README.md

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

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

@@ -114,12 +114,21 @@ module Twilio
               # @param [String] conference_recording_status_callback_method The HTTP method
               #   Twilio should use when requesting your recording status callback URL, either
               #   `GET` or `POST`. Defaults to `POST`.
-              # @param [String] recording_status_callback_event The
-              #   recording_status_callback_event
-              # @param [String] conference_recording_status_callback_event The
-              #   conference_recording_status_callback_event
+              # @param [String] recording_status_callback_event Specifies which recording state
+              #   changes should generate a webhook to the URL specified in the
+              #   `RecordingStatusCallback` attribute. Available values are `in-progress`,
+              #   `completed`, `failed`. To specify multiple values, separate them with a space.
+              #   Defaults to `in-progress`, `completed`, `failed`.
+              # @param [String] conference_recording_status_callback_event Specifies which
+              #   conference recording state changes should generate a webhook to the URL
+              #   specified in the `ConferenceRecordingStatusCallback` attribute. Available values
+              #   are `in-progress`, `completed`, `failed`. To specify multiple values, separate
+              #   them with a space. Defaults to `in-progress`, `completed`, `failed`.
+              # @param [String] call_sid_to_coach The string that uniquely identifies the
+              #   participant that is being `coached`, i.e. the only participant who can hear the
+              #   participant that is in `coach` mode.
               # @return [ParticipantInstance] Newly created ParticipantInstance
-              def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, recording_status_callback_event: :unset, conference_recording_status_callback_event: :unset)
+              def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, recording_status_callback_event: :unset, conference_recording_status_callback_event: :unset, call_sid_to_coach: :unset)
                 data = Twilio::Values.of({
                     'From' => from,
                     'To' => to,
@@ -151,6 +160,7 @@ module Twilio
                     'ConferenceRecordingStatusCallbackMethod' => conference_recording_status_callback_method,
                     'RecordingStatusCallbackEvent' => Twilio.serialize_list(recording_status_callback_event) { |e| e },
                     'ConferenceRecordingStatusCallbackEvent' => Twilio.serialize_list(conference_recording_status_callback_event) { |e| e },
+                    'CallSidToCoach' => call_sid_to_coach,
                 })
 
                 payload = @version.create(
@@ -308,7 +318,9 @@ module Twilio
               ##
               # Initialize the ParticipantContext
               # @param [Version] version Version that contains the resource
-              # @param [String] account_sid The account_sid
+              # @param [String] account_sid The unique id of the
+              #   [Account](https://www.twilio.com/docs/iam/api/account) that created this
+              #   conference
               # @param [String] conference_sid The string that uniquely identifies the
               #   conference this participant is in.
               # @param [String] call_sid The Participant's unique Call SID.

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

@@ -205,8 +205,11 @@ module Twilio
             #   the new phone number. The VoiceURL will  no longer be used if a
             #   `VoiceApplicationSid` or a `TrunkSid` is set.
             # @param [incoming_phone_number.EmergencyStatus] emergency_status The
-            #   emergency_status
-            # @param [String] emergency_address_sid The emergency_address_sid
+            #   configuration status parameter determining whether this phone number is enabled
+            #   for emergency calling
+            # @param [String] emergency_address_sid The 34 character sid of the
+            #   EmergencyAddress configuration to leverage emergency calling for this phone
+            #   number
             # @param [String] trunk_sid The 34 character sid of the Trunk Twilio should use to
             #   handle phone calls to this number. If a `TrunkSid` is present, Twilio will
             #   ignore all of the voice urls  and voice applications above and use those set on
@@ -218,6 +221,9 @@ module Twilio
             # @param [String] address_sid The 34 character sid of the address Twilio should
             #   use to associate with the number. Addresses are required in some regions to meet
             #   local regulations
+            # @param [incoming_phone_number.VoiceReceiveMode] voice_receive_mode The
+            #   configuration parameter for this phone number to receive incoming voice calls or
+            #   faxes. Must be either `fax` or `voice`. Defaults to `voice`
             # @param [String] phone_number The phone number you want to purchase. The number
             #   should be formatted starting with a '+' followed by the country code and the
             #   number in [E.164](http://en.wikipedia.org/wiki/E.164) format e.g.,
@@ -229,7 +235,7 @@ module Twilio
             #   this or a `PhoneNumber` parameter to have your POST succeed.** (US and Canada
             #   only)
             # @return [IncomingPhoneNumberInstance] Newly created IncomingPhoneNumberInstance
-            def create(api_version: :unset, friendly_name: :unset, sms_application_sid: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, status_callback: :unset, status_callback_method: :unset, voice_application_sid: :unset, voice_caller_id_lookup: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset, emergency_status: :unset, emergency_address_sid: :unset, trunk_sid: :unset, identity_sid: :unset, address_sid: :unset, phone_number: :unset, area_code: :unset)
+            def create(api_version: :unset, friendly_name: :unset, sms_application_sid: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, status_callback: :unset, status_callback_method: :unset, voice_application_sid: :unset, voice_caller_id_lookup: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset, emergency_status: :unset, emergency_address_sid: :unset, trunk_sid: :unset, identity_sid: :unset, address_sid: :unset, voice_receive_mode: :unset, phone_number: :unset, area_code: :unset)
               data = Twilio::Values.of({
                   'PhoneNumber' => phone_number,
                   'AreaCode' => area_code,
@@ -253,6 +259,7 @@ module Twilio
                   'TrunkSid' => trunk_sid,
                   'IdentitySid' => identity_sid,
                   'AddressSid' => address_sid,
+                  'VoiceReceiveMode' => voice_receive_mode,
               })
 
               payload = @version.create(
@@ -328,7 +335,9 @@ module Twilio
             ##
             # Initialize the IncomingPhoneNumberContext
             # @param [Version] version Version that contains the resource
-            # @param [String] account_sid The account_sid
+            # @param [String] account_sid The unique id of the
+            #   [Account](https://www.twilio.com/docs/iam/api/account) responsible for this
+            #   phone number.
             # @param [String] sid The incoming-phone-number Sid that uniquely identifies this
             #   resource
             # @return [IncomingPhoneNumberContext] IncomingPhoneNumberContext
@@ -386,15 +395,19 @@ module Twilio
             #   the phone number. The VoiceURL will  no longer be used if a
             #   `VoiceApplicationSid` or a `TrunkSid` is set.
             # @param [incoming_phone_number.EmergencyStatus] emergency_status The
-            #   emergency_status
-            # @param [String] emergency_address_sid The emergency_address_sid
+            #   configuration status parameter determining whether this phone number is enabled
+            #   for emergency calling
+            # @param [String] emergency_address_sid The 34 character sid of the
+            #   EmergencyAddress configuration to leverage emergency calling for this phone
+            #   number
             # @param [String] trunk_sid The 34 character sid of the Trunk Twilio should use to
             #   handle phone calls to this number. If a `TrunkSid` is present, Twilio will
             #   ignore all of the voice urls  and voice applications above and use those set on
             #   the Trunk. Setting a `TrunkSid` will automatically delete your
             #   `VoiceApplicationSid` and vice versa.
             # @param [incoming_phone_number.VoiceReceiveMode] voice_receive_mode The
-            #   voice_receive_mode
+            #   configuration parameter for this phone number to receive incoming voice calls or
+            #   faxes. Must be either `fax` or `voice`. Defaults to `voice`
             # @param [String] identity_sid The 34 character sid of the identity Twilio should
             #   use to associate with the number. Identities are required in some regions to
             #   meet local regulations
@@ -786,15 +799,19 @@ module Twilio
             #   the phone number. The VoiceURL will  no longer be used if a
             #   `VoiceApplicationSid` or a `TrunkSid` is set.
             # @param [incoming_phone_number.EmergencyStatus] emergency_status The
-            #   emergency_status
-            # @param [String] emergency_address_sid The emergency_address_sid
+            #   configuration status parameter determining whether this phone number is enabled
+            #   for emergency calling
+            # @param [String] emergency_address_sid The 34 character sid of the
+            #   EmergencyAddress configuration to leverage emergency calling for this phone
+            #   number
             # @param [String] trunk_sid The 34 character sid of the Trunk Twilio should use to
             #   handle phone calls to this number. If a `TrunkSid` is present, Twilio will
             #   ignore all of the voice urls  and voice applications above and use those set on
             #   the Trunk. Setting a `TrunkSid` will automatically delete your
             #   `VoiceApplicationSid` and vice versa.
             # @param [incoming_phone_number.VoiceReceiveMode] voice_receive_mode The
-            #   voice_receive_mode
+            #   configuration parameter for this phone number to receive incoming voice calls or
+            #   faxes. Must be either `fax` or `voice`. Defaults to `voice`
             # @param [String] identity_sid The 34 character sid of the identity Twilio should
             #   use to associate with the number. Identities are required in some regions to
             #   meet local regulations

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

@@ -32,18 +32,19 @@ module Twilio
             # @param [String] to The destination phone number for SMS/MMS or a [Channel user
             #   address](https://www.twilio.com/docs/sms/channels#channel-addresses) for other
             #   3rd party channels. Destination phone numbers should be formatted with a '+' and
-            #   country code e.g., +16175551212
+            #   country code e.g., `+16175551212`
             #   ([E.164](https://www.twilio.com/docs/glossary/what-e164) format).
             # @param [String] status_callback A URL where Twilio will POST each time your
             #   message status changes to one of the following: `queued`, `failed`, `sent`,
-            #   `delivered`, or `undelivered`. Twilio will POST the `MessageSid`,
-            #   `MessageStatus`, and `ErrorCode` along with the other [standard request
-            #   parameters](https://www.twilio.com/docs/sms/twiml#request-parameters). If you
-            #   include this parameter in addition to a `MessagingServiceSid`, Twilio will
+            #   `delivered`, or `undelivered`. Twilio will POST its [standard request
+            #   parameters](https://www.twilio.com/docs/sms/twiml#request-parameters) as well as
+            #   some additional parameters including `MessageSid`, `MessageStatus`, and
+            #   `ErrorCode`(see more details [below](#statuscallback-request-parameters)). If
+            #   you include this parameter in addition to a `MessagingServiceSid`, Twilio will
             #   override the Status Callback URL of the [Messaging
             #   Service](https://www.twilio.com/docs/sms/services/api). URLs must contain a
             #   valid hostname – underscores are not allowed.
-            # @param [String] application_sid Twilio will POST `MessageSid` as well as
+            # @param [String] application_sid Twilio will POST a `MessageSid` as well as
             #   `MessageStatus=sent` or `MessageStatus=failed` to the URL in the
             #   `MessageStatusCallback` property of this
             #   [application](https://www.twilio.com/docs/usage/api/applications). If the
@@ -52,8 +53,8 @@ module Twilio
             # @param [String] max_price The total maximum price up to the fourth decimal
             #   (0.0001) in US dollars acceptable for the message to be delivered. *All messages
             #   will be queued for delivery regardless of the price point.* A POST request will
-            #   later be made to your Status Callback URL with a status change of 'Sent' or
-            #   'Failed'. When the price of the message is greater than this value, the message
+            #   later be made to your Status Callback URL with a status change of `Sent` or
+            #   `Failed`. When the price of the message is greater than this value, the message
             #   will fail and not be sent. When `MaxPrice` is not set, all prices for the
             #   message are accepted.
             # @param [Boolean] provide_feedback Set this value to `true` if you are sending
@@ -75,19 +76,26 @@ module Twilio
             # @param [Boolean] smart_encoded The smart_encoded
             # @param [String] from A Twilio phone number (in
             #   [E.164](https://www.twilio.com/docs/glossary/what-e164) format),  [alphanumeric
-            #   sender ID](https://www.twilio.com/docs/sms/send-messages#alphanumeric-sender-id)
+            #   sender
+            #   ID](https://www.twilio.com/docs/sms/send-messages#use-an-alphanumeric-sender-id)
             #   or a [Channel Endpoint
             #   address](https://www.twilio.com/docs/sms/channels#channel-addresses) enabled for
             #   the type of message you wish to send. Phone numbers or [short
             #   codes](https://www.twilio.com/docs/sms/api/short-codes) purchased from Twilio
             #   work here. You cannot (for example) spoof messages from your own cell phone
-            #   number. *Should not be passed if you are using `MessagingServiceSid`.*
+            #   number. *Do not use this parameter if you are using `MessagingServiceSid`.*
             # @param [String] messaging_service_sid The 34-character unique ID of the
             #   [Messaging
-            #   Service](https://www.twilio.com/docs/api/messaging/send-messages#messaging-services) you want to associate with this Message. Set this parameter to use the Messaging Service Settings and [Copilot Features](https://www.twilio.com/docs/sms/services) you have configured. When only this parameter is set, Twilio will use your enabled Copilot Features to select the `From` phone number for delivery. *Should not be passed if you are using `From`.*
+            #   Service](https://www.twilio.com/docs/sms/services#send-a-message-with-copilot)
+            #   you want to associate with this Message. Set this parameter to use the
+            #   [Messaging Service Settings and Copilot
+            #   Features](https://www.twilio.com/console/sms/services) you have configured. When
+            #   only this parameter is set, Twilio will use your enabled Copilot Features to
+            #   select the `From` phone number for delivery. *Do not pass this value if you are
+            #   using `From`.*
             # @param [String] body The text of the message you want to send, limited to 1600
             #   characters.
-            # @param [String] media_url The URL of the media you wish to send with the
+            # @param [String] media_url The URL containing the media you wish to send with the
             #   message. `gif` , `png` and `jpeg` content is currently supported and will be
             #   formatted correctly on the recipient's device. [Other
             #   types](https://www.twilio.com/docs/sms/accepted-mime-types) are also accepted by

data/lib/twilio-ruby/rest/preview/understand/assistant.rb

@@ -203,6 +203,7 @@ module Twilio
             @queries = nil
             @assistant_fallback_actions = nil
             @assistant_initiation_actions = nil
+            @dialogues = nil
           end
 
           ##
@@ -350,6 +351,24 @@ module Twilio
             AssistantInitiationActionsContext.new(@version, @solution[:sid], )
           end
 
+          ##
+          # Access the dialogues
+          # @return [DialogueList]
+          # @return [DialogueContext] if sid was passed.
+          def dialogues(sid=:unset)
+            raise ArgumentError, 'sid cannot be nil' if sid.nil?
+
+            if sid != :unset
+              return DialogueContext.new(@version, @solution[:sid], sid, )
+            end
+
+            unless @dialogues
+              @dialogues = DialogueList.new(@version, assistant_sid: @solution[:sid], )
+            end
+
+            @dialogues
+          end
+
           ##
           # Provide a user friendly representation
           def to_s
@@ -557,6 +576,13 @@ module Twilio
             context.assistant_initiation_actions
           end
 
+          ##
+          # Access the dialogues
+          # @return [dialogues] dialogues
+          def dialogues
+            context.dialogues
+          end
+
           ##
           # Provide a user friendly representation
           def to_s

data/lib/twilio-ruby/rest/preview/understand/assistant/dialogue.rb

@@ -0,0 +1,205 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+# 
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Preview < Domain
+      class Understand < Version
+        class AssistantContext < InstanceContext
+          ##
+          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          class DialogueList < ListResource
+            ##
+            # Initialize the DialogueList
+            # @param [Version] version Version that contains the resource
+            # @param [String] assistant_sid The unique ID of the parent Assistant.
+            # @return [DialogueList] DialogueList
+            def initialize(version, assistant_sid: nil)
+              super(version)
+
+              # Path Solution
+              @solution = {assistant_sid: assistant_sid}
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              '#<Twilio.Preview.Understand.DialogueList>'
+            end
+          end
+
+          ##
+          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          class DialoguePage < Page
+            ##
+            # Initialize the DialoguePage
+            # @param [Version] version Version that contains the resource
+            # @param [Response] response Response from the API
+            # @param [Hash] solution Path solution for the resource
+            # @return [DialoguePage] DialoguePage
+            def initialize(version, response, solution)
+              super(version, response)
+
+              # Path Solution
+              @solution = solution
+            end
+
+            ##
+            # Build an instance of DialogueInstance
+            # @param [Hash] payload Payload response from the API
+            # @return [DialogueInstance] DialogueInstance
+            def get_instance(payload)
+              DialogueInstance.new(@version, payload, assistant_sid: @solution[:assistant_sid], )
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              '<Twilio.Preview.Understand.DialoguePage>'
+            end
+          end
+
+          ##
+          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          class DialogueContext < InstanceContext
+            ##
+            # Initialize the DialogueContext
+            # @param [Version] version Version that contains the resource
+            # @param [String] assistant_sid The assistant_sid
+            # @param [String] sid The sid
+            # @return [DialogueContext] DialogueContext
+            def initialize(version, assistant_sid, sid)
+              super(version)
+
+              # Path Solution
+              @solution = {assistant_sid: assistant_sid, sid: sid, }
+              @uri = "/Assistants/#{@solution[:assistant_sid]}/Dialogues/#{@solution[:sid]}"
+            end
+
+            ##
+            # Fetch a DialogueInstance
+            # @return [DialogueInstance] Fetched DialogueInstance
+            def fetch
+              params = Twilio::Values.of({})
+
+              payload = @version.fetch(
+                  'GET',
+                  @uri,
+                  params,
+              )
+
+              DialogueInstance.new(
+                  @version,
+                  payload,
+                  assistant_sid: @solution[:assistant_sid],
+                  sid: @solution[:sid],
+              )
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Preview.Understand.DialogueContext #{context}>"
+            end
+          end
+
+          ##
+          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          class DialogueInstance < InstanceResource
+            ##
+            # Initialize the DialogueInstance
+            # @param [Version] version Version that contains the resource
+            # @param [Hash] payload payload that contains response from Twilio
+            # @param [String] assistant_sid The unique ID of the parent Assistant.
+            # @param [String] sid The sid
+            # @return [DialogueInstance] DialogueInstance
+            def initialize(version, payload, assistant_sid: nil, sid: nil)
+              super(version)
+
+              # Marshaled Properties
+              @properties = {
+                  'account_sid' => payload['account_sid'],
+                  'assistant_sid' => payload['assistant_sid'],
+                  'sid' => payload['sid'],
+                  'data' => payload['data'],
+                  'url' => payload['url'],
+              }
+
+              # Context
+              @instance_context = nil
+              @params = {'assistant_sid' => assistant_sid, 'sid' => sid || @properties['sid'], }
+            end
+
+            ##
+            # Generate an instance context for the instance, the context is capable of
+            # performing various actions.  All instance actions are proxied to the context
+            # @return [DialogueContext] DialogueContext for this DialogueInstance
+            def context
+              unless @instance_context
+                @instance_context = DialogueContext.new(@version, @params['assistant_sid'], @params['sid'], )
+              end
+              @instance_context
+            end
+
+            ##
+            # @return [String] The unique ID of the Account that created this Field.
+            def account_sid
+              @properties['account_sid']
+            end
+
+            ##
+            # @return [String] The unique ID of the parent Assistant.
+            def assistant_sid
+              @properties['assistant_sid']
+            end
+
+            ##
+            # @return [String] The unique ID of the Dialogue
+            def sid
+              @properties['sid']
+            end
+
+            ##
+            # @return [Hash] The dialogue memory object as json
+            def data
+              @properties['data']
+            end
+
+            ##
+            # @return [String] The url
+            def url
+              @properties['url']
+            end
+
+            ##
+            # Fetch a DialogueInstance
+            # @return [DialogueInstance] Fetched DialogueInstance
+            def fetch
+              context.fetch
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+              "<Twilio.Preview.Understand.DialogueInstance #{values}>"
+            end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+              "<Twilio.Preview.Understand.DialogueInstance #{values}>"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/video/v1/recording.rb

@@ -259,6 +259,7 @@ module Twilio
                 'codec' => payload['codec'],
                 'grouping_sids' => payload['grouping_sids'],
                 'track_name' => payload['track_name'],
+                'offset' => payload['offset'].to_i,
                 'links' => payload['links'],
             }
 
@@ -356,6 +357,12 @@ module Twilio
             @properties['track_name']
           end
 
+          ##
+          # @return [String] Offset in miliseconds for this track.
+          def offset
+            @properties['offset']
+          end
+
           ##
           # @return [String] The links
           def links

data/lib/twilio-ruby/rest/video/v1/room/recording.rb

@@ -243,6 +243,7 @@ module Twilio
                   'codec' => payload['codec'],
                   'grouping_sids' => payload['grouping_sids'],
                   'track_name' => payload['track_name'],
+                  'offset' => payload['offset'].to_i,
                   'room_sid' => payload['room_sid'],
                   'links' => payload['links'],
               }
@@ -341,6 +342,12 @@ module Twilio
               @properties['track_name']
             end
 
+            ##
+            # @return [String] The offset
+            def offset
+              @properties['offset']
+            end
+
             ##
             # @return [String] The room_sid
             def room_sid

data/lib/twilio-ruby/twiml/twiml.rb

@@ -30,6 +30,7 @@ module Twilio
               aliasAttribute: 'alias',
               xmlLang: 'xml:lang',
               interpretAs: 'interpret-as',
+              for_: 'for',
           }
           @name = self.class.name.split('::').last
           @value = nil

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-    VERSION = '5.12.3'
+    VERSION = '5.12.4'
 end

data/spec/integration/api/v2010/account/call/recording_spec.rb

@@ -39,7 +39,6 @@ describe 'Recording' do
           "date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
           "date_updated": "Fri, 14 Oct 2016 21:56:34 +0000",
           "start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
-          "end_time": null,
           "price": null,
           "price_unit": null,
           "duration": "-1",
@@ -91,7 +90,6 @@ describe 'Recording' do
           "date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
           "date_updated": "Fri, 14 Oct 2016 21:56:34 +0000",
           "start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
-          "end_time": null,
           "price": null,
           "price_unit": null,
           "duration": "-1",
@@ -142,7 +140,6 @@ describe 'Recording' do
           "date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
           "date_updated": "Fri, 14 Oct 2016 21:56:38 +0000",
           "start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
-          "end_time": "Fri, 14 Oct 2016 21:56:38 +0000",
           "price": "-0.0025",
           "price_unit": "USD",
           "duration": "4",
@@ -235,7 +232,6 @@ describe 'Recording' do
                   "date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
                   "date_updated": "Fri, 14 Oct 2016 21:56:38 +0000",
                   "start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
-                  "end_time": "Fri, 14 Oct 2016 21:56:38 +0000",
                   "price": "-0.0025",
                   "price_unit": "USD",
                   "duration": "4",

data/spec/integration/api/v2010/account/conference/participant_spec.rb

@@ -169,6 +169,33 @@ describe 'Participant' do
     expect(actual).to_not eq(nil)
   end
 
+  it "receives create_with_sid_as_coach responses" do
+    @holodeck.mock(Twilio::Response.new(
+        201,
+      %q[
+      {
+          "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "date_created": "Fri, 18 Feb 2011 21:07:19 +0000",
+          "date_updated": "Fri, 18 Feb 2011 21:07:19 +0000",
+          "end_conference_on_exit": false,
+          "muted": false,
+          "hold": false,
+          "status": "queued",
+          "start_conference_on_enter": true,
+          "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json"
+      }
+      ]
+    ))
+
+    actual = @client.api.v2010.accounts('ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                              .conferences('CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                              .participants.create(from: '+15017122661', to: '+15558675310')
+
+    expect(actual).to_not eq(nil)
+  end
+
   it "can delete" do
     @holodeck.mock(Twilio::Response.new(500, ''))
 

data/spec/integration/api/v2010/account/conference/recording_spec.rb

@@ -40,7 +40,6 @@ describe 'Recording' do
           "date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
           "date_updated": "Fri, 14 Oct 2016 21:56:34 +0000",
           "start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
-          "end_time": null,
           "price": null,
           "price_unit": null,
           "duration": "-1",
@@ -91,7 +90,6 @@ describe 'Recording' do
           "date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
           "date_updated": "Fri, 14 Oct 2016 21:56:38 +0000",
           "start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
-          "end_time": "Fri, 14 Oct 2016 21:56:38 +0000",
           "price": "-0.0025",
           "price_unit": "USD",
           "duration": "4",
@@ -184,7 +182,6 @@ describe 'Recording' do
                   "date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
                   "date_updated": "Fri, 14 Oct 2016 21:56:38 +0000",
                   "start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
-                  "end_time": "Fri, 14 Oct 2016 21:56:38 +0000",
                   "price": "-0.0025",
                   "price_unit": "USD",
                   "duration": "4",

data/spec/integration/api/v2010/account/message_spec.rb

@@ -33,7 +33,7 @@ describe 'Message' do
       {
           "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "api_version": "2010-04-01",
-          "body": "O Slash: \u00d8, PoP: \ud83d\udca9",
+          "body": "Hello! \ud83d\udc4d",
           "date_created": "Thu, 30 Jul 2015 20:12:31 +0000",
           "date_sent": "Thu, 30 Jul 2015 20:12:33 +0000",
           "date_updated": "Thu, 30 Jul 2015 20:12:33 +0000",
@@ -114,7 +114,7 @@ describe 'Message' do
       {
           "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "api_version": "2010-04-01",
-          "body": "O Slash: \u00d8, PoP: \ud83d\udca9",
+          "body": "Hello! \ud83d\udc4d",
           "date_created": "Thu, 30 Jul 2015 20:12:31 +0000",
           "date_sent": "Thu, 30 Jul 2015 20:12:33 +0000",
           "date_updated": "Thu, 30 Jul 2015 20:12:33 +0000",
@@ -170,7 +170,7 @@ describe 'Message' do
               {
                   "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                   "api_version": "2010-04-01",
-                  "body": "O Slash: \u00d8, PoP: \ud83d\udca9",
+                  "body": "Hello! \ud83d\udc4d",
                   "date_created": "Fri, 04 Sep 2015 22:54:39 +0000",
                   "date_sent": "Fri, 04 Sep 2015 22:54:41 +0000",
                   "date_updated": "Fri, 04 Sep 2015 22:54:41 +0000",
@@ -258,7 +258,7 @@ describe 'Message' do
       {
           "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "api_version": "2010-04-01",
-          "body": "O Slash: \u00d8, PoP: \ud83d\udca9",
+          "body": "Hello! \ud83d\udc4d",
           "date_created": "Thu, 30 Jul 2015 20:12:31 +0000",
           "date_sent": "Thu, 30 Jul 2015 20:12:33 +0000",
           "date_updated": "Thu, 30 Jul 2015 20:12:33 +0000",

data/spec/integration/api/v2010/account/recording_spec.rb

@@ -38,7 +38,6 @@ describe 'Recording' do
           "date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
           "date_updated": "Fri, 14 Oct 2016 21:56:38 +0000",
           "start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
-          "end_time": "Fri, 14 Oct 2016 21:56:38 +0000",
           "price": "-0.00250",
           "price_unit": "USD",
           "duration": "4",
@@ -131,7 +130,6 @@ describe 'Recording' do
                   "date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
                   "date_updated": "Fri, 14 Oct 2016 21:56:38 +0000",
                   "start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
-                  "end_time": "Fri, 14 Oct 2016 21:56:38 +0000",
                   "price": "0.04",
                   "price_unit": "USD",
                   "duration": "4",

data/spec/integration/preview/understand/assistant/dialogue_spec.rb

@@ -0,0 +1,47 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+# 
+# frozen_string_literal: true
+
+require 'spec_helper.rb'
+
+describe 'Dialogue' do
+  it "can fetch" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.preview.understand.assistants('UAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                                .dialogues('UKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    values = {}
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'get',
+        url: 'https://preview.twilio.com/understand/Assistants/UAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Dialogues/UKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
+    ))).to eq(true)
+  end
+
+  it "receives fetch responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "assistant_sid": "UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "sid": "UKkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk",
+          "url": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Dialogues/UKkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk",
+          "data": {}
+      }
+      ]
+    ))
+
+    actual = @client.preview.understand.assistants('UAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                                       .dialogues('UKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()
+
+    expect(actual).to_not eq(nil)
+  end
+end

data/spec/integration/preview/understand/assistant_spec.rb

@@ -43,7 +43,8 @@ describe 'Assistant' do
               "model_builds": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ModelBuilds",
               "queries": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Queries",
               "assistant_fallback_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/FallbackActions",
-              "assistant_initiation_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/InitiationActions"
+              "assistant_initiation_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/InitiationActions",
+              "dialogues": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Dialogues"
           },
           "url": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "callback_url": "https://example.com/callback_url",
@@ -117,7 +118,8 @@ describe 'Assistant' do
                       "model_builds": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ModelBuilds",
                       "queries": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Queries",
                       "assistant_fallback_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/FallbackActions",
-                      "assistant_initiation_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/InitiationActions"
+                      "assistant_initiation_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/InitiationActions",
+                      "dialogues": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Dialogues"
                   },
                   "url": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                   "callback_url": "https://example.com/callback_url",
@@ -176,7 +178,8 @@ describe 'Assistant' do
               "model_builds": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ModelBuilds",
               "queries": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Queries",
               "assistant_fallback_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/FallbackActions",
-              "assistant_initiation_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/InitiationActions"
+              "assistant_initiation_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/InitiationActions",
+              "dialogues": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Dialogues"
           },
           "url": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "callback_url": "https://example.com/callback_url",
@@ -224,7 +227,8 @@ describe 'Assistant' do
               "model_builds": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ModelBuilds",
               "queries": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Queries",
               "assistant_fallback_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/FallbackActions",
-              "assistant_initiation_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/InitiationActions"
+              "assistant_initiation_actions": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/InitiationActions",
+              "dialogues": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Dialogues"
           },
           "url": "https://preview.twilio.com/understand/Assistants/UAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "callback_url": "https://example.com/callback_url",

data/spec/integration/video/v1/recording_spec.rb

@@ -43,6 +43,7 @@ describe 'Recording' do
           "container_format": "mka",
           "codec": "OPUS",
           "track_name": "A name",
+          "offset": 10,
           "grouping_sids": {
               "room_sid": "RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
           },
@@ -119,6 +120,7 @@ describe 'Recording' do
                   "container_format": "mka",
                   "codec": "OPUS",
                   "track_name": "A name",
+                  "offset": 10,
                   "grouping_sids": {
                       "room_sid": "RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                       "participant_sid": "PAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

data/spec/integration/video/v1/room/recording_spec.rb

@@ -43,6 +43,7 @@ describe 'RoomRecording' do
           "container_format": "mka",
           "codec": "OPUS",
           "track_name": "A name",
+          "offset": 10,
           "grouping_sids": {
               "room_sid": "RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
           },
@@ -124,6 +125,7 @@ describe 'RoomRecording' do
                   "container_format": "mka",
                   "codec": "OPUS",
                   "track_name": "A name",
+                  "offset": 10,
                   "grouping_sids": {
                       "room_sid": "RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                       "participant_sid": "PAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twilio-ruby
 version: !ruby/object:Gem::Version
-  version: 5.12.3
+  version: 5.12.4
 platform: ruby
 authors:
 - Twilio API Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-08-23 00:00:00.000000000 Z
+date: 2018-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jwt
@@ -344,6 +344,7 @@ files:
 - lib/twilio-ruby/rest/preview/understand/assistant.rb
 - lib/twilio-ruby/rest/preview/understand/assistant/assistant_fallback_actions.rb
 - lib/twilio-ruby/rest/preview/understand/assistant/assistant_initiation_actions.rb
+- lib/twilio-ruby/rest/preview/understand/assistant/dialogue.rb
 - lib/twilio-ruby/rest/preview/understand/assistant/field_type.rb
 - lib/twilio-ruby/rest/preview/understand/assistant/field_type/field_value.rb
 - lib/twilio-ruby/rest/preview/understand/assistant/intent.rb
@@ -627,6 +628,7 @@ files:
 - spec/integration/preview/sync/service_spec.rb
 - spec/integration/preview/understand/assistant/assistant_fallback_actions_spec.rb
 - spec/integration/preview/understand/assistant/assistant_initiation_actions_spec.rb
+- spec/integration/preview/understand/assistant/dialogue_spec.rb
 - spec/integration/preview/understand/assistant/field_type/field_value_spec.rb
 - spec/integration/preview/understand/assistant/field_type_spec.rb
 - spec/integration/preview/understand/assistant/intent/field_spec.rb
@@ -762,7 +764,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.5.2.3
 signing_key: 
 specification_version: 4
 summary: The official library for communicating with the Twilio REST API, building
@@ -932,6 +934,7 @@ test_files:
 - spec/integration/preview/sync/service_spec.rb
 - spec/integration/preview/understand/assistant/assistant_fallback_actions_spec.rb
 - spec/integration/preview/understand/assistant/assistant_initiation_actions_spec.rb
+- spec/integration/preview/understand/assistant/dialogue_spec.rb
 - spec/integration/preview/understand/assistant/field_type/field_value_spec.rb
 - spec/integration/preview/understand/assistant/field_type_spec.rb
 - spec/integration/preview/understand/assistant/intent/field_spec.rb