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

# How Voice Works

> Learn how the voice feature works.

Understanding how the **Voice Suite** operates will help you leverage its full potential. This section explains the core flow of voice features, from **user input** to **speech generation**, including integrations with third-party services like **Deepgram**, **ElevenLabs**, and **Twilio**.

***

## 🛠 Voice System Workflow

The Voice Suite operates in a series of interconnected steps:

### 1. **User Speech Input** 🎤

The process begins when a user speaks:

* Voice input is captured in real-time using your application's front-end (e.g., a web app or mobile app).
* The input is sent to a **transcriber service** (e.g., **Deepgram**) for processing.

### 2. **Speech Transcription** 📝

* The transcriber converts the audio into **text**.
* Parameters like **Patience Factor** allow you to customize how quickly the system finalizes the transcription.

> **Example**:\
> If a user pauses frequently, the Patience Factor determines whether the system waits for them to finish speaking or processes the response immediately.

### 3. **Text-to-Speech Generation** 🔊

Once transcription is complete:

* The **text** is passed to the **Speech Generation Service** (e.g., **ElevenLabs**) to produce **audio responses**.
* You can configure:
  * **Voice ID**: Select different tones, accents, or speaker profiles.
  * **Background Noise**: Simulate environments like *Restaurants* or *Offices* for a more lifelike experience.

### 4. **Voice Response Playback** ⏯

The generated audio is sent back to the user’s device and played in real-time.

> **Example Scenario**:
>
> * User: “What time is my appointment?”
> * System: “Your appointment is scheduled for 3 PM today.”

### 5. **Phone Integration (Optional)** 📞

* With **Twilio Integration**, you can enable **voice calling** to allow real-time phone interactions.
* Use purchased numbers or connect your existing Twilio account.

***

## 🔄 End-to-End Flow Diagram

Here’s a visual breakdown of the entire workflow:

<img src="https://mintcdn.com/convocore/45Ecjxi6tZs54Ia5/assets/voice/voice-diagram.png?fit=max&auto=format&n=45Ecjxi6tZs54Ia5&q=85&s=e81b80f784cc038ed4a495649bdcecc0" alt="Voice Diagram" width="7667" height="4339" data-path="assets/voice/voice-diagram.png" />

*Add a diagram showcasing the flow: User Input → Transcriber → Text → Speech Gen → Playback.*

***

## 💡 Key Components

| Component             | Description                                   | Example Providers      |
| --------------------- | --------------------------------------------- | ---------------------- |
| **Transcriber**       | Converts voice input into text.               | Deepgram               |
| **Speech Generator**  | Converts text into high-quality audio.        | ElevenLabs             |
| **Phone Integration** | Enables voice calls with purchased numbers.   | Twilio                 |
| **Configuration**     | Custom settings for transcription & playback. | Patience Factor, Noise |

***

## 🚦 Technical Summary

* **Latency**: Designed for minimal delay to ensure smooth user interactions.
* **Providers**: Integrates seamlessly with third-party APIs like Deepgram, ElevenLabs, and Twilio.
* **Flexibility**: Configure settings at multiple levels, from **speech patience** to **voice tone**.

***

## 🔗 Next Steps

Now that you understand how Voice works, explore the following guides to set up and configure it for your app:

1. **[Setup Guide](./setup/twilio)** - Step-by-step Twilio and Web Calling integration.
2. **[Configuration Settings](./config/transcriber)** - Customize transcription and speech generation.
3. **[Advanced Settings](./config/advanced)** - Explore advanced controls like recording and routing.

***

## 🛠 Troubleshooting

* **Delayed Responses?**
  * Adjust the **Patience Factor** to improve real-time behavior.

* **Low-Quality Audio?**
  * Configure the **Voice ID** in your Speech Generation settings.

* **Twilio Setup Issues?**
  * Double-check Twilio credentials and webhook URLs.

***

**With this understanding, you're ready to implement Voice in your application and create seamless voice-driven user experiences!** 🚀