twilio-ruby 5.52.0 → 5.67.3

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

@@ -194,7 +194,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)
@@ -469,7 +469,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,8 +543,460 @@ 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
+      # role:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, role: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, role: role, **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
+      # role:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, role: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, role: role, **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
+      # role:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, role: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, role: role, **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
+      # role:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, role: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, role: role, **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
 
       ##
@@ -552,16 +1004,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
 
       ##
@@ -581,16 +1039,22 @@ 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
 
       ##
@@ -617,108 +1081,221 @@ 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)
+    # Adding a Pause Between Paragraphs in <Say>
+    class SsmlP < TwiML
+      def initialize(words: nil, **keyword_args)
         super(**keyword_args)
-        @name = 'w'
-        @value = words
+        @name = 'p'
+        @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 <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
-    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 <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
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, role: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, role: role, **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, **keyword_args)
+      def initialize(words: nil, **keyword_args)
         super(**keyword_args)
         @name = 'emphasis'
-        @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 <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
+      # role:: Specify the format of the date when interpret-as is set to date
+      # keyword_args:: additional attributes
+      def say_as(words, interpretAs: nil, role: nil, **keyword_args)
+        append(SsmlSayAs.new(words, interpretAs: interpretAs, role: role, **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
 
     ##
@@ -858,7 +1435,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)
@@ -1166,9 +1743,43 @@ module Twilio
       # 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
+      # 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 virtual_agent(connector_name: nil, language: nil, sentiment_analysis: nil, status_callback: nil, **keyword_args)
-        append(VirtualAgent.new(connector_name: connector_name, language: language, sentiment_analysis: sentiment_analysis, status_callback: status_callback, **keyword_args))
+      def conversation(service_instance_sid: nil, inbound_autocreation: nil, routing_assignment_timeout: nil, inbound_timeout: 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, 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
 
@@ -1181,6 +1792,35 @@ module Twilio
 
         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
 
     ##