twilio-ruby 5.47.0 → 5.74.0

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

@@ -69,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)
@@ -194,7 +195,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)
@@ -250,9 +251,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)
@@ -469,7 +471,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)
@@ -543,25 +545,593 @@ 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
+      # 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 <Lang> element
+      # Create a new <S> element
       # 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 s(words: nil, **keyword_args)
+        s = SsmlS.new(words: words, **keyword_args)
+
+        yield(s) if block_given?
+        append(s)
       end
 
       ##
-      # Create a new <P> element
+      # 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 p(words, **keyword_args)
-        append(SsmlP.new(words, **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
 
       ##
@@ -581,26 +1151,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
 
       ##
@@ -617,107 +1193,110 @@ 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)
+    # Emphasizing Words in <Say>
+    class SsmlEmphasis < TwiML
+      def initialize(words: nil, **keyword_args)
         super(**keyword_args)
-        @name = 'w'
-        @value = words
+        @name = 'emphasis'
+        @value = words unless words.nil?
         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?
+      ##
+      # 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
 
-    ##
-    # 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?
+      ##
+      # 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
-    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?
+      ##
+      # 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
 
-    ##
-    # 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?
+      ##
+      # 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
-    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 <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
-    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?
+      ##
+      # 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
-    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?
+      ##
+      # 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
 
-    ##
-    # 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 <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
 
@@ -748,9 +1327,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)
@@ -858,7 +1438,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)
@@ -993,9 +1573,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
 
       ##
@@ -1028,9 +1615,16 @@ 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, **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 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
     end
 
@@ -1159,6 +1753,93 @@ module Twilio
         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
+
+    ##
+    # <Config> TwiML Noun
+    class Config < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Config'
+
+        yield(self) if block_given?
+      end
     end
 
     ##