> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Control how your bot pronounces content in voice conversations

Bots are generally pretty good at guessing how to pronounce content, but
sometimes you'll want to override the default behaviour to make the
content sound better. To do this, you can use Speech Synthesis Markup
Language, or SSML. You can view more in-depth documentation at [Speech Synthesis Markup Language (SSML)](https://cloud.google.com/text-to-speech/docs/ssml) at Google
Cloud's documentation, but this topic covers the most common use cases.

## Important things to know about SSML\[#UUID-b608df9d-dde4-57e2-e459-cc5940550154_section-idm4649826247904033650878298014]

There are some important things you should know about how to use SSML in
Ada:

* You can only use SSML with voices provided by Google; voices provided
  by ElevenLabs don't support it. If you need the degree of control SSML
  provides, make sure the voice your bot uses is listed as a Google
  voice. For more information, see
  [Choose a speaking voice for your bot](/scripted/docs/build-and-maintain-your-bot/create-phone-conversations-with-voice/get-started-with-voice#UUID-e17eb05a-42bb-6a3d-e842-36988f98b48c_section-idm4503712244217633647134198894).

* SSML uses `<speak>` tags. If you use SSML in a block, the block needs
  to start with `<speak>` and end with `</speak>`, so the tag contains
  **all** of the block's content - not just the content you want to
  target with the SSML.

* You can nest tags in each other. For example, if you want your bot to
  read out an order number slowly, you can use the code
  `<speak>Your order number is <prosody rate="slow"><say-as interpret-as="characters">12569</say-as></prosody>.</speak>`.
  Note that there is still only one `<speak>` tag that contains all of
  the block's content.

Anytime a block contains content to read out, the top of the block has a
**Play** icon ![](/_fern-files/_img/a9979c1a067a0eb39c3cb227864948a0cfc38b68da70f0a99f1b2b977f52265b.webp) you can
click to test out your content, so you can fine tune the adjustments you
make to the SSML.

## Pronounce characters individually\[#UUID-b608df9d-dde4-57e2-e459-cc5940550154_section-idm4609094424832033650902909511]

By default, bots usually try to pronounce content together as full words
or numbers as opposed to reading out the individual characters. To make
the bot pronounce them separately, you can either space out the
characters (e.g., "A S A P"), or use
`<speak><say-as interpret-as="characters">CONTENT_HERE</say-as></speak>`.

![](/_fern-files/_img/6a7429b5d4124b1a2fb2ebd3a35dcefaf19077691eabad7aafe3a20dc4ceb096.webp)

You can also use this technique with numbers. For example, if a caller
places an order, it's much easier for the bot to read out the order
number, 12569, as separate numbers, as opposed to "twelve thousand, five
hundred sixty nine."

![](/_fern-files/_img/28748c45c7e3575e8eb77193efb68cb73a2d32ce17ece3311ca41cb40d3a1c38.webp)

## Add pauses\[#UUID-b608df9d-dde4-57e2-e459-cc5940550154_section-idm4547639123116833650941797551]

Sometimes you might want to add pauses to avoid overwhelming callers
with information. In this case, you can use
`<speak><break time="Xs"/></speak>`, where `X` is the number of seconds
you want the break to last. This can be useful in cases like:

* Separating steps or details in a list

* Giving callers a chance to gather information (e.g., "Let me give you
  10 seconds to find your order number")

* Giving callers a chance to read and respond to an SMS you sent them

![](/_fern-files/_img/c689b6d932f55aa14f4903df9df8c4a17509deeeaddae4525c033f9e719dc55d.webp)

## Change the bot's reading speed\[#UUID-b608df9d-dde4-57e2-e459-cc5940550154_section-idm4596625359707233650950136678]

You can get the bot to speed up or slow down; for example, it might be
helpful to slow down the reading speed when reading out a long account
number, or speed up through a disclaimer. To do this, use
`<speak><prosody rate="slow">CONTENT_HERE</prosody></speak>`.

You can set the `prosody rate` attribute a few ways:

* As `slow`, `medium`, or `fast`

* Using numbers, where `1` is the normal speed

  * Slow down using `.8` or `.9`; much slower than this can be
    offputting

  * Speed up using `1.1` or `1.2`

> **Note**
>
> Changing the speed for only certain words in a sentence might cause
> unwanted pauses. If you try this, make sure you test it. If it sounds
> odd, change the speed of the entire sentence rather than just a portion
> of it.

![](/_fern-files/_img/638ad86d6567243ac847d1a578f20a75783fc6f70ccfb457d4b52ab9e333b191.webp)

## Add emphasis\[#UUID-b608df9d-dde4-57e2-e459-cc5940550154_section-idm4609094253259233650960806265]

When you’ve got something important to say, your bot's voice can add
emphasis. Use the code
`<speak><emphasis level="strong">EMPHASIZED-CONTENT</emphasis></speak>`.

![](/_fern-files/_img/b7ce8810b8e09022d3afd9ba5d300a763d1d899f930afa11641957566dac9d5e.webp)

## Play a sound clip\[#UUID-b608df9d-dde4-57e2-e459-cc5940550154_section-idm4580127097558433650965013845]

If you want to add a sound file to an Answer, use this code:
`<speak><audio src="URL_PATH_TO_SOUND_FILE">FALLBACK_CONTENT</audio></speak>`.

The above code requires both a direct path to a sound file, and a
fallback phrase to read out in case the sound file doesn't load.

![](/_fern-files/_img/239bbd6fce429ee8092072c08ae264a2226a26bdf8ded863a7736e2c2ff95ab8.webp)

Additionally, you can add attributes to play only a portion of the
audio. To do this, add the `clipBegin` and/or `clipEnd` attributes to
the audio tag, each with the timestamp where you want to begin or end
the sound clip, like this:
`<speak><audio src="URL_PATH_TO_SOUND_FILE" clipBegin="Xs" clipEnd="Ys">FALLBACK_CONTENT</audio></speak>`.

![](/_fern-files/_img/c4a2961682d4761bc797339185e62afc7fc94e7fed37f0aa51540d041d20db22.webp)

Lastly, here's an example of what happens if the sound file fails to
load. Instead of playing the sound, the bot reads your fallback content
instead.

![](/_fern-files/_img/76f58f7dfda8dfcde3c5ca947869d80cab46be27d649ffbfa7b2c6476295dcdf.webp)

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).