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

# Voice Settings

> Choose your receptionist's voice, speaking style, and call quality criteria — for website, kiosk, or phone.

The Voice Settings page is where you define how your receptionist communicates through **voice** — whether guests are speaking through your website chat widget, a lobby kiosk, or a phone line.

<Info>
  **Voice works everywhere, not just phone.** Your receptionist's voice feature appears as a microphone button in the chat widget. Guests can type a message *or* tap the microphone to have a real-time voice conversation — just like a voice assistant. The same voice settings apply whether the conversation happens on your website, an embedded kiosk, or a phone line.
</Info>

<Tip>
  **Want to connect voice to your phone line?** Phone integration requires additional setup. Contact your account manager or the RecepAI support team to get started.
</Tip>

## Voice Selection

The sidebar shows your currently selected voice with a **preview button** to hear a sample. Click the **settings icon** to open the Voice Settings modal, or click the voice name to open the voice selection modal.

In the voice selection modal, you can:

* Browse all available voices in a visual grid
* Preview each voice before selecting
* Choose the voice that best represents your hotel's personality

<Tip>
  Listen to several voices before choosing. A luxury resort might want a calm, measured voice. A boutique city hotel might prefer something warmer and more energetic.
</Tip>

## How They Should Talk

This is the most important field on this page. Think of it as the training manual you'd hand a new receptionist — explain the tone, the boundaries, and how they should handle different situations during a voice conversation.

<Warning>
  **Common mistake:** Don't put hotel information (room types, prices, hours, policies) in this field. That belongs in [Training Materials](/admin-panel/documents). This field is for *behavior* — how your receptionist should speak, not what they should know. Your receptionist automatically pulls knowledge from Training Materials during conversations.
</Warning>

<Info>
  **Key difference from chat:** Voice responses must be short (2-3 sentences max), use natural speech patterns, and avoid formatting like bullet points, links, or markdown — none of that translates to spoken audio.

  See the [Voice Prompts Guide](/prompt-engineering/voice-prompts) for detailed guidance.
</Info>

<Info>
  **Character Limit:** 12,000 characters maximum. The counter changes color to guide you:

  * **Green (0 - 8,000):** Optimal range
  * **Orange (8,000 - 10,000):** Getting long — consider moving details to Training Materials
  * **Red (10,000 - 12,000):** May affect response quality

  For best results, keep your instructions under 10,000 characters. Detailed information (room types, restaurant hours, policies) should go in [Training Materials](/admin-panel/documents), not here.
</Info>

<Tip>
  Click the **Expand** button for a full-screen editing experience — much easier for longer instructions.
</Tip>

The quality of your receptionist's voice responses depends directly on how well you write these instructions. Take the time to be specific. For a step-by-step guide, see the [Voice Prompts Guide](/prompt-engineering/voice-prompts).

## Voice Settings

Click the **settings icon** (gear) next to the voice selector to open the Voice Settings modal. Settings are organized into two sections:

### AI Brain

| Setting              | What It Does                                                                                                                                                                                                     |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Thinking Model**   | Shows which AI model powers your receptionist's voice responses. This is **read-only** — configured by the RecepAI team. Contact your account manager if you need a different model.                             |
| **Creativity Level** | Controls how predictable responses are. **Focused (0.0 - 0.3):** Most accurate, recommended for reception. **Balanced (0.4 - 0.7):** More natural. **Creative (0.8 - 1.0):** Not recommended for guest services. |

<Warning>
  For hotel receptionists, we recommend the **Focused** range (0.3 or lower). Guests need accurate, reliable answers — not creative interpretations.
</Warning>

### Voice Quality

| Setting         | What It Controls                                                            | Recommended Range         |
| --------------- | --------------------------------------------------------------------------- | ------------------------- |
| **Stability**   | Voice emotional variation. Lower = more expressive, Higher = calmer         | 0.5 - 0.7 for most hotels |
| **Speed**       | Speaking pace. 0.9x = relaxed (resorts), 1.1x = efficient (business hotels) | 0.9 - 1.1                 |
| **Voice Match** | How closely AI matches the selected voice                                   | 0.75 - 0.85               |

## Greeting

Set the first thing your receptionist says when a guest starts a voice conversation. Keep it short and welcoming:

> "Hello, welcome to Grand Hotel Istanbul. How may I help you today?"

**Character limit:** 500 characters. A great greeting is 1-2 sentences.

## Guest Satisfaction Criteria

Define what "success" means for your hotel's voice conversations. After each conversation, your receptionist automatically evaluates whether these criteria were met — and flags conversations that need your attention.

**How to set criteria:**

1. Click **"Add Criteria"**
2. Give it a clear name (e.g., "Guest Question Answered") — up to 50 characters
3. Describe what success looks like (e.g., "The guest's specific question was answered with accurate information") — up to 2,000 characters

**Example criteria:**

* Guest confirmed their question was answered
* Reservation inquiry handled with specific contact information
* Alternative options offered when first choice unavailable

**Avoid:**

* Vague criteria like "Good service"
* Multiple conditions in one criterion

<Info>
  Satisfaction criteria work hand-in-hand with your conversation history. When your receptionist fails a criteria because it lacks knowledge on a topic, that conversation shows up as a training opportunity — telling you exactly what to add to your [Training Materials](/admin-panel/documents).
</Info>

Click **"View results in Voice History"** at the bottom of the criteria section to see how your receptionist is performing against these standards.

For a deeper dive, see the [Voice Evaluation Guide](/quality/voice-evaluation).

## Saving Changes

Click **"Save Voice"** at the top of the page to apply your changes. If you have unsaved changes and try to leave, you'll see a warning.