> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.armin.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Improve Voice Agent Pronunciation

> Teach your voice agent how to pronounce words, acronyms, and symbols correctly

# Better Pronunciation for Your Voice Agent

Does your voice agent struggle with pronouncing company names, technical terms, or web addresses? You can now customize how your voice agent pronounces specific words, making conversations more natural and professional.

## Where to Find This Feature

1. Navigate to your Voice Channel settings
2. Go to the **Voice** tab
3. Click the **Fine-tune Pronunciation** button

<Tip>
  You can access this directly at: `armin.cx/app/[organization]/channels/phone/[channel-id]` and
  select the Voice tab
</Tip>

## How It Works

You can define custom pronunciations in two ways:

### 1. Alias Method (Recommended for Beginners)

Replace words with phonetic spellings that sound right. This is perfect for:

* Company names
* Acronyms
* Web addresses
* Special symbols

**Examples:**

* `@` → `at`
* `NGINX` → `Engine-X`
* `CEO` → `Chief Executive Officer`
* `https://` → `H T T P S colon slash slash`
* `.com` → `dot com`

### 2. Phoneme Method (Advanced)

Use International Phonetic Alphabet (IPA) notation for precise pronunciation control. This is ideal when the alias method doesn't quite capture the right sound.

**Examples:**

* `WhatsApp` → `/wɒtsˈæp/`
* `Kubernetes` → `/ˌkuːbərˈneɪtiːz/`

<Info>
  Need help with phonemes? Use the [IPA Generator](https://tophonetics.com/) link in the dialog to
  convert words to phonetic notation.
</Info>

## Step-by-Step Guide

### Adding a Pronunciation Rule

1. **Select Language**: Choose the language group your voice agent uses
2. **Click "Add Rule"**: Create a new pronunciation entry
3. **Enter the Text**: Type the word or symbol you want to customize
4. **Choose Type**: Select "Alias" (easier) or "Phoneme" (advanced)
5. **Enter Pronunciation**:
   * For Alias: Type how it should sound
   * For Phoneme: Enter the IPA notation
6. **Save**: Click the Save button to apply your changes

### Managing Multiple Languages

If your voice agent supports multiple languages, you can:

* Switch between language tabs to add rules for each language
* Create language-specific pronunciations (e.g., "CEO" might be pronounced differently in English vs. German)

## Common Use Cases

### Web and Email Elements

| Original   | Alias                         |
| ---------- | ----------------------------- |
| `@`        | `at`                          |
| `www.`     | `W W W dot`                   |
| `.com`     | `dot com`                     |
| `https://` | `H T T P S colon slash slash` |

### Business Acronyms

| Original | Alias                        |
| -------- | ---------------------------- |
| `FAQ`    | `frequently asked questions` |
| `HR`     | `human resources`            |
| `IT`     | `information technology`     |
| `KPI`    | `key performance indicator`  |

### German Examples

| Original    | Alias (German)            |
| ----------- | ------------------------- |
| `@`         | `ät`                      |
| `CEO`       | `Geschäftsführer`         |
| `FAQ`       | `häufig gestellte Fragen` |
| `URL`       | `Webadresse`              |
| `AI` / `KI` | `Künstliche Intelligenz`  |
| `.de`       | `Punkt D E`               |

### Special Characters

| Original | Alias                 |
| -------- | --------------------- |
| `&`      | `and`                 |
| `#`      | `hashtag` or `number` |
| `%`      | `percent`             |
| `$`      | `dollar`              |
| `€`      | `euro`                |

## Best Practices

<CardGroup cols={2}>
  <Card title="Test Your Pronunciations" icon="vial">
    After adding rules, use the "Test Agent" feature to hear how your changes sound in conversation.
  </Card>

  <Card title="Start Simple" icon="seedling">
    Begin with the alias method. It's easier to understand and works well for most cases.
  </Card>

  <Card title="Be Consistent" icon="check">
    If you use abbreviations frequently, add them all at once to ensure consistent pronunciation.
  </Card>

  <Card title="Consider Context" icon="brain">
    Some words might need different pronunciations in different contexts. Test thoroughly!
  </Card>
</CardGroup>

## Tips for Success

* **Case Sensitive**: Pronunciation rules are case-sensitive. Add separate entries for "CEO" and "ceo" if needed.
* **Test First**: Always test your voice agent after making changes to ensure the pronunciation sounds natural.
* **Less is More**: Only add rules for words that are actually mispronounced. Too many rules can slow down processing.

## Need Help?

If you're unsure about how to pronounce something:

1. Try the alias method first with simple phonetic spelling
2. Use the IPA Generator tool (linked in the dialog) for complex words
3. Test different variations until it sounds right

<Note>
  Remember to **publish** your voice agent after making pronunciation changes for them to take
  effect!
</Note>