twilio-ruby 5.15.1 → 5.58.1

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

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -22,9 +22,12 @@ module Twilio
       # Create a new <Receive> element
       # action:: Receive action URL
       # method:: Receive action URL method
+      # media_type:: The media type used to store media in the fax media store
+      # page_size:: What size to interpret received pages as
+      # store_media:: Whether or not to store received media in the fax media store
       # keyword_args:: additional attributes
-      def receive(action: nil, method: nil, **keyword_args)
-        append(Receive.new(action: action, method: method, **keyword_args))
+      def receive(action: nil, method: nil, media_type: nil, page_size: nil, store_media: nil, **keyword_args)
+        append(Receive.new(action: action, method: method, media_type: media_type, page_size: page_size, store_media: store_media, **keyword_args))
       end
     end
 

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

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio

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

@@ -2,6 +2,10 @@ require 'nokogiri'
 
 module Twilio
   module TwiML
+    autoload :FaxResponse, File.join(File.dirname(__FILE__), "fax_response.rb")
+    autoload :MessagingResponse, File.join(File.dirname(__FILE__), "messaging_response.rb")
+    autoload :VoiceResponse, File.join(File.dirname(__FILE__), "voice_response.rb")
+    
     class TwiMLError < StandardError; end
 
     class LeafNode

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

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -46,9 +46,13 @@ module Twilio
       # recording_status_callback_event:: Recording status callback events
       # answer_on_bridge:: Preserve the ringing behavior of the inbound call until the Dialed call picks up
       # ring_tone:: Ringtone allows you to override the ringback tone that Twilio will play back to the caller while executing the Dial
+      # recording_track:: To indicate which audio track should be recorded
+      # sequential:: Used to determine if child TwiML nouns should be dialed in order, one after the other (sequential) or dial all at once (parallel). Default is false, parallel
+      # refer_url:: Webhook that will receive future SIP REFER requests
+      # refer_method:: The HTTP method to use for the refer Webhook
       # keyword_args:: additional attributes
-      def dial(number: nil, action: nil, method: nil, timeout: nil, hangup_on_star: nil, time_limit: nil, caller_id: nil, record: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, answer_on_bridge: nil, ring_tone: nil, **keyword_args)
-        dial = Dial.new(number: number, action: action, method: method, timeout: timeout, hangup_on_star: hangup_on_star, time_limit: time_limit, caller_id: caller_id, record: record, trim: trim, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, answer_on_bridge: answer_on_bridge, ring_tone: ring_tone, **keyword_args)
+      def dial(number: nil, action: nil, method: nil, timeout: nil, hangup_on_star: nil, time_limit: nil, caller_id: nil, record: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, answer_on_bridge: nil, ring_tone: nil, recording_track: nil, sequential: nil, refer_url: nil, refer_method: nil, **keyword_args)
+        dial = Dial.new(number: number, action: action, method: method, timeout: timeout, hangup_on_star: hangup_on_star, time_limit: time_limit, caller_id: caller_id, record: record, trim: trim, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, answer_on_bridge: answer_on_bridge, ring_tone: ring_tone, recording_track: recording_track, sequential: sequential, refer_url: refer_url, refer_method: refer_method, **keyword_args)
 
         yield(dial) if block_given?
         append(dial)
@@ -94,9 +98,12 @@ module Twilio
       # hints:: Speech recognition hints
       # barge_in:: Stop playing media upon speech
       # debug:: Allow debug for gather
+      # action_on_empty_result:: Force webhook to the action URL event if there is no input
+      # speech_model:: Specify the model that is best suited for your use case
+      # enhanced:: Use enhanced speech model
       # keyword_args:: additional attributes
-      def gather(input: nil, action: nil, method: nil, timeout: nil, speech_timeout: nil, max_speech_time: nil, profanity_filter: nil, finish_on_key: nil, num_digits: nil, partial_result_callback: nil, partial_result_callback_method: nil, language: nil, hints: nil, barge_in: nil, debug: nil, **keyword_args)
-        gather = Gather.new(input: input, action: action, method: method, timeout: timeout, speech_timeout: speech_timeout, max_speech_time: max_speech_time, profanity_filter: profanity_filter, finish_on_key: finish_on_key, num_digits: num_digits, partial_result_callback: partial_result_callback, partial_result_callback_method: partial_result_callback_method, language: language, hints: hints, barge_in: barge_in, debug: debug, **keyword_args)
+      def gather(input: nil, action: nil, method: nil, timeout: nil, speech_timeout: nil, max_speech_time: nil, profanity_filter: nil, finish_on_key: nil, num_digits: nil, partial_result_callback: nil, partial_result_callback_method: nil, language: nil, hints: nil, barge_in: nil, debug: nil, action_on_empty_result: nil, speech_model: nil, enhanced: nil, **keyword_args)
+        gather = Gather.new(input: input, action: action, method: method, timeout: timeout, speech_timeout: speech_timeout, max_speech_time: max_speech_time, profanity_filter: profanity_filter, finish_on_key: finish_on_key, num_digits: num_digits, partial_result_callback: partial_result_callback, partial_result_callback_method: partial_result_callback_method, language: language, hints: hints, barge_in: barge_in, debug: debug, action_on_empty_result: action_on_empty_result, speech_model: speech_model, enhanced: enhanced, **keyword_args)
 
         yield(gather) if block_given?
         append(gather)
@@ -157,11 +164,12 @@ module Twilio
       # trim:: Trim the recording
       # recording_status_callback:: Status callback URL
       # recording_status_callback_method:: Status callback URL method
+      # recording_status_callback_event:: Recording status callback events
       # transcribe:: Transcribe the recording
       # transcribe_callback:: Transcribe callback URL
       # keyword_args:: additional attributes
-      def record(action: nil, method: nil, timeout: nil, finish_on_key: nil, max_length: nil, play_beep: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, transcribe: nil, transcribe_callback: nil, **keyword_args)
-        append(Record.new(action: action, method: method, timeout: timeout, finish_on_key: finish_on_key, max_length: max_length, play_beep: play_beep, trim: trim, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, transcribe: transcribe, transcribe_callback: transcribe_callback, **keyword_args))
+      def record(action: nil, method: nil, timeout: nil, finish_on_key: nil, max_length: nil, play_beep: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, transcribe: nil, transcribe_callback: nil, **keyword_args)
+        append(Record.new(action: action, method: method, timeout: timeout, finish_on_key: finish_on_key, max_length: max_length, play_beep: play_beep, trim: trim, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, transcribe: transcribe, transcribe_callback: transcribe_callback, **keyword_args))
       end
 
       ##
@@ -212,23 +220,25 @@ module Twilio
       # Create a new <Pay> element
       # input:: Input type Twilio should accept
       # action:: Action URL
+      # bank_account_type:: Bank account type for ach transactions. If set, payment method attribute must be provided and value should be set to ach-debit. defaults to consumer-checking
       # status_callback:: Status callback URL
       # status_callback_method:: Status callback method
       # timeout:: Time to wait to gather input
       # max_attempts:: Maximum number of allowed retries when gathering input
       # security_code:: Prompt for security code
       # postal_code:: Prompt for postal code and it should be true/false or default postal code
+      # min_postal_code_length:: Prompt for minimum postal code length
       # payment_connector:: Unique name for payment connector
+      # payment_method:: Payment method to be used. defaults to credit-card
       # token_type:: Type of token
       # charge_amount:: Amount to process. If value is greater than 0 then make the payment else create a payment token
       # currency:: Currency of the amount attribute
-      # credential_sid:: SID for API keys to communicate with payment provider
       # description:: Details regarding the payment
       # valid_card_types:: Comma separated accepted card types
       # language:: Language to use
       # keyword_args:: additional attributes
-      def pay(input: nil, action: nil, status_callback: nil, status_callback_method: nil, timeout: nil, max_attempts: nil, security_code: nil, postal_code: nil, payment_connector: nil, token_type: nil, charge_amount: nil, currency: nil, credential_sid: nil, description: nil, valid_card_types: nil, language: nil, **keyword_args)
-        pay = Pay.new(input: input, action: action, status_callback: status_callback, status_callback_method: status_callback_method, timeout: timeout, max_attempts: max_attempts, security_code: security_code, postal_code: postal_code, payment_connector: payment_connector, token_type: token_type, charge_amount: charge_amount, currency: currency, credential_sid: credential_sid, description: description, valid_card_types: valid_card_types, language: language, **keyword_args)
+      def pay(input: nil, action: nil, bank_account_type: nil, status_callback: nil, status_callback_method: nil, timeout: nil, max_attempts: nil, security_code: nil, postal_code: nil, min_postal_code_length: nil, payment_connector: nil, payment_method: nil, token_type: nil, charge_amount: nil, currency: nil, description: nil, valid_card_types: nil, language: nil, **keyword_args)
+        pay = Pay.new(input: input, action: action, bank_account_type: bank_account_type, status_callback: status_callback, status_callback_method: status_callback_method, timeout: timeout, max_attempts: max_attempts, security_code: security_code, postal_code: postal_code, min_postal_code_length: min_postal_code_length, payment_connector: payment_connector, payment_method: payment_method, token_type: token_type, charge_amount: charge_amount, currency: currency, description: description, valid_card_types: valid_card_types, language: language, **keyword_args)
 
         yield(pay) if block_given?
         append(pay)
@@ -236,7 +246,7 @@ module Twilio
 
       ##
       # Create a new <Prompt> element
-      # for_:: Name of the credit card data element
+      # for_:: Name of the payment source data element
       # error_type:: Type of error
       # card_type:: Type of the credit card
       # attempt:: Current attempt count
@@ -247,6 +257,201 @@ module Twilio
         yield(prompt) if block_given?
         append(prompt)
       end
+
+      ##
+      # Create a new <Start> element
+      # action:: Action URL
+      # method:: Action URL method
+      # keyword_args:: additional attributes
+      def start(action: nil, method: nil, **keyword_args)
+        start = Start.new(action: action, method: method, **keyword_args)
+
+        yield(start) if block_given?
+        append(start)
+      end
+
+      ##
+      # Create a new <Stop> element
+      # keyword_args:: additional attributes
+      def stop(**keyword_args)
+        stop = Stop.new(**keyword_args)
+
+        yield(stop) if block_given?
+        append(stop)
+      end
+
+      ##
+      # Create a new <Refer> element
+      # action:: Action URL
+      # method:: Action URL method
+      # keyword_args:: additional attributes
+      def refer(action: nil, method: nil, **keyword_args)
+        refer = Refer.new(action: action, method: method, **keyword_args)
+
+        yield(refer) if block_given?
+        append(refer)
+      end
+    end
+
+    ##
+    # <Refer> TwiML Verb
+    class Refer < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Refer'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Sip> element
+      # sip_url:: SIP URL
+      # keyword_args:: additional attributes
+      def sip(sip_url, **keyword_args)
+        append(ReferSip.new(sip_url, **keyword_args))
+      end
+    end
+
+    ##
+    # <Sip> TwiML Noun used in <Refer>
+    class ReferSip < TwiML
+      def initialize(sip_url, **keyword_args)
+        super(**keyword_args)
+        @name = 'Sip'
+        @value = sip_url
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <Stop> TwiML Verb
+    class Stop < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Stop'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Stream> element
+      # name:: Friendly name given to the Stream
+      # connector_name:: Unique name for Stream Connector
+      # url:: URL of the remote service where the Stream is routed
+      # track:: Track to be streamed to remote service
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
+      # keyword_args:: additional attributes
+      def stream(name: nil, connector_name: nil, url: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
+
+        yield(stream) if block_given?
+        append(stream)
+      end
+
+      ##
+      # Create a new <Siprec> element
+      # name:: Friendly name given to SIPREC
+      # connector_name:: Unique name for Connector
+      # track:: Track to be streamed to remote service
+      # keyword_args:: additional attributes
+      def siprec(name: nil, connector_name: nil, track: nil, **keyword_args)
+        siprec = Siprec.new(name: name, connector_name: connector_name, track: track, **keyword_args)
+
+        yield(siprec) if block_given?
+        append(siprec)
+      end
+    end
+
+    ##
+    # <Siprec> TwiML Noun
+    class Siprec < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Siprec'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Parameter> element
+      # name:: The name of the custom parameter
+      # value:: The value of the custom parameter
+      # keyword_args:: additional attributes
+      def parameter(name: nil, value: nil, **keyword_args)
+        append(Parameter.new(name: name, value: value, **keyword_args))
+      end
+    end
+
+    ##
+    # <Parameter> TwiML Noun
+    class Parameter < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Parameter'
+
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <Stream> TwiML Noun
+    class Stream < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Stream'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Parameter> element
+      # name:: The name of the custom parameter
+      # value:: The value of the custom parameter
+      # keyword_args:: additional attributes
+      def parameter(name: nil, value: nil, **keyword_args)
+        append(Parameter.new(name: name, value: value, **keyword_args))
+      end
+    end
+
+    ##
+    # <Start> TwiML Verb
+    class Start < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Start'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Stream> element
+      # name:: Friendly name given to the Stream
+      # connector_name:: Unique name for Stream Connector
+      # url:: URL of the remote service where the Stream is routed
+      # track:: Track to be streamed to remote service
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
+      # keyword_args:: additional attributes
+      def stream(name: nil, connector_name: nil, url: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
+
+        yield(stream) if block_given?
+        append(stream)
+      end
+
+      ##
+      # Create a new <Siprec> element
+      # name:: Friendly name given to SIPREC
+      # connector_name:: Unique name for Connector
+      # track:: Track to be streamed to remote service
+      # keyword_args:: additional attributes
+      def siprec(name: nil, connector_name: nil, track: nil, **keyword_args)
+        siprec = Siprec.new(name: name, connector_name: connector_name, track: track, **keyword_args)
+
+        yield(siprec) if block_given?
+        append(siprec)
+      end
     end
 
     ##
@@ -345,7 +550,7 @@ module Twilio
       ##
       # Create a new <Lang> element
       # words:: Words to speak
-      # xml:lang:: Specify the language
+      # xmlLang:: Specify the language
       # keyword_args:: additional attributes
       def lang(words, xmlLang: nil, **keyword_args)
         append(SsmlLang.new(words, xmlLang: xmlLang, **keyword_args))
@@ -391,7 +596,7 @@ module Twilio
       ##
       # Create a new <Say-As> element
       # words:: Words to be interpreted
-      # interpret-as:: Specify the type of words are spoken
+      # interpretAs:: Specify the type of words are spoken
       # role:: Specify the format of the date when interpret-as is set to date
       # keyword_args:: additional attributes
       def say_as(words, interpretAs: nil, role: nil, **keyword_args)
@@ -401,7 +606,7 @@ module Twilio
       ##
       # Create a new <Sub> element
       # words:: Words to be substituted
-      # alias:: Substitute a different word (or pronunciation) for selected text such as an acronym or abbreviation
+      # aliasAttribute:: Substitute a different word (or pronunciation) for selected text such as an acronym or abbreviation
       # keyword_args:: additional attributes
       def sub(words, aliasAttribute: nil, **keyword_args)
         append(SsmlSub.new(words, aliasAttribute: aliasAttribute, **keyword_args))
@@ -539,7 +744,7 @@ module Twilio
 
       ##
       # Create a new <Prompt> element
-      # for_:: Name of the credit card data element
+      # for_:: Name of the payment source data element
       # error_type:: Type of error
       # card_type:: Type of the credit card
       # attempt:: Current attempt count
@@ -550,6 +755,15 @@ module Twilio
         yield(prompt) if block_given?
         append(prompt)
       end
+
+      ##
+      # Create a new <Parameter> element
+      # name:: The name of the custom parameter
+      # value:: The value of the custom parameter
+      # keyword_args:: additional attributes
+      def parameter(name: nil, value: nil, **keyword_args)
+        append(Parameter.new(name: name, value: value, **keyword_args))
+      end
     end
 
     ##
@@ -753,7 +967,7 @@ module Twilio
       # max_participants:: Maximum number of participants
       # record:: Record the conference
       # region:: Conference region
-      # whisper:: Call whisper
+      # coach:: Call coach
       # trim:: Trim the conference recording
       # status_callback_event:: Events to call status callback URL
       # status_callback:: Status callback URL
@@ -762,9 +976,11 @@ module Twilio
       # recording_status_callback_method:: Recording status callback URL method
       # recording_status_callback_event:: Recording status callback events
       # event_callback_url:: Event callback URL
+      # jitter_buffer_size:: Size of jitter buffer for participant
+      # participant_label:: A label for participant
       # keyword_args:: additional attributes
-      def conference(name, muted: nil, beep: nil, start_conference_on_enter: nil, end_conference_on_exit: nil, wait_url: nil, wait_method: nil, max_participants: nil, record: nil, region: nil, whisper: nil, trim: nil, status_callback_event: nil, status_callback: nil, status_callback_method: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, event_callback_url: nil, **keyword_args)
-        append(Conference.new(name, muted: muted, beep: beep, start_conference_on_enter: start_conference_on_enter, end_conference_on_exit: end_conference_on_exit, wait_url: wait_url, wait_method: wait_method, max_participants: max_participants, record: record, region: region, whisper: whisper, trim: trim, status_callback_event: status_callback_event, status_callback: status_callback, status_callback_method: status_callback_method, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, event_callback_url: event_callback_url, **keyword_args))
+      def conference(name, muted: nil, beep: nil, start_conference_on_enter: nil, end_conference_on_exit: nil, wait_url: nil, wait_method: nil, max_participants: nil, record: nil, region: nil, coach: nil, trim: nil, status_callback_event: nil, status_callback: nil, status_callback_method: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, event_callback_url: nil, jitter_buffer_size: nil, participant_label: nil, **keyword_args)
+        append(Conference.new(name, muted: muted, beep: beep, start_conference_on_enter: start_conference_on_enter, end_conference_on_exit: end_conference_on_exit, wait_url: wait_url, wait_method: wait_method, max_participants: max_participants, record: record, region: region, coach: coach, trim: trim, status_callback_event: status_callback_event, status_callback: status_callback, status_callback_method: status_callback_method, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, event_callback_url: event_callback_url, jitter_buffer_size: jitter_buffer_size, participant_label: participant_label, **keyword_args))
       end
 
       ##
@@ -776,9 +992,10 @@ module Twilio
       # status_callback_event:: Events to call status callback
       # status_callback:: Status callback URL
       # status_callback_method:: Status callback URL method
+      # byoc:: BYOC trunk SID (Beta)
       # keyword_args:: additional attributes
-      def number(phone_number, send_digits: nil, url: nil, method: nil, status_callback_event: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
-        append(Number.new(phone_number, send_digits: send_digits, url: url, method: method, status_callback_event: status_callback_event, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args))
+      def number(phone_number, send_digits: nil, url: nil, method: nil, status_callback_event: nil, status_callback: nil, status_callback_method: nil, byoc: nil, **keyword_args)
+        append(Number.new(phone_number, send_digits: send_digits, url: url, method: method, status_callback_event: status_callback_event, status_callback: status_callback, status_callback_method: status_callback_method, byoc: byoc, **keyword_args))
       end
 
       ##
@@ -889,17 +1106,6 @@ module Twilio
       end
     end
 
-    ##
-    # <Parameter> TwiML Noun
-    class Parameter < TwiML
-      def initialize(**keyword_args)
-        super(**keyword_args)
-        @name = 'Parameter'
-
-        yield(self) if block_given?
-      end
-    end
-
     ##
     # <Identity> TwiML Noun
     class Identity < TwiML
@@ -924,10 +1130,10 @@ module Twilio
       ##
       # Create a new <Room> element
       # name:: Room name
-      # participantIdentity:: Participant identity when connecting to the Room
+      # participant_identity:: Participant identity when connecting to the Room
       # keyword_args:: additional attributes
-      def room(name, participantIdentity: nil, **keyword_args)
-        append(Room.new(name, participantIdentity: participantIdentity, **keyword_args))
+      def room(name, participant_identity: nil, **keyword_args)
+        append(Room.new(name, participant_identity: participant_identity, **keyword_args))
       end
 
       ##
@@ -937,6 +1143,44 @@ module Twilio
       def autopilot(name, **keyword_args)
         append(Autopilot.new(name, **keyword_args))
       end
+
+      ##
+      # Create a new <Stream> element
+      # name:: Friendly name given to the Stream
+      # connector_name:: Unique name for Stream Connector
+      # url:: URL of the remote service where the Stream is routed
+      # track:: Track to be streamed to remote service
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
+      # keyword_args:: additional attributes
+      def stream(name: nil, connector_name: nil, url: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
+
+        yield(stream) if block_given?
+        append(stream)
+      end
+
+      ##
+      # Create a new <VirtualAgent> element
+      # connector_name:: Defines the conversation profile Dialogflow needs to use
+      # language:: Language to be used by Dialogflow to transcribe speech
+      # sentiment_analysis:: Whether sentiment analysis needs to be enabled or not
+      # status_callback:: URL to post status callbacks from Twilio
+      # keyword_args:: additional attributes
+      def virtual_agent(connector_name: nil, language: nil, sentiment_analysis: nil, status_callback: nil, **keyword_args)
+        append(VirtualAgent.new(connector_name: connector_name, language: language, sentiment_analysis: sentiment_analysis, status_callback: status_callback, **keyword_args))
+      end
+    end
+
+    ##
+    # <VirtualAgent> TwiML Noun
+    class VirtualAgent < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'VirtualAgent'
+
+        yield(self) if block_given?
+      end
     end
 
     ##