# Vocalizer 7

{% hint style="warning" %}
**BETA FEATURE:**

The Vocalizer 7 TTS engine is currently available as a **beta feature**. Further testing and updates may take place while Vocalizer 7 is in beta.

We encourage you to share feedback at **<beta@plumgroup.com>**.
{% endhint %}

## Selecting the Vocalizer 7 TTS engine <a href="#voice_tag_attributes" id="voice_tag_attributes"></a>

In the toolbar menu, select **Applications**, then select **Application Configuration** in the dropdown menu. The Application Configuration page will be displayed.

A table of phone numbers and associated applications will be displayed on this page. Go to the desired phone number and select **Edit**. Configuration options for that phone number will be displayed as shown in Figure 1 below.

<figure><img src="/files/IHN3cALfg0L420OOb5QO" alt=""><figcaption><p>Figure 1: Selecting the Nuance Vocalizer 7 TTS engine.</p></figcaption></figure>

In the TTS engine dropdown menu, select **Nuance Vocalizer 7.0**. Make any additional selections as desired, then select **Save**.

## List of languages

Available voices currently cover the following languages:

<table><thead><tr><th width="284.89801699716713">Language</th><th width="170">Number of voices</th><th width="306">Multilingual voices</th></tr></thead><tbody><tr><td><strong>American English (en-US)</strong></td><td>9</td><td>2</td></tr><tr><td><strong>British English (en-GB)</strong></td><td>6</td><td><em>n/a</em></td></tr><tr><td><strong>Spanish (es-ES)</strong></td><td>4</td><td>1</td></tr><tr><td><strong>German (de-DE)</strong></td><td>5</td><td>1</td></tr><tr><td><strong>Canadian French (fr-CA)</strong></td><td>3</td><td>1</td></tr><tr><td><strong>French (fr-FR)</strong></td><td>3</td><td>1</td></tr><tr><td><strong>Brazilian Portuguese (pt-BR)</strong></td><td>3</td><td><em>n/a</em></td></tr><tr><td><strong>Portuguese (pt-PT)</strong></td><td>3</td><td><em>n/a</em></td></tr><tr><td><strong>Cantonese (zh-HK)</strong></td><td>2</td><td>2</td></tr><tr><td><strong>Mandarin (zh-CN)</strong></td><td>2</td><td>2</td></tr></tbody></table>

For more details on voices, see [Vocalizer 7: \<voice> tag and SSML Support](/dev/developer-reference/tts-engine-characteristics/vocalizer-7/vocalizer-7-less-than-voice-greater-than-tag-and-ssml-support.md#name).

## SSML 1.0 support

Vocalizer supports the majority of the W3C specification SSML 1.0 for further VXML markup. See [Vocalizer 7: \<voice> tag and SSML Support](/dev/developer-reference/tts-engine-characteristics/vocalizer-7/vocalizer-7-less-than-voice-greater-than-tag-and-ssml-support.md) for more information.

## Recommended best practices

### Avoid using `xml:lang` in `<voice>`

When setting the TTS language, avoid using the `xml:lang` attribute in the `<voice>` tag. Vocalizer 7 does not accept it. It will cause the TTS engine to use the default voice instead of the one specified.

Instead, use the `xml:lang` attribute of the `<speak>` or `<vxml>` tags.&#x20;

#### Do this:

`<speak>` tag using the `xml:lang` attribute to specify British English:

```xml
<block>
    <prompt>
        <speak xml:lang="en-GB">
            <voice name="malcolm">
                Thank you for calling.
            </voice>
        </speak>
    </prompt>
</block>
```

`<vxml>` tag using the `xml:lang` attribute to specify British English:

```xml
<vxml version="2.1" xml:lang="en-GB">
    <form id="main">
        <block>
            <prompt>
                Thank you for calling.
            </prompt>
        </block>
    </form>
</vxml>
```

The above examples will use the voices and languages specified.

#### Don't do this:

Faulty method using `xml:lang` in the `<voice>` tag.

```xml
<block>
    <prompt>
        <voice name="malcolm" xml:lang="en-GB">
            Block 4.
        </voice>
    </prompt>
</block>
```

In the above example, Vocalizer would fail to accept the specified voice and would fall back to the default voice instead.

### Note `bargein` effects on prompt queueing behavior

If `bargein` is enabled (i.e., `<prompt bargein="true"`) in a series of prompts in a row, you may experience some delay before the first prompt starts playing. It has been reported that this behavior may be more apparent with Vocalizer 7 than with other TTS engines.

For more details on prompts and barge-in, see [Audio Formats and Prompts](https://docs.plumvoice.com/dev/developer-reference/audio-formats-and-prompts#prompt_queuing_and_barge-in_behavior).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.plumvoice.com/dev/developer-reference/tts-engine-characteristics/vocalizer-7.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.