Skip to main content
The Speak element converts text to speech (TTS) and plays it to the caller. The text to read is the element’s content; voice, language, and loop count are set as attributes. Speak runs to completion before Vobiz moves to the next element, and posts no parameters of its own to any URL.

Attributes

Nesting rules

Speak takes plain text as its content. To use SSML markup, set voice to a Polly.<Name> voice. Speak holds text or SSML, and other verbs sit alongside it. You can nest Speak inside Gather (to prompt for input) and PreAnswer (to speak before answering).

Examples

Speak a basic message

Choose a voice and language

Use a Polly voice

Repeat a message in a loop

Set loop to repeat an announcement. Use loop="0" to repeat up to 500 times (for example, a waiting-room message) until another event moves the call forward.

Edge cases and tips

  • Escape special XML characters. Ampersands and angle brackets in the spoken text must be escaped as &amp;, &lt;, and &gt;. Unescaped characters cause an XML parsing error and the call fails.
  • A voice may not exist for every language. Not every language has both a WOMAN and a MAN voice (see the table below). If you request an unavailable combination, Vobiz falls back to the available voice for that language.
  • Speak vs Play. Use Speak for dynamic, per-call text (account balances, names, confirmation read-backs). Use Play for prerecorded audio when you need consistent quality, music, or branding.
  • Pronunciation control. For numbers, dates, currency, and pauses, use SSML to control how text is read aloud.
  • Text length. Each Speak holds up to 3,000 characters of text.
  • Keep prompts short. Callers lose attention after 15-20 seconds. Split long content into shorter Speak elements or break it up with menu prompts.

Supported voices and languages

F and M show the voice’s gender.
  • One voice per language. Where a language has one voice, WOMAN and MAN both play it. The table shows the voice each value plays.
  • English (Canada). en-CA uses the English (US) voices.
  • Regional codes. A regional code outside this table, such as nl-BE, de-AT, it-CH, es-AR, en-NZ, en-ZA, or fr-BE, uses a voice for its base language. This applies to da, nl, en, fr, de, it, pl, pt, ru, es, and sv.