In this section, you will learn how to use the Jovo SpeechBuilder, a helper class that makes it easier to build speech responses and add variety to your voice app.

Introduction to the SpeechBuilder

With the speechBuilder, you can assemble a speech element by adding different types of input. Factory-like methods allow you to add your output subsequently.

The Jovo object (this) consists of two pre-configured speechBuilder elements: this.$speech and this.$reprompt.

Alternatively, you can initialize a new speechBuilder object by using this.speechBuilder().

You can see all the features below.


Here is what's currently possible with speechBuilder:

Method Description
addText(text) Add plain text for text-to-speech
addT(key) Access i18n language resources for multilingual voice apps
addAudio(url, alternativeText) Add link to audio file and alternative text for Google Assistant. For more information on using audio files, see App Logic > Output > play.
addBreak(time) Add a break to the output. Make sure to add a unit, e.g. "300ms"
addSentence(text) Add a text within a sentence tag
addSayAsCardinal(text) Reads a number as cardinal
addSayAsOrdinal(text) Reads a number as ordinal
addSayAsCharacters(text) Reads all characters of a provided string
toString() Returns the content of the speechBuilder object as a string.

Add Variety to Your Speech Output

You can also use speechBuilder to add variety to your speech output. Here are a few things that work:

Randomized Output

For any of the speechBuilder methods, you can add an array of elements. The voice app will then pick a random item:


You can also add a condition as a parameter to any speechBuilder method. The output will only added if the condition is true.


Similar to conditions, you can also add probabilities to speechBuilder methods. For example, if you add 0.3, the element will only be added 3 out of 10 times.

Comments and Questions

Any specific questions? Just drop them below or join the Jovo Community Forum.

Join Our Newsletter

Be the first to get our free tutorials, courses, and other resources for voice app developers.