twilio-ruby 5.46.0 → 7.10.1

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

@@ -48,9 +48,12 @@ module Twilio
       # 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
+      # events:: Subscription to events
       # 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, recording_track: nil, sequential: 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, **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, events: 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, events: events, **keyword_args)
 
         yield(dial) if block_given?
         append(dial)
@@ -67,13 +70,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)
@@ -111,7 +115,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
 
       ##
@@ -184,7 +191,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
 
       ##
@@ -192,7 +202,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)
@@ -248,9 +258,10 @@ module Twilio
       # 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)
@@ -337,9 +348,11 @@ module Twilio
       # 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, **keyword_args)
-        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, **keyword_args)
+      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)
@@ -350,25 +363,60 @@ module Twilio
       # 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, **keyword_args)
-        siprec = Siprec.new(name: name, connector_name: connector_name, track: track, **keyword_args)
+      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
+      # intelligence_service:: The SID or the unique name of the Intelligence Service to be used
+      # 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, intelligence_service: 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, intelligence_service: intelligence_service, **keyword_args)
+
+        yield(transcription) if block_given?
+        append(transcription)
+      end
     end
 
     ##
-    # <Siprec> TwiML Noun
-    class Siprec < TwiML
+    # <Transcription> TwiML Noun
+    class Transcription < TwiML
       def initialize(**keyword_args)
         super(**keyword_args)
-        @name = 'Siprec'
+        @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
@@ -390,6 +438,37 @@ module Twilio
       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
@@ -426,9 +505,11 @@ module Twilio
       # 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, **keyword_args)
-        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, **keyword_args)
+      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)
@@ -439,13 +520,63 @@ module Twilio
       # 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, **keyword_args)
-        siprec = Siprec.new(name: name, connector_name: connector_name, track: track, **keyword_args)
+      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
+      # intelligence_service:: The SID or the unique name of the Intelligence Service to be used
+      # 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, intelligence_service: 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, intelligence_service: intelligence_service, **keyword_args)
+
+        yield(transcription) if block_given?
+        append(transcription)
+      end
+
+      ##
+      # Create a new <Recording> element
+      # recording_status_callback:: Recording Status Callback URL
+      # recording_status_callback_method:: Recording Status Callback URL method
+      # recording_status_callback_event:: Recording Status Callback Events
+      # trim:: Trim the recording
+      # track:: To indicate which audio track should be recorded
+      # channels:: The recording channels for the final recording
+      # keyword_args:: additional attributes
+      def recording(recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, trim: nil, track: nil, channels: nil, **keyword_args)
+        append(Recording.new(recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, trim: trim, track: track, channels: channels, **keyword_args))
+      end
+    end
+
+    ##
+    # <Recording> TwiML Noun
+    class Recording < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Recording'
+
+        yield(self) if block_given?
+      end
     end
 
     ##
@@ -463,7 +594,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)
@@ -537,8 +668,11 @@ 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
 
       ##
@@ -546,16 +680,22 @@ module Twilio
       # words:: Words to speak
       # xmlLang:: Specify the language
       # keyword_args:: additional attributes
-      def lang(words, xmlLang: nil, **keyword_args)
-        append(SsmlLang.new(words, xmlLang: xmlLang, **keyword_args))
+      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, **keyword_args)
-        append(SsmlP.new(words, **keyword_args))
+      def p(words: nil, **keyword_args)
+        p = SsmlP.new(words: words, **keyword_args)
+
+        yield(p) if block_given?
+        append(p)
       end
 
       ##
@@ -575,26 +715,32 @@ 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))
+      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, **keyword_args)
-        append(SsmlS.new(words, **keyword_args))
+      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
-      # role:: Specify the format of the date when interpret-as is set to date
+      # 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
 
       ##
@@ -611,20 +757,87 @@ 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))
+      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, **keyword_args)
+      def initialize(words: nil, **keyword_args)
         super(**keyword_args)
         @name = 'w'
-        @value = words
+        @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
 
     ##
@@ -649,137 +862,642 @@ module Twilio
       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)
+      def initialize(words: nil, **keyword_args)
         super(**keyword_args)
         @name = 'prosody'
-        @value = words
+        @value = words unless words.nil?
         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?
+      ##
+      # 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
-    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
+      ##
+      # 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)
 
-    ##
-    # 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?
+        yield(emphasis) if block_given?
+        append(emphasis)
       end
-    end
 
-    ##
-    # Emphasizing Words in <Say>
-    class SsmlEmphasis < TwiML
-      def initialize(words, **keyword_args)
-        super(**keyword_args)
-        @name = 'emphasis'
-        @value = words
-        yield(self) if block_given?
+      ##
+      # 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
-    end
 
-    ##
-    # Adding a Pause in <Say>
-    class SsmlBreak < TwiML
-      def initialize(**keyword_args)
-        super(**keyword_args)
-        @name = 'break'
+      ##
+      # 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(self) if block_given?
+        yield(p) if block_given?
+        append(p)
       end
-    end
-
-    ##
-    # <Pay> Twiml Verb
-    class Pay < TwiML
-      def initialize(**keyword_args)
-        super(**keyword_args)
-        @name = 'Pay'
 
-        yield(self) if block_given?
+      ##
+      # 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 <Prompt> 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
+      # 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 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 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(prompt) if block_given?
-        append(prompt)
+        yield(prosody) if block_given?
+        append(prosody)
       end
 
       ##
-      # Create a new <Parameter> element
-      # name:: The name of the custom parameter
-      # value:: The value of the custom parameter
+      # Create a new <S> element
+      # words:: Words to speak
       # keyword_args:: additional attributes
-      def parameter(name: nil, value: nil, **keyword_args)
-        append(Parameter.new(name: name, value: value, **keyword_args))
-      end
-    end
+      def s(words: nil, **keyword_args)
+        s = SsmlS.new(words: words, **keyword_args)
 
-    ##
-    # <Sms> TwiML Noun
-    class Sms < TwiML
-      def initialize(message, **keyword_args)
-        super(**keyword_args)
-        @name = 'Sms'
-        @value = message
-        yield(self) if block_given?
+        yield(s) if block_given?
+        append(s)
       end
-    end
 
-    ##
-    # <Reject> TwiML Verb
-    class Reject < TwiML
-      def initialize(**keyword_args)
+      ##
+      # 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
+
+      ##
+      # 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
+
+    ##
+    # Emphasizing Words in <Say>
+    class SsmlEmphasis < TwiML
+      def initialize(words: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 'emphasis'
+        @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
+
+    ##
+    # Adding a Pause in <Say>
+    class SsmlBreak < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'break'
+
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <Pay> Twiml Verb
+    class Pay < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Pay'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Prompt> 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, 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
+
+    ##
+    # <Sms> TwiML Noun
+    class Sms < TwiML
+      def initialize(message, **keyword_args)
+        super(**keyword_args)
+        @name = 'Sms'
+        @value = message
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <Reject> TwiML Verb
+    class Reject < TwiML
+      def initialize(**keyword_args)
         super(**keyword_args)
         @name = 'Reject'
 
         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
 
     ##
@@ -835,6 +1553,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
 
     ##
@@ -852,7 +1579,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)
@@ -987,9 +1714,16 @@ module Twilio
       # 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, 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))
+      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
 
       ##
@@ -1022,19 +1756,174 @@ 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: nil, 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)
+        sip = Sip.new(sip_url: 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)
+
+        yield(sip) if block_given?
+        append(sip)
+      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
+
+      ##
+      # Create a new <WhatsApp> element
+      # phone_number:: WhatsApp Phone Number to dial
+      # 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
+      # keyword_args:: additional attributes
+      def whats_app(phone_number, url: nil, method: nil, status_callback_event: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        append(WhatsApp.new(phone_number, url: url, method: method, status_callback_event: status_callback_event, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args))
+      end
+    end
+
+    ##
+    # <WhatsApp> TwiML Noun
+    class WhatsApp < TwiML
+      def initialize(phone_number, **keyword_args)
+        super(**keyword_args)
+        @name = 'WhatsApp'
+        @value = phone_number
+        yield(self) if block_given?
+      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
 
     ##
     # <Sip> TwiML Noun
     class Sip < TwiML
-      def initialize(sip_url, **keyword_args)
+      def initialize(sip_url: nil, **keyword_args)
         super(**keyword_args)
         @name = 'Sip'
-        @value = sip_url
+        @value = sip_url unless sip_url.nil?
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Uri> element
+      # sip_url:: The SIP URI
+      # priority:: The priority of this SIP URI
+      # weight:: The weight of this SIP URI
+      # username:: The username for authentication
+      # password:: The password for authentication
+      # keyword_args:: additional attributes
+      def uri(sip_url: nil, priority: nil, weight: nil, username: nil, password: nil, **keyword_args)
+        append(SipUri.new(sip_url: sip_url, priority: priority, weight: weight, username: username, password: password, **keyword_args))
+      end
+
+      ##
+      # Create a new <Headers> element
+      # keyword_args:: additional attributes
+      def headers(**keyword_args)
+        headers = Headers.new(**keyword_args)
+
+        yield(headers) if block_given?
+        append(headers)
+      end
+    end
+
+    ##
+    # The SIP headers to include in the request
+    class Headers < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Headers'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Header> element
+      # name:: The name of the custom header
+      # value:: The value of the custom header
+      # keyword_args:: additional attributes
+      def header(name: nil, value: nil, **keyword_args)
+        append(Header.new(name: name, value: value, **keyword_args))
+      end
+    end
+
+    ##
+    # A custom SIP header to include in the request
+    class Header < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Header'
+
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # The SIP URI to dial. Multiple Uri elements can be provided, in which case they will be attempted in priority order. URIs with the same priority will be selected proportionally based on its weight.
+    class SipUri < TwiML
+      def initialize(sip_url: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 'Uri'
+        @value = sip_url unless sip_url.nil?
         yield(self) if block_given?
       end
     end
@@ -1144,13 +2033,268 @@ module Twilio
       # 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, **keyword_args)
-        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, **keyword_args)
+      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
+
+      ##
+      # Create a new <ConversationRelay> element
+      # url:: URL of the remote service where the session is connected to
+      # language:: Language to be used for both text-to-speech and transcription
+      # tts_language:: Language to be used for text-to-speech
+      # transcription_language:: Language to be used for transcription
+      # tts_provider:: Provider to be used for text-to-speech
+      # voice:: Voice to be used for text-to-speech
+      # transcription_provider:: Provider to be used for transcription
+      # speech_model:: Speech model to be used for transcription
+      # profanity_filter:: Whether profanities should be filtered out of the speech transcription
+      # dtmf_detection:: Whether DTMF tones should be detected and reported in speech transcription
+      # welcome_greeting:: The sentence to be played automatically when the session is connected
+      # partial_prompts:: Whether partial prompts should be reported to WebSocket server before the caller finishes speaking
+      # welcome_greeting_interruptible:: "Whether and how the input from a caller, such as speaking or DTMF can interrupt the welcome greeting
+      # interruptible:: Whether and how the input from a caller, such as speaking or DTMF can interrupt the play of text-to-speech
+      # preemptible:: Whether subsequent text-to-speech or play media can interrupt the on-going play of text-to-speech or media
+      # hints:: Phrases to help better accuracy in speech recognition of these pharases
+      # intelligence_service:: The Conversational Intelligence Service id or unique name to be used for the session
+      # report_input_during_agent_speech:: Whether prompts should be reported to WebSocket server when text-to-speech playing and interrupt is disabled
+      # elevenlabs_text_normalization:: When using ElevenLabs as TTS provider, this parameter allows you to enable or disable its text normalization feature
+      # interrupt_sensitivity:: Set the sensitivity of the interrupt feature for speech. The value can be low, medium, or high
+      # debug:: Multiple debug options to be used for troubleshooting
+      # keyword_args:: additional attributes
+      def conversation_relay(url: nil, language: nil, tts_language: nil, transcription_language: nil, tts_provider: nil, voice: nil, transcription_provider: nil, speech_model: nil, profanity_filter: nil, dtmf_detection: nil, welcome_greeting: nil, partial_prompts: nil, welcome_greeting_interruptible: nil, interruptible: nil, preemptible: nil, hints: nil, intelligence_service: nil, report_input_during_agent_speech: nil, elevenlabs_text_normalization: nil, interrupt_sensitivity: nil, debug: nil, **keyword_args)
+        conversation_relay = ConversationRelay.new(url: url, language: language, tts_language: tts_language, transcription_language: transcription_language, tts_provider: tts_provider, voice: voice, transcription_provider: transcription_provider, speech_model: speech_model, profanity_filter: profanity_filter, dtmf_detection: dtmf_detection, welcome_greeting: welcome_greeting, partial_prompts: partial_prompts, welcome_greeting_interruptible: welcome_greeting_interruptible, interruptible: interruptible, preemptible: preemptible, hints: hints, intelligence_service: intelligence_service, report_input_during_agent_speech: report_input_during_agent_speech, elevenlabs_text_normalization: elevenlabs_text_normalization, interrupt_sensitivity: interrupt_sensitivity, debug: debug, **keyword_args)
+
+        yield(conversation_relay) if block_given?
+        append(conversation_relay)
+      end
+
+      ##
+      # Create a new <Assistant> element
+      # id:: The assistant ID of the AI Assistant
+      # language:: Language to be used for both text-to-speech and transcription
+      # tts_language:: Language to be used for text-to-speech
+      # transcription_language:: Language to be used for transcription
+      # tts_provider:: Provider to be used for text-to-speech
+      # voice:: Voice to be used for text-to-speech
+      # transcription_provider:: Provider to be used for transcription
+      # speech_model:: Speech model to be used for transcription
+      # profanity_filter:: Whether profanities should be filtered out of the speech transcription
+      # dtmf_detection:: Whether DTMF tones should be detected and reported in speech transcription
+      # welcome_greeting:: The sentence to be played automatically when the session is connected
+      # partial_prompts:: Whether partial prompts should be reported to WebSocket server before the caller finishes speaking
+      # welcome_greeting_interruptible:: "Whether and how the input from a caller, such as speaking or DTMF can interrupt the welcome greeting
+      # interruptible:: Whether and how the input from a caller, such as speaking or DTMF can interrupt the play of text-to-speech
+      # preemptible:: Whether subsequent text-to-speech or play media can interrupt the on-going play of text-to-speech or media
+      # hints:: Phrases to help better accuracy in speech recognition of these pharases
+      # intelligence_service:: The Conversational Intelligence Service id or unique name to be used for the session
+      # report_input_during_agent_speech:: Whether prompts should be reported to WebSocket server when text-to-speech playing and interrupt is disabled
+      # elevenlabs_text_normalization:: When using ElevenLabs as TTS provider, this parameter allows you to enable or disable its text normalization feature
+      # interrupt_sensitivity:: Set the sensitivity of the interrupt feature for speech. The value can be low, medium, or high
+      # debug:: Multiple debug options to be used for troubleshooting
+      # keyword_args:: additional attributes
+      def assistant(id: nil, language: nil, tts_language: nil, transcription_language: nil, tts_provider: nil, voice: nil, transcription_provider: nil, speech_model: nil, profanity_filter: nil, dtmf_detection: nil, welcome_greeting: nil, partial_prompts: nil, welcome_greeting_interruptible: nil, interruptible: nil, preemptible: nil, hints: nil, intelligence_service: nil, report_input_during_agent_speech: nil, elevenlabs_text_normalization: nil, interrupt_sensitivity: nil, debug: nil, **keyword_args)
+        assistant = Assistant.new(id: id, language: language, tts_language: tts_language, transcription_language: transcription_language, tts_provider: tts_provider, voice: voice, transcription_provider: transcription_provider, speech_model: speech_model, profanity_filter: profanity_filter, dtmf_detection: dtmf_detection, welcome_greeting: welcome_greeting, partial_prompts: partial_prompts, welcome_greeting_interruptible: welcome_greeting_interruptible, interruptible: interruptible, preemptible: preemptible, hints: hints, intelligence_service: intelligence_service, report_input_during_agent_speech: report_input_during_agent_speech, elevenlabs_text_normalization: elevenlabs_text_normalization, interrupt_sensitivity: interrupt_sensitivity, debug: debug, **keyword_args)
+
+        yield(assistant) if block_given?
+        append(assistant)
+      end
+
+      ##
+      # Create a new <AiSession> element
+      # ai_connector:: The unique name or installed add-on sid that identifies the installed addon resource for the AI Connector
+      # ai_session_configuration:: The unique name or id of the AiSession Configuration resource.
+      # keyword_args:: additional attributes
+      def ai_session(ai_connector: nil, ai_session_configuration: nil, **keyword_args)
+        append(AiSession.new(ai_connector: ai_connector, ai_session_configuration: ai_session_configuration, **keyword_args))
+      end
+
+      ##
+      # Create a new <ConversationRelaySession> element
+      # connector:: The unique name or installed add-on sid that identifies the installed addon resource for the ConversationRelaySession Connector
+      # session_configuration:: The unique name or id of the ConversationRelaySession  Configuration resource.
+      # keyword_args:: additional attributes
+      def conversation_relay_session(connector: nil, session_configuration: nil, **keyword_args)
+        append(ConversationRelaySession.new(connector: connector, session_configuration: session_configuration, **keyword_args))
+      end
+    end
+
+    ##
+    # <ConversationRelaySession> TwiML Noun
+    class ConversationRelaySession < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'ConversationRelaySession'
+
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <AiSession> TwiML Noun
+    class AiSession < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'AiSession'
+
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <Assistant> TwiML Noun
+    class Assistant < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Assistant'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Language> element
+      # code:: Language code of this language setting is for
+      # tts_provider:: Provider to be used for text-to-speech of this language
+      # voice:: Voice to be used for text-to-speech of this language
+      # transcription_provider:: Provider to be used for transcription of this language
+      # speech_model:: Speech model to be used for transcription of this language
+      # keyword_args:: additional attributes
+      def language(code: nil, tts_provider: nil, voice: nil, transcription_provider: nil, speech_model: nil, **keyword_args)
+        append(Language.new(code: code, tts_provider: tts_provider, voice: voice, transcription_provider: transcription_provider, speech_model: speech_model, **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
+
+    ##
+    # <Language> TwiML Noun
+    class Language < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Language'
+
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <ConversationRelay> TwiML Noun
+    class ConversationRelay < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'ConversationRelay'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Language> element
+      # code:: Language code of this language setting is for
+      # tts_provider:: Provider to be used for text-to-speech of this language
+      # voice:: Voice to be used for text-to-speech of this language
+      # transcription_provider:: Provider to be used for transcription of this language
+      # speech_model:: Speech model to be used for transcription of this language
+      # keyword_args:: additional attributes
+      def language(code: nil, tts_provider: nil, voice: nil, transcription_provider: nil, speech_model: nil, **keyword_args)
+        append(Language.new(code: code, tts_provider: tts_provider, voice: voice, transcription_provider: transcription_provider, speech_model: speech_model, **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
+
+    ##
+    # <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
 
     ##