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

# Voices

> Browse and select AI voices for your agents from our extensive voice library

## Overview

Choose from a diverse library of AI voices to give your agent the perfect personality and tone. Browse voices by gender, language, style, and dialect, then preview and select the one that best represents your brand.

<Info>
  **Voice Library Features:**

  * Multiple languages (English, Arabic)
  * Regional dialects
  * Conversational and narrator styles
  * Favorite management
  * Recently used tracking
  * Audio previews for every voice
</Info>

## Voice Library

### Browsing Voices

Navigate to **Voices** in the sidebar to access the voice library.

**Four tabs organize voices:**

1. **All Voices** - Complete library of available voices
2. **Favorite Voices** - Voices you've marked as favorites
3. **Currently Used** - Voices recently used in your agents
4. **My Voices** - Custom voices you've created

### Voice Cards

Each voice displays:

* **Name** - Voice identifier
* **Profile Image** - Visual representation
* **Language** - English or Arabic
* **Location/Dialect** - Country or regional accent
* **Gender** - Male or Female
* **Style** - Conversational or Narrator
* **Play Button** - Preview the voice
* **Favorite Icon** - Add/remove from favorites

### Playing Voice Previews

**To preview a voice:**

1. Find a voice card
2. Click the **Play** button
3. Listen to the audio sample
4. Click again to stop playback

<Tip>
  Preview multiple voices to compare tones, paces, and styles before selecting one for your agent.
</Tip>

## Filtering Voices

Use filters to narrow down the voice library:

### Gender Filter

* **Male** - Masculine voices
* **Female** - Feminine voices
* **Both** - Show all genders

### Language Filter

* **English** - English language voices
* **Arabic** - Arabic language voices
* **Both** - Show all languages

### Style Filter

* **Conversational** - Natural, friendly voices for conversation
* **Narrator** - Clear, articulate voices for announcements
* **Both** - Show all styles

### Dialect Filter

Select specific regional accents (Arabic only):

**Arabic Dialects:**

* Palestinian (pls)
* Egyptian (egy)
* Syrian (syr)
* Iraqi (irq)
* Jordanian (jor)
* Lebanese (leb)
* Saudi (ksa)
* Emirati (uae)
* Bahraini (bah)
* Qatari (qat)
* Kuwaiti (kuw)
* Omani (oma)
* Modern Standard Arabic (msa)
* Arabic – Gulf (ar-sa)

<Note>
  Dialect filtering is only available for Arabic voices. English voices don't have dialect options.
</Note>

### Search

**Search by voice name:**

```
Type in search box: "Sarah", "Ali", "Professional"
```

The search filters voices in real-time as you type.

### Clear Filters

Click **Clear Filters** to reset all filters and show the complete library.

### Filter Results Count

The interface shows: "Filter Result X Voice" to indicate how many voices match your current filters.

## Managing Favorites

### Add to Favorites

1. Find a voice you like
2. Click the **Star icon** on the voice card
3. Voice is added to "Favorite Voices" tab

<Check>
  Voice added to favorites successfully!
</Check>

### Remove from Favorites

1. Go to **Favorite Voices** tab (or find the voice anywhere)
2. Click the **filled Star icon**
3. Voice is removed from favorites

### Using Favorites

**Benefits of favoriting voices:**

* Quick access to preferred voices
* Easily compare your top choices
* No need to search repeatedly
* Share favorite voice IDs with team members

<Tip>
  Build a curated collection of 3-5 favorite voices for different use cases: customer service, sales, support, etc.
</Tip>

## Using Voices in Agents

### In Single Prompt Agents

1. Open your Single Prompt Agent
2. Navigate to **Voice Settings**
3. Click **Select Voice**
4. Browse, filter, and preview voices
5. Click voice card to select
6. Voice is applied to your agent

**Voice settings also include:**

* Voice speed adjustment
* Language selection
* Temperature control

### In Flow Agents

Flow agents can use different voices for different scenarios:

**Global Voice** (All nodes):

1. Open Flow Agent settings
2. Navigate to **Voice Settings**
3. Select default voice for the entire flow

**Node-Level Override:**

1. Select a Conversation Node
2. In node settings, override the voice
3. This node will use a different voice

**Example Use Case:**

```
Main Voice: Professional female English voice
Transfer Node Voice: Calm male voice saying "Please hold while I transfer you"
Emergency Node Voice: Clear, authoritative voice for urgent messages
```

## Voice Details

Each voice in the library includes:

### Basic Information

**Name** - Unique voice identifier

* Example: "Sarah - Professional", "Ali - Friendly"

**Gender** - Male or Female

* Helps match brand personality
* Affects how customers perceive the agent

**Language** - English or Arabic

* Must match agent's conversation language
* Determines available dialects

### Regional Information

**Location/Dialect**

* English: US, UK, Australia, Canada, India
* Arabic: Egypt, Jordan, Saudi Arabia, UAE, etc.

**Dialect Code**

* Short dialect code (e.g., `egy`, `jor`, `ksa`, `uae`)
* Used in API integrations

### Style Information

**Voice Style/Type**

**Conversational**

* Natural, friendly tone
* Best for: Customer service, sales, support
* Sounds like a helpful person

**Narrator**

* Clear, articulate delivery
* Best for: Announcements, instructions, information
* Sounds like a professional speaker

### Audio Preview

Every voice includes an audio sample showing:

* Pronunciation and clarity
* Speaking pace
* Tone and personality
* Accent and dialect

## Recently Used Voices

The **Currently Used** tab shows voices you've recently used in agents.

**Features:**

* Automatically updated when you select a voice
* Shows most recent at the top
* Includes voices across all agents in project
* Quick access for consistency

**Use cases:**

* Maintain brand consistency across agents
* Quickly find the voice you used last week
* Remember which voice worked well

## Copy Voice Information

**Copy Voice ID:**

1. Open voice card actions menu
2. Click **Copy ID**
3. Voice ID copied to clipboard

**Copy Voice Name:**

1. Open voice card actions menu
2. Click **Copy Name**
3. Voice name copied to clipboard

<Info>
  Voice IDs are useful for API integrations and programmatic agent configuration.
</Info>

## Voice Selection Best Practices

### Matching Voice to Use Case

**Customer Service**

* Style: Conversational
* Tone: Friendly, helpful, patient
* Gender: Match your brand preference

**Sales**

* Style: Conversational
* Tone: Confident, enthusiastic, engaging
* Gender: Test both to see what converts better

**Support (Technical)**

* Style: Narrator or Conversational
* Tone: Clear, professional, reassuring
* Gender: Clear pronunciation matters most

**Announcements**

* Style: Narrator
* Tone: Authoritative, clear
* Gender: Match company voice

**Appointment Reminders**

* Style: Conversational
* Tone: Friendly but professional
* Gender: Neutral preference

### Brand Alignment

**Formal Brands** (Law firms, financial services)

* Professional, clear voices
* Narrator style or formal conversational
* Slower pace

**Casual Brands** (Retail, hospitality)

* Friendly, warm voices
* Conversational style
* Natural pace

**Tech Brands** (Software, startups)

* Modern, clear voices
* Conversational style
* Efficient pace

### Language and Dialect Considerations

**English Markets:**

* US voices for North American audience
* UK voices for European audience
* Consider local accents for regional businesses

**Arabic Markets:**

* Match dialect to target region
* Egyptian Arabic for broad Middle East appeal
* Gulf dialects (Saudi, UAE) for GCC markets
* Levantine (Jordan, Syria) for Levant region

### Testing Voices

**Before committing to a voice:**

1. **Preview extensively** - Listen to full sample multiple times
2. **Test with content** - Use in test calls with your actual script
3. **Get feedback** - Have team members and test users listen
4. **Compare options** - Test 2-3 similar voices side by side
5. **Check consistency** - Ensure voice works across all scenarios

<Warning>
  Don't select a voice based solely on the preview. Test it in actual conversation scenarios to ensure it works well for your specific use case.
</Warning>

## Common Voice Issues

### Voice Sounds Too Fast

**Solution:** Adjust voice speed in agent settings

* Go to Voice Settings
* Reduce speed percentage
* Test again

### Voice Doesn't Match Brand

**Solution:** Refine filters and test more options

* Revisit gender, style, dialect choices
* Preview more voices in your preferred category
* Consider custom voice cloning

### Can't Find Previously Used Voice

**Solution:** Check Recently Used tab

* Go to "Currently Used" tab
* Sort by most recent
* Or use search with voice name

### Favorite Icon Not Working

**Solution:** Ensure project is selected

* Check project dropdown
* Reload page if needed
* Try toggling favorite again

## Limits and Quotas

**Voice Library:**

* No limit on how many voices you can preview
* No limit on favorites
* Recently used shows last 20 voices

**Voice Usage:**

* Each agent can use one voice (or multiple via node overrides in Flow Agents)
* Voice selection is instant
* No processing time required

## Voice Library Updates

The Hamsa voice library is regularly updated with new voices:

* New languages and dialects
* Improved voice quality
* Additional styles and tones

<Note>
  Check back periodically to discover new voices that might better fit your needs.
</Note>

## Related Documentation

<CardGroup cols={2}>
  <Card title="Voice Cloning" href="./voice-cloning">
    Create custom voices with your own audio
  </Card>

  <Card title="Single Prompt Voice Settings" href="/agents/single-prompt/voice-settings">
    Configure voice settings in Single Prompt Agents
  </Card>

  <Card title="Flow Agent Voice Configuration" href="/agents/flow-agent/global-settings">
    Set up voices in Flow Agents
  </Card>

  <Card title="Testing Agents" href="/overview/features/testing">
    Test how your voice sounds in real calls
  </Card>
</CardGroup>