twilio-ruby 5.23.0 → 7.2.3

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)
@@ -65,13 +69,14 @@ module Twilio
       # Create a new <Enqueue> element
       # name:: Friendly name
       # action:: Action URL
+      # max_queue_size:: Maximum size of queue
       # method:: Action URL method
       # wait_url:: Wait URL
       # wait_url_method:: Wait URL method
       # workflow_sid:: TaskRouter Workflow SID
       # keyword_args:: additional attributes
-      def enqueue(name: nil, action: nil, method: nil, wait_url: nil, wait_url_method: nil, workflow_sid: nil, **keyword_args)
-        enqueue = Enqueue.new(name: name, action: action, method: method, wait_url: wait_url, wait_url_method: wait_url_method, workflow_sid: workflow_sid, **keyword_args)
+      def enqueue(name: nil, action: nil, max_queue_size: nil, method: nil, wait_url: nil, wait_url_method: nil, workflow_sid: nil, **keyword_args)
+        enqueue = Enqueue.new(name: name, action: action, max_queue_size: max_queue_size, method: method, wait_url: wait_url, wait_url_method: wait_url_method, workflow_sid: workflow_sid, **keyword_args)
 
         yield(enqueue) if block_given?
         append(enqueue)
@@ -95,9 +100,11 @@ module Twilio
       # 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, action_on_empty_result: 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, **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)
@@ -107,7 +114,10 @@ module Twilio
       # Create a new <Hangup> element
       # keyword_args:: additional attributes
       def hangup(**keyword_args)
-        append(Hangup.new(**keyword_args))
+        hangup = Hangup.new(**keyword_args)
+
+        yield(hangup) if block_given?
+        append(hangup)
       end
 
       ##
@@ -180,7 +190,10 @@ module Twilio
       # reason:: Rejection reason
       # keyword_args:: additional attributes
       def reject(reason: nil, **keyword_args)
-        append(Reject.new(reason: reason, **keyword_args))
+        reject = Reject.new(reason: reason, **keyword_args)
+
+        yield(reject) if block_given?
+        append(reject)
       end
 
       ##
@@ -188,7 +201,7 @@ module Twilio
       # message:: Message to say
       # voice:: Voice to use
       # loop:: Times to loop message
-      # language:: Message langauge
+      # language:: Message language
       # keyword_args:: additional attributes
       def say(message: nil, voice: nil, loop: nil, language: nil, **keyword_args)
         say = Say.new(message: message, voice: voice, loop: loop, language: language, **keyword_args)
@@ -214,13 +227,16 @@ 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
@@ -228,8 +244,8 @@ module Twilio
       # 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, 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, 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)
@@ -237,17 +253,303 @@ 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
+      # require_matching_inputs:: Require customer to input requested information twice and verify matching.
       # keyword_args:: additional attributes
-      def prompt(for_: nil, error_type: nil, card_type: nil, attempt: nil, **keyword_args)
-        prompt = Prompt.new(for_: for_, error_type: error_type, card_type: card_type, attempt: attempt, **keyword_args)
+      def prompt(for_: nil, error_type: nil, card_type: nil, attempt: nil, require_matching_inputs: nil, **keyword_args)
+        prompt = Prompt.new(for_: for_, error_type: error_type, card_type: card_type, attempt: attempt, require_matching_inputs: require_matching_inputs, **keyword_args)
 
         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
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
+      # keyword_args:: additional attributes
+      def siprec(name: nil, connector_name: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        siprec = Siprec.new(name: name, connector_name: connector_name, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
+
+        yield(siprec) if block_given?
+        append(siprec)
+      end
+
+      ##
+      # Create a new <Transcription> element
+      # name:: Friendly name given to the Transcription
+      # track:: Track to be analyze by the provider
+      # status_callback_url:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
+      # inbound_track_label:: Friendly name given to the Inbound Track
+      # outbound_track_label:: Friendly name given to the Outbound Track Label
+      # partial_results:: Indicates if partial results are going to be send to the customer
+      # language_code:: Language Code used by the transcription engine
+      # transcription_engine:: Transcription Engine to be used
+      # profanity_filter:: Enable Profanity Filter
+      # speech_model:: Speech Model used by the transcription engine
+      # hints:: Hints to be provided to the transcription engine
+      # enable_automatic_punctuation:: Enable Automatic Punctuation
+      # keyword_args:: additional attributes
+      def transcription(name: nil, track: nil, status_callback_url: nil, status_callback_method: nil, inbound_track_label: nil, outbound_track_label: nil, partial_results: nil, language_code: nil, transcription_engine: nil, profanity_filter: nil, speech_model: nil, hints: nil, enable_automatic_punctuation: nil, **keyword_args)
+        transcription = Transcription.new(name: name, track: track, status_callback_url: status_callback_url, status_callback_method: status_callback_method, inbound_track_label: inbound_track_label, outbound_track_label: outbound_track_label, partial_results: partial_results, language_code: language_code, transcription_engine: transcription_engine, profanity_filter: profanity_filter, speech_model: speech_model, hints: hints, enable_automatic_punctuation: enable_automatic_punctuation, **keyword_args)
+
+        yield(transcription) if block_given?
+        append(transcription)
+      end
+    end
+
+    ##
+    # <Transcription> TwiML Noun
+    class Transcription < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Transcription'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Config> element
+      # name:: The name of the custom config
+      # value:: The value of the custom config
+      # keyword_args:: additional attributes
+      def config(name: nil, value: nil, **keyword_args)
+        append(Config.new(name: name, value: value, **keyword_args))
+      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
+
+    ##
+    # <Config> TwiML Noun
+    class Config < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Config'
+
+        yield(self) if block_given?
+      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
+
+    ##
+    # <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
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
+      # keyword_args:: additional attributes
+      def siprec(name: nil, connector_name: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        siprec = Siprec.new(name: name, connector_name: connector_name, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
+
+        yield(siprec) if block_given?
+        append(siprec)
+      end
+
+      ##
+      # Create a new <Transcription> element
+      # name:: Friendly name given to the Transcription
+      # track:: Track to be analyze by the provider
+      # status_callback_url:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
+      # inbound_track_label:: Friendly name given to the Inbound Track
+      # outbound_track_label:: Friendly name given to the Outbound Track Label
+      # partial_results:: Indicates if partial results are going to be send to the customer
+      # language_code:: Language Code used by the transcription engine
+      # transcription_engine:: Transcription Engine to be used
+      # profanity_filter:: Enable Profanity Filter
+      # speech_model:: Speech Model used by the transcription engine
+      # hints:: Hints to be provided to the transcription engine
+      # enable_automatic_punctuation:: Enable Automatic Punctuation
+      # keyword_args:: additional attributes
+      def transcription(name: nil, track: nil, status_callback_url: nil, status_callback_method: nil, inbound_track_label: nil, outbound_track_label: nil, partial_results: nil, language_code: nil, transcription_engine: nil, profanity_filter: nil, speech_model: nil, hints: nil, enable_automatic_punctuation: nil, **keyword_args)
+        transcription = Transcription.new(name: name, track: track, status_callback_url: status_callback_url, status_callback_method: status_callback_method, inbound_track_label: inbound_track_label, outbound_track_label: outbound_track_label, partial_results: partial_results, language_code: language_code, transcription_engine: transcription_engine, profanity_filter: profanity_filter, speech_model: speech_model, hints: hints, enable_automatic_punctuation: enable_automatic_punctuation, **keyword_args)
+
+        yield(transcription) if block_given?
+        append(transcription)
+      end
     end
 
     ##
@@ -265,7 +567,7 @@ module Twilio
       # message:: Message to say
       # voice:: Voice to use
       # loop:: Times to loop message
-      # language:: Message langauge
+      # language:: Message language
       # keyword_args:: additional attributes
       def say(message: nil, voice: nil, loop: nil, language: nil, **keyword_args)
         say = Say.new(message: message, voice: voice, loop: loop, language: language, **keyword_args)
@@ -302,26 +604,706 @@ module Twilio
 
         yield(self) if block_given?
       end
-    end
+    end
+
+    ##
+    # <Play> TwiML Verb
+    class Play < TwiML
+      def initialize(url: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 'Play'
+        @value = url unless url.nil?
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <Say> TwiML Verb
+    class Say < TwiML
+      def initialize(message: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 'Say'
+        @value = message unless message.nil?
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Break> element
+      # strength:: Set a pause based on strength
+      # time:: Set a pause to a specific length of time in seconds or milliseconds, available values: [number]s, [number]ms
+      # keyword_args:: additional attributes
+      def break(strength: nil, time: nil, **keyword_args)
+        append(SsmlBreak.new(strength: strength, time: time, **keyword_args))
+      end
+
+      ##
+      # Create a new <Emphasis> element
+      # words:: Words to emphasize
+      # level:: Specify the degree of emphasis
+      # keyword_args:: additional attributes
+      def emphasis(words: nil, level: nil, **keyword_args)
+        emphasis = SsmlEmphasis.new(words: words, level: level, **keyword_args)
+
+        yield(emphasis) if block_given?
+        append(emphasis)
+      end
+
+      ##
+      # Create a new <Lang> element
+      # words:: Words to speak
+      # xmlLang:: Specify the language
+      # keyword_args:: additional attributes
+      def lang(words: nil, xmlLang: nil, **keyword_args)
+        lang = SsmlLang.new(words: words, xmlLang: xmlLang, **keyword_args)
+
+        yield(lang) if block_given?
+        append(lang)
+      end
+
+      ##
+      # Create a new <P> element
+      # words:: Words to speak
+      # keyword_args:: additional attributes
+      def p(words: nil, **keyword_args)
+        p = SsmlP.new(words: words, **keyword_args)
+
+        yield(p) if block_given?
+        append(p)
+      end
+
+      ##
+      # Create a new <Phoneme> element
+      # words:: Words to speak
+      # alphabet:: Specify the phonetic alphabet
+      # ph:: Specifiy the phonetic symbols for pronunciation
+      # keyword_args:: additional attributes
+      def phoneme(words, alphabet: nil, ph: nil, **keyword_args)
+        append(SsmlPhoneme.new(words, alphabet: alphabet, ph: ph, **keyword_args))
+      end
+
+      ##
+      # Create a new <Prosody> element
+      # words:: Words to speak
+      # volume:: Specify the volume, available values: default, silent, x-soft, soft, medium, loud, x-loud, +ndB, -ndB
+      # rate:: Specify the rate, available values: x-slow, slow, medium, fast, x-fast, n%
+      # pitch:: Specify the pitch, available values: default, x-low, low, medium, high, x-high, +n%, -n%
+      # keyword_args:: additional attributes
+      def prosody(words: nil, volume: nil, rate: nil, pitch: nil, **keyword_args)
+        prosody = SsmlProsody.new(words: words, volume: volume, rate: rate, pitch: pitch, **keyword_args)
+
+        yield(prosody) if block_given?
+        append(prosody)
+      end
+
+      ##
+      # Create a new <S> element
+      # words:: Words to speak
+      # keyword_args:: additional attributes
+      def s(words: nil, **keyword_args)
+        s = SsmlS.new(words: words, **keyword_args)
+
+        yield(s) if block_given?
+        append(s)
+      end
+
+      ##
+      # Create a new <Say-As> element
+      # words:: Words to be interpreted
+      # interpretAs:: Specify the type of words are spoken
+      # format:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, format: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, format: format, **keyword_args))
+      end
+
+      ##
+      # Create a new <Sub> element
+      # words:: Words to be substituted
+      # 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))
+      end
+
+      ##
+      # Create a new <W> element
+      # words:: Words to speak
+      # role:: Customize the pronunciation of words by specifying the word’s part of speech or alternate meaning
+      # keyword_args:: additional attributes
+      def w(words: nil, role: nil, **keyword_args)
+        w = SsmlW.new(words: words, role: role, **keyword_args)
+
+        yield(w) if block_given?
+        append(w)
+      end
+    end
+
+    ##
+    # Improving Pronunciation by Specifying Parts of Speech in <Say>
+    class SsmlW < TwiML
+      def initialize(words: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 'w'
+        @value = words unless words.nil?
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Break> element
+      # strength:: Set a pause based on strength
+      # time:: Set a pause to a specific length of time in seconds or milliseconds, available values: [number]s, [number]ms
+      # keyword_args:: additional attributes
+      def break(strength: nil, time: nil, **keyword_args)
+        append(SsmlBreak.new(strength: strength, time: time, **keyword_args))
+      end
+
+      ##
+      # Create a new <Emphasis> element
+      # words:: Words to emphasize
+      # level:: Specify the degree of emphasis
+      # keyword_args:: additional attributes
+      def emphasis(words: nil, level: nil, **keyword_args)
+        emphasis = SsmlEmphasis.new(words: words, level: level, **keyword_args)
+
+        yield(emphasis) if block_given?
+        append(emphasis)
+      end
+
+      ##
+      # Create a new <Phoneme> element
+      # words:: Words to speak
+      # alphabet:: Specify the phonetic alphabet
+      # ph:: Specifiy the phonetic symbols for pronunciation
+      # keyword_args:: additional attributes
+      def phoneme(words, alphabet: nil, ph: nil, **keyword_args)
+        append(SsmlPhoneme.new(words, alphabet: alphabet, ph: ph, **keyword_args))
+      end
+
+      ##
+      # Create a new <Prosody> element
+      # words:: Words to speak
+      # volume:: Specify the volume, available values: default, silent, x-soft, soft, medium, loud, x-loud, +ndB, -ndB
+      # rate:: Specify the rate, available values: x-slow, slow, medium, fast, x-fast, n%
+      # pitch:: Specify the pitch, available values: default, x-low, low, medium, high, x-high, +n%, -n%
+      # keyword_args:: additional attributes
+      def prosody(words: nil, volume: nil, rate: nil, pitch: nil, **keyword_args)
+        prosody = SsmlProsody.new(words: words, volume: volume, rate: rate, pitch: pitch, **keyword_args)
+
+        yield(prosody) if block_given?
+        append(prosody)
+      end
+
+      ##
+      # Create a new <Say-As> element
+      # words:: Words to be interpreted
+      # interpretAs:: Specify the type of words are spoken
+      # format:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, format: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, format: format, **keyword_args))
+      end
+
+      ##
+      # Create a new <Sub> element
+      # words:: Words to be substituted
+      # 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))
+      end
+    end
+
+    ##
+    # Pronouncing Acronyms and Abbreviations in <Say>
+    class SsmlSub < TwiML
+      def initialize(words, **keyword_args)
+        super(**keyword_args)
+        @name = 'sub'
+        @value = words
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # Controlling How Special Types of Words Are Spoken in <Say>
+    class SsmlSayAs < TwiML
+      def initialize(words, **keyword_args)
+        super(**keyword_args)
+        @name = 'say-as'
+        @value = words
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # Controling Volume, Speaking Rate, and Pitch in <Say>
+    class SsmlProsody < TwiML
+      def initialize(words: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 'prosody'
+        @value = words unless words.nil?
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Break> element
+      # strength:: Set a pause based on strength
+      # time:: Set a pause to a specific length of time in seconds or milliseconds, available values: [number]s, [number]ms
+      # keyword_args:: additional attributes
+      def break(strength: nil, time: nil, **keyword_args)
+        append(SsmlBreak.new(strength: strength, time: time, **keyword_args))
+      end
+
+      ##
+      # Create a new <Emphasis> element
+      # words:: Words to emphasize
+      # level:: Specify the degree of emphasis
+      # keyword_args:: additional attributes
+      def emphasis(words: nil, level: nil, **keyword_args)
+        emphasis = SsmlEmphasis.new(words: words, level: level, **keyword_args)
+
+        yield(emphasis) if block_given?
+        append(emphasis)
+      end
+
+      ##
+      # Create a new <Lang> element
+      # words:: Words to speak
+      # xmlLang:: Specify the language
+      # keyword_args:: additional attributes
+      def lang(words: nil, xmlLang: nil, **keyword_args)
+        lang = SsmlLang.new(words: words, xmlLang: xmlLang, **keyword_args)
+
+        yield(lang) if block_given?
+        append(lang)
+      end
+
+      ##
+      # Create a new <P> element
+      # words:: Words to speak
+      # keyword_args:: additional attributes
+      def p(words: nil, **keyword_args)
+        p = SsmlP.new(words: words, **keyword_args)
+
+        yield(p) if block_given?
+        append(p)
+      end
+
+      ##
+      # Create a new <Phoneme> element
+      # words:: Words to speak
+      # alphabet:: Specify the phonetic alphabet
+      # ph:: Specifiy the phonetic symbols for pronunciation
+      # keyword_args:: additional attributes
+      def phoneme(words, alphabet: nil, ph: nil, **keyword_args)
+        append(SsmlPhoneme.new(words, alphabet: alphabet, ph: ph, **keyword_args))
+      end
+
+      ##
+      # Create a new <Prosody> element
+      # words:: Words to speak
+      # volume:: Specify the volume, available values: default, silent, x-soft, soft, medium, loud, x-loud, +ndB, -ndB
+      # rate:: Specify the rate, available values: x-slow, slow, medium, fast, x-fast, n%
+      # pitch:: Specify the pitch, available values: default, x-low, low, medium, high, x-high, +n%, -n%
+      # keyword_args:: additional attributes
+      def prosody(words: nil, volume: nil, rate: nil, pitch: nil, **keyword_args)
+        prosody = SsmlProsody.new(words: words, volume: volume, rate: rate, pitch: pitch, **keyword_args)
+
+        yield(prosody) if block_given?
+        append(prosody)
+      end
+
+      ##
+      # Create a new <S> element
+      # words:: Words to speak
+      # keyword_args:: additional attributes
+      def s(words: nil, **keyword_args)
+        s = SsmlS.new(words: words, **keyword_args)
+
+        yield(s) if block_given?
+        append(s)
+      end
+
+      ##
+      # Create a new <Say-As> element
+      # words:: Words to be interpreted
+      # interpretAs:: Specify the type of words are spoken
+      # format:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, format: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, format: format, **keyword_args))
+      end
+
+      ##
+      # Create a new <Sub> element
+      # words:: Words to be substituted
+      # 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))
+      end
+
+      ##
+      # Create a new <W> element
+      # words:: Words to speak
+      # role:: Customize the pronunciation of words by specifying the word’s part of speech or alternate meaning
+      # keyword_args:: additional attributes
+      def w(words: nil, role: nil, **keyword_args)
+        w = SsmlW.new(words: words, role: role, **keyword_args)
+
+        yield(w) if block_given?
+        append(w)
+      end
+    end
+
+    ##
+    # Adding A Pause Between Sentences in <Say>
+    class SsmlS < TwiML
+      def initialize(words: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 's'
+        @value = words unless words.nil?
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Break> element
+      # strength:: Set a pause based on strength
+      # time:: Set a pause to a specific length of time in seconds or milliseconds, available values: [number]s, [number]ms
+      # keyword_args:: additional attributes
+      def break(strength: nil, time: nil, **keyword_args)
+        append(SsmlBreak.new(strength: strength, time: time, **keyword_args))
+      end
+
+      ##
+      # Create a new <Emphasis> element
+      # words:: Words to emphasize
+      # level:: Specify the degree of emphasis
+      # keyword_args:: additional attributes
+      def emphasis(words: nil, level: nil, **keyword_args)
+        emphasis = SsmlEmphasis.new(words: words, level: level, **keyword_args)
+
+        yield(emphasis) if block_given?
+        append(emphasis)
+      end
+
+      ##
+      # Create a new <Lang> element
+      # words:: Words to speak
+      # xmlLang:: Specify the language
+      # keyword_args:: additional attributes
+      def lang(words: nil, xmlLang: nil, **keyword_args)
+        lang = SsmlLang.new(words: words, xmlLang: xmlLang, **keyword_args)
+
+        yield(lang) if block_given?
+        append(lang)
+      end
+
+      ##
+      # Create a new <Phoneme> element
+      # words:: Words to speak
+      # alphabet:: Specify the phonetic alphabet
+      # ph:: Specifiy the phonetic symbols for pronunciation
+      # keyword_args:: additional attributes
+      def phoneme(words, alphabet: nil, ph: nil, **keyword_args)
+        append(SsmlPhoneme.new(words, alphabet: alphabet, ph: ph, **keyword_args))
+      end
+
+      ##
+      # Create a new <Prosody> element
+      # words:: Words to speak
+      # volume:: Specify the volume, available values: default, silent, x-soft, soft, medium, loud, x-loud, +ndB, -ndB
+      # rate:: Specify the rate, available values: x-slow, slow, medium, fast, x-fast, n%
+      # pitch:: Specify the pitch, available values: default, x-low, low, medium, high, x-high, +n%, -n%
+      # keyword_args:: additional attributes
+      def prosody(words: nil, volume: nil, rate: nil, pitch: nil, **keyword_args)
+        prosody = SsmlProsody.new(words: words, volume: volume, rate: rate, pitch: pitch, **keyword_args)
+
+        yield(prosody) if block_given?
+        append(prosody)
+      end
+
+      ##
+      # Create a new <Say-As> element
+      # words:: Words to be interpreted
+      # interpretAs:: Specify the type of words are spoken
+      # format:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, format: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, format: format, **keyword_args))
+      end
+
+      ##
+      # Create a new <Sub> element
+      # words:: Words to be substituted
+      # 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))
+      end
+
+      ##
+      # Create a new <W> element
+      # words:: Words to speak
+      # role:: Customize the pronunciation of words by specifying the word’s part of speech or alternate meaning
+      # keyword_args:: additional attributes
+      def w(words: nil, role: nil, **keyword_args)
+        w = SsmlW.new(words: words, role: role, **keyword_args)
+
+        yield(w) if block_given?
+        append(w)
+      end
+    end
+
+    ##
+    # Using Phonetic Pronunciation in <Say>
+    class SsmlPhoneme < TwiML
+      def initialize(words, **keyword_args)
+        super(**keyword_args)
+        @name = 'phoneme'
+        @value = words
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # Specifying Another Language for Specific Words in <Say>
+    class SsmlLang < TwiML
+      def initialize(words: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 'lang'
+        @value = words unless words.nil?
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Break> element
+      # strength:: Set a pause based on strength
+      # time:: Set a pause to a specific length of time in seconds or milliseconds, available values: [number]s, [number]ms
+      # keyword_args:: additional attributes
+      def break(strength: nil, time: nil, **keyword_args)
+        append(SsmlBreak.new(strength: strength, time: time, **keyword_args))
+      end
+
+      ##
+      # Create a new <Emphasis> element
+      # words:: Words to emphasize
+      # level:: Specify the degree of emphasis
+      # keyword_args:: additional attributes
+      def emphasis(words: nil, level: nil, **keyword_args)
+        emphasis = SsmlEmphasis.new(words: words, level: level, **keyword_args)
+
+        yield(emphasis) if block_given?
+        append(emphasis)
+      end
+
+      ##
+      # Create a new <Lang> element
+      # words:: Words to speak
+      # xmlLang:: Specify the language
+      # keyword_args:: additional attributes
+      def lang(words: nil, xmlLang: nil, **keyword_args)
+        lang = SsmlLang.new(words: words, xmlLang: xmlLang, **keyword_args)
+
+        yield(lang) if block_given?
+        append(lang)
+      end
+
+      ##
+      # Create a new <P> element
+      # words:: Words to speak
+      # keyword_args:: additional attributes
+      def p(words: nil, **keyword_args)
+        p = SsmlP.new(words: words, **keyword_args)
+
+        yield(p) if block_given?
+        append(p)
+      end
+
+      ##
+      # Create a new <Phoneme> element
+      # words:: Words to speak
+      # alphabet:: Specify the phonetic alphabet
+      # ph:: Specifiy the phonetic symbols for pronunciation
+      # keyword_args:: additional attributes
+      def phoneme(words, alphabet: nil, ph: nil, **keyword_args)
+        append(SsmlPhoneme.new(words, alphabet: alphabet, ph: ph, **keyword_args))
+      end
+
+      ##
+      # Create a new <Prosody> element
+      # words:: Words to speak
+      # volume:: Specify the volume, available values: default, silent, x-soft, soft, medium, loud, x-loud, +ndB, -ndB
+      # rate:: Specify the rate, available values: x-slow, slow, medium, fast, x-fast, n%
+      # pitch:: Specify the pitch, available values: default, x-low, low, medium, high, x-high, +n%, -n%
+      # keyword_args:: additional attributes
+      def prosody(words: nil, volume: nil, rate: nil, pitch: nil, **keyword_args)
+        prosody = SsmlProsody.new(words: words, volume: volume, rate: rate, pitch: pitch, **keyword_args)
+
+        yield(prosody) if block_given?
+        append(prosody)
+      end
+
+      ##
+      # Create a new <S> element
+      # words:: Words to speak
+      # keyword_args:: additional attributes
+      def s(words: nil, **keyword_args)
+        s = SsmlS.new(words: words, **keyword_args)
+
+        yield(s) if block_given?
+        append(s)
+      end
+
+      ##
+      # Create a new <Say-As> element
+      # words:: Words to be interpreted
+      # interpretAs:: Specify the type of words are spoken
+      # format:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, format: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, format: format, **keyword_args))
+      end
+
+      ##
+      # Create a new <Sub> element
+      # words:: Words to be substituted
+      # 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))
+      end
+
+      ##
+      # Create a new <W> element
+      # words:: Words to speak
+      # role:: Customize the pronunciation of words by specifying the word’s part of speech or alternate meaning
+      # keyword_args:: additional attributes
+      def w(words: nil, role: nil, **keyword_args)
+        w = SsmlW.new(words: words, role: role, **keyword_args)
+
+        yield(w) if block_given?
+        append(w)
+      end
+    end
+
+    ##
+    # Adding a Pause Between Paragraphs in <Say>
+    class SsmlP < TwiML
+      def initialize(words: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 'p'
+        @value = words unless words.nil?
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Break> element
+      # strength:: Set a pause based on strength
+      # time:: Set a pause to a specific length of time in seconds or milliseconds, available values: [number]s, [number]ms
+      # keyword_args:: additional attributes
+      def break(strength: nil, time: nil, **keyword_args)
+        append(SsmlBreak.new(strength: strength, time: time, **keyword_args))
+      end
+
+      ##
+      # Create a new <Emphasis> element
+      # words:: Words to emphasize
+      # level:: Specify the degree of emphasis
+      # keyword_args:: additional attributes
+      def emphasis(words: nil, level: nil, **keyword_args)
+        emphasis = SsmlEmphasis.new(words: words, level: level, **keyword_args)
+
+        yield(emphasis) if block_given?
+        append(emphasis)
+      end
+
+      ##
+      # Create a new <Lang> element
+      # words:: Words to speak
+      # xmlLang:: Specify the language
+      # keyword_args:: additional attributes
+      def lang(words: nil, xmlLang: nil, **keyword_args)
+        lang = SsmlLang.new(words: words, xmlLang: xmlLang, **keyword_args)
+
+        yield(lang) if block_given?
+        append(lang)
+      end
+
+      ##
+      # Create a new <Phoneme> element
+      # words:: Words to speak
+      # alphabet:: Specify the phonetic alphabet
+      # ph:: Specifiy the phonetic symbols for pronunciation
+      # keyword_args:: additional attributes
+      def phoneme(words, alphabet: nil, ph: nil, **keyword_args)
+        append(SsmlPhoneme.new(words, alphabet: alphabet, ph: ph, **keyword_args))
+      end
+
+      ##
+      # Create a new <Prosody> element
+      # words:: Words to speak
+      # volume:: Specify the volume, available values: default, silent, x-soft, soft, medium, loud, x-loud, +ndB, -ndB
+      # rate:: Specify the rate, available values: x-slow, slow, medium, fast, x-fast, n%
+      # pitch:: Specify the pitch, available values: default, x-low, low, medium, high, x-high, +n%, -n%
+      # keyword_args:: additional attributes
+      def prosody(words: nil, volume: nil, rate: nil, pitch: nil, **keyword_args)
+        prosody = SsmlProsody.new(words: words, volume: volume, rate: rate, pitch: pitch, **keyword_args)
+
+        yield(prosody) if block_given?
+        append(prosody)
+      end
+
+      ##
+      # Create a new <S> element
+      # words:: Words to speak
+      # keyword_args:: additional attributes
+      def s(words: nil, **keyword_args)
+        s = SsmlS.new(words: words, **keyword_args)
+
+        yield(s) if block_given?
+        append(s)
+      end
+
+      ##
+      # Create a new <Say-As> element
+      # words:: Words to be interpreted
+      # interpretAs:: Specify the type of words are spoken
+      # format:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, format: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, format: format, **keyword_args))
+      end
+
+      ##
+      # Create a new <Sub> element
+      # words:: Words to be substituted
+      # 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))
+      end
 
-    ##
-    # <Play> TwiML Verb
-    class Play < TwiML
-      def initialize(url: nil, **keyword_args)
-        super(**keyword_args)
-        @name = 'Play'
-        @value = url unless url.nil?
-        yield(self) if block_given?
+      ##
+      # Create a new <W> element
+      # words:: Words to speak
+      # role:: Customize the pronunciation of words by specifying the word’s part of speech or alternate meaning
+      # keyword_args:: additional attributes
+      def w(words: nil, role: nil, **keyword_args)
+        w = SsmlW.new(words: words, role: role, **keyword_args)
+
+        yield(w) if block_given?
+        append(w)
       end
     end
 
     ##
-    # <Say> TwiML Verb
-    class Say < TwiML
-      def initialize(message: nil, **keyword_args)
+    # Emphasizing Words in <Say>
+    class SsmlEmphasis < TwiML
+      def initialize(words: nil, **keyword_args)
         super(**keyword_args)
-        @name = 'Say'
-        @value = message unless message.nil?
+        @name = 'emphasis'
+        @value = words unless words.nil?
         yield(self) if block_given?
       end
 
@@ -339,25 +1321,23 @@ module Twilio
       # words:: Words to emphasize
       # level:: Specify the degree of emphasis
       # keyword_args:: additional attributes
-      def emphasis(words, level: nil, **keyword_args)
-        append(SsmlEmphasis.new(words, level: level, **keyword_args))
+      def emphasis(words: nil, level: nil, **keyword_args)
+        emphasis = SsmlEmphasis.new(words: words, level: level, **keyword_args)
+
+        yield(emphasis) if block_given?
+        append(emphasis)
       end
 
       ##
       # 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))
-      end
+      def lang(words: nil, xmlLang: nil, **keyword_args)
+        lang = SsmlLang.new(words: words, xmlLang: xmlLang, **keyword_args)
 
-      ##
-      # Create a new <P> element
-      # words:: Words to speak
-      # keyword_args:: additional attributes
-      def p(words, **keyword_args)
-        append(SsmlP.new(words, **keyword_args))
+        yield(lang) if block_given?
+        append(lang)
       end
 
       ##
@@ -377,32 +1357,27 @@ module Twilio
       # rate:: Specify the rate, available values: x-slow, slow, medium, fast, x-fast, n%
       # pitch:: Specify the pitch, available values: default, x-low, low, medium, high, x-high, +n%, -n%
       # keyword_args:: additional attributes
-      def prosody(words, volume: nil, rate: nil, pitch: nil, **keyword_args)
-        append(SsmlProsody.new(words, volume: volume, rate: rate, pitch: pitch, **keyword_args))
-      end
+      def prosody(words: nil, volume: nil, rate: nil, pitch: nil, **keyword_args)
+        prosody = SsmlProsody.new(words: words, volume: volume, rate: rate, pitch: pitch, **keyword_args)
 
-      ##
-      # Create a new <S> element
-      # words:: Words to speak
-      # keyword_args:: additional attributes
-      def s(words, **keyword_args)
-        append(SsmlS.new(words, **keyword_args))
+        yield(prosody) if block_given?
+        append(prosody)
       end
 
       ##
       # Create a new <Say-As> element
       # words:: Words to be interpreted
-      # interpret-as:: Specify the type of words are spoken
-      # role:: Specify the format of the date when interpret-as is set to date
+      # interpretAs:: Specify the type of words are spoken
+      # format:: 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)
-        append(SsmlSayAs.new(words, interpretAs: interpretAs, role: role, **keyword_args))
+      def say_as(words, interpretAs: nil, format: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, format: format, **keyword_args))
       end
 
       ##
       # 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))
@@ -413,107 +1388,11 @@ module Twilio
       # words:: Words to speak
       # role:: Customize the pronunciation of words by specifying the word’s part of speech or alternate meaning
       # keyword_args:: additional attributes
-      def w(words, role: nil, **keyword_args)
-        append(SsmlW.new(words, role: role, **keyword_args))
-      end
-    end
-
-    ##
-    # Improving Pronunciation by Specifying Parts of Speech in <Say>
-    class SsmlW < TwiML
-      def initialize(words, **keyword_args)
-        super(**keyword_args)
-        @name = 'w'
-        @value = words
-        yield(self) if block_given?
-      end
-    end
-
-    ##
-    # Pronouncing Acronyms and Abbreviations in <Say>
-    class SsmlSub < TwiML
-      def initialize(words, **keyword_args)
-        super(**keyword_args)
-        @name = 'sub'
-        @value = words
-        yield(self) if block_given?
-      end
-    end
-
-    ##
-    # Controlling How Special Types of Words Are Spoken in <Say>
-    class SsmlSayAs < TwiML
-      def initialize(words, **keyword_args)
-        super(**keyword_args)
-        @name = 'say-as'
-        @value = words
-        yield(self) if block_given?
-      end
-    end
-
-    ##
-    # Adding A Pause Between Sentences in <Say>
-    class SsmlS < TwiML
-      def initialize(words, **keyword_args)
-        super(**keyword_args)
-        @name = 's'
-        @value = words
-        yield(self) if block_given?
-      end
-    end
-
-    ##
-    # Controling Volume, Speaking Rate, and Pitch in <Say>
-    class SsmlProsody < TwiML
-      def initialize(words, **keyword_args)
-        super(**keyword_args)
-        @name = 'prosody'
-        @value = words
-        yield(self) if block_given?
-      end
-    end
-
-    ##
-    # Using Phonetic Pronunciation in <Say>
-    class SsmlPhoneme < TwiML
-      def initialize(words, **keyword_args)
-        super(**keyword_args)
-        @name = 'phoneme'
-        @value = words
-        yield(self) if block_given?
-      end
-    end
-
-    ##
-    # Adding a Pause Between Paragraphs in <Say>
-    class SsmlP < TwiML
-      def initialize(words, **keyword_args)
-        super(**keyword_args)
-        @name = 'p'
-        @value = words
-        yield(self) if block_given?
-      end
-    end
-
-    ##
-    # Specifying Another Language for Specific Words in <Say>
-    class SsmlLang < TwiML
-      def initialize(words, **keyword_args)
-        super(**keyword_args)
-        @name = 'lang'
-        @value = words
-        yield(self) if block_given?
-      end
-    end
+      def w(words: nil, role: nil, **keyword_args)
+        w = SsmlW.new(words: words, role: role, **keyword_args)
 
-    ##
-    # Emphasizing Words in <Say>
-    class SsmlEmphasis < TwiML
-      def initialize(words, **keyword_args)
-        super(**keyword_args)
-        @name = 'emphasis'
-        @value = words
-        yield(self) if block_given?
+        yield(w) if block_given?
+        append(w)
       end
     end
 
@@ -540,17 +1419,27 @@ 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
+      # require_matching_inputs:: Require customer to input requested information twice and verify matching.
       # keyword_args:: additional attributes
-      def prompt(for_: nil, error_type: nil, card_type: nil, attempt: nil, **keyword_args)
-        prompt = Prompt.new(for_: for_, error_type: error_type, card_type: card_type, attempt: attempt, **keyword_args)
+      def prompt(for_: nil, error_type: nil, card_type: nil, attempt: nil, require_matching_inputs: nil, **keyword_args)
+        prompt = Prompt.new(for_: for_, error_type: error_type, card_type: card_type, attempt: attempt, require_matching_inputs: require_matching_inputs, **keyword_args)
 
         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
 
     ##
@@ -573,6 +1462,15 @@ module Twilio
 
         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
 
     ##
@@ -628,6 +1526,15 @@ module Twilio
 
         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
 
     ##
@@ -645,7 +1552,7 @@ module Twilio
       # message:: Message to say
       # voice:: Voice to use
       # loop:: Times to loop message
-      # language:: Message langauge
+      # language:: Message language
       # keyword_args:: additional attributes
       def say(message: nil, voice: nil, loop: nil, language: nil, **keyword_args)
         say = Say.new(message: message, voice: voice, loop: loop, language: language, **keyword_args)
@@ -754,7 +1661,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
@@ -763,9 +1670,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
 
       ##
@@ -777,9 +1686,17 @@ 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)
+      # machine_detection:: Enable machine detection or end of greeting detection
+      # amd_status_callback_method:: HTTP Method to use with amd_status_callback
+      # amd_status_callback:: The URL we should call to send amd status information to your application
+      # machine_detection_timeout:: Number of seconds to wait for machine detection
+      # machine_detection_speech_threshold:: Number of milliseconds for measuring stick for the length of the speech activity
+      # machine_detection_speech_end_threshold:: Number of milliseconds of silence after speech activity
+      # machine_detection_silence_timeout:: Number of milliseconds of initial silence
       # 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, machine_detection: nil, amd_status_callback_method: nil, amd_status_callback: nil, machine_detection_timeout: nil, machine_detection_speech_threshold: nil, machine_detection_speech_end_threshold: nil, machine_detection_silence_timeout: 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, machine_detection: machine_detection, amd_status_callback_method: amd_status_callback_method, amd_status_callback: amd_status_callback, machine_detection_timeout: machine_detection_timeout, machine_detection_speech_threshold: machine_detection_speech_threshold, machine_detection_speech_end_threshold: machine_detection_speech_end_threshold, machine_detection_silence_timeout: machine_detection_silence_timeout, **keyword_args))
       end
 
       ##
@@ -812,9 +1729,73 @@ module Twilio
       # status_callback_event:: Status callback events
       # status_callback:: Status callback URL
       # status_callback_method:: Status callback URL method
+      # machine_detection:: Enable machine detection or end of greeting detection
+      # amd_status_callback_method:: HTTP Method to use with amd_status_callback
+      # amd_status_callback:: The URL we should call to send amd status information to your application
+      # machine_detection_timeout:: Number of seconds to wait for machine detection
+      # machine_detection_speech_threshold:: Number of milliseconds for measuring stick for the length of the speech activity
+      # machine_detection_speech_end_threshold:: Number of milliseconds of silence after speech activity
+      # machine_detection_silence_timeout:: Number of milliseconds of initial silence
+      # keyword_args:: additional attributes
+      def sip(sip_url, username: nil, password: nil, url: nil, method: nil, status_callback_event: nil, status_callback: nil, status_callback_method: nil, machine_detection: nil, amd_status_callback_method: nil, amd_status_callback: nil, machine_detection_timeout: nil, machine_detection_speech_threshold: nil, machine_detection_speech_end_threshold: nil, machine_detection_silence_timeout: nil, **keyword_args)
+        append(Sip.new(sip_url, username: username, password: password, url: url, method: method, status_callback_event: status_callback_event, status_callback: status_callback, status_callback_method: status_callback_method, machine_detection: machine_detection, amd_status_callback_method: amd_status_callback_method, amd_status_callback: amd_status_callback, machine_detection_timeout: machine_detection_timeout, machine_detection_speech_threshold: machine_detection_speech_threshold, machine_detection_speech_end_threshold: machine_detection_speech_end_threshold, machine_detection_silence_timeout: machine_detection_silence_timeout, **keyword_args))
+      end
+
+      ##
+      # Create a new <Application> element
+      # application_sid:: Application sid
+      # url:: TwiML URL
+      # method:: TwiML URL Method
+      # status_callback_event:: Events to trigger status callback
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL Method
+      # customer_id:: Identity of the customer calling application
+      # copy_parent_to:: Copy parent call To field to called application side, otherwise use the application sid as To field
+      # keyword_args:: additional attributes
+      def application(application_sid: nil, url: nil, method: nil, status_callback_event: nil, status_callback: nil, status_callback_method: nil, customer_id: nil, copy_parent_to: nil, **keyword_args)
+        application = Application.new(application_sid: application_sid, url: url, method: method, status_callback_event: status_callback_event, status_callback: status_callback, status_callback_method: status_callback_method, customer_id: customer_id, copy_parent_to: copy_parent_to, **keyword_args)
+
+        yield(application) if block_given?
+        append(application)
+      end
+    end
+
+    ##
+    # <Application> TwiML Noun
+    class Application < TwiML
+      def initialize(application_sid: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 'Application'
+        @value = application_sid unless application_sid.nil?
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <ApplicationSid> element
+      # sid:: Application sid to dial
+      # keyword_args:: additional attributes
+      def application_sid(sid, **keyword_args)
+        append(ApplicationSid.new(sid, **keyword_args))
+      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 sip(sip_url, username: nil, password: nil, url: nil, method: nil, status_callback_event: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
-        append(Sip.new(sip_url, username: username, password: password, url: url, method: method, status_callback_event: status_callback_event, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args))
+      def parameter(name: nil, value: nil, **keyword_args)
+        append(Parameter.new(name: name, value: value, **keyword_args))
+      end
+    end
+
+    ##
+    # <ApplicationSid> TwiML Noun
+    class ApplicationSid < TwiML
+      def initialize(sid, **keyword_args)
+        super(**keyword_args)
+        @name = 'ApplicationSid'
+        @value = sid
+        yield(self) if block_given?
       end
     end
 
@@ -890,17 +1871,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
@@ -925,10 +1895,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
 
       ##
@@ -938,6 +1908,98 @@ 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
+      # status_callback_method:: HTTP method to use when requesting the status callback URL
+      # keyword_args:: additional attributes
+      def virtual_agent(connector_name: nil, language: nil, sentiment_analysis: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        virtual_agent = VirtualAgent.new(connector_name: connector_name, language: language, sentiment_analysis: sentiment_analysis, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
+
+        yield(virtual_agent) if block_given?
+        append(virtual_agent)
+      end
+
+      ##
+      # Create a new <Conversation> element
+      # service_instance_sid:: Service instance Sid
+      # inbound_autocreation:: Inbound autocreation
+      # routing_assignment_timeout:: Routing assignment timeout
+      # inbound_timeout:: Inbound timeout
+      # url:: TwiML URL
+      # method:: TwiML URL method
+      # record:: Record
+      # trim:: Trim
+      # recording_status_callback:: Recording status callback URL
+      # recording_status_callback_method:: Recording status callback URL method
+      # recording_status_callback_event:: Recording status callback events
+      # status_callback:: Status callback URL
+      # status_callback_method:: Status callback URL method
+      # status_callback_event:: Events to call status callback URL
+      # keyword_args:: additional attributes
+      def conversation(service_instance_sid: nil, inbound_autocreation: nil, routing_assignment_timeout: nil, inbound_timeout: nil, url: nil, method: nil, record: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, status_callback: nil, status_callback_method: nil, status_callback_event: nil, **keyword_args)
+        append(Conversation.new(service_instance_sid: service_instance_sid, inbound_autocreation: inbound_autocreation, routing_assignment_timeout: routing_assignment_timeout, inbound_timeout: inbound_timeout, url: url, method: method, 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, status_callback: status_callback, status_callback_method: status_callback_method, status_callback_event: status_callback_event, **keyword_args))
+      end
+    end
+
+    ##
+    # <Conversation> TwiML Noun
+    class Conversation < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Conversation'
+
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <VirtualAgent> TwiML Noun
+    class VirtualAgent < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'VirtualAgent'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Config> element
+      # name:: The name of the custom config
+      # value:: The value of the custom config
+      # keyword_args:: additional attributes
+      def config(name: nil, value: nil, **keyword_args)
+        append(Config.new(name: name, value: value, **keyword_args))
+      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
 
     ##