> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/settings/integrations/deepgram.md).

# DeepGram

Deepgram integration allows you to enable **real-time speech-to-text transcription** for your voice agents on BotPenguin. By connecting Deepgram, your bot can accurately understand user speech, analyze conversations, and deliver intelligent voice-based experiences.

***

### What is Deepgram?

Deepgram is an AI-powered speech recognition platform that provides:

* Real-time and batch speech-to-text
* High accuracy voice transcription
* Scalable performance for voice bots
* Support for multiple languages and accents

When integrated with BotPenguin, Deepgram enhances your **Voice Agents** by converting spoken input into text instantly.

***

### Prerequisites

Before integrating Deepgram, ensure you have:

* An active **BotPenguin account**
* Access to **More → Integrations**
* A **Deepgram account**
* A valid **Deepgram API Key**

***

### Accessing Deepgram Integration

To open Deepgram settings in BotPenguin:

1. Log in to your **BotPenguin Dashboard**
2. Click **More** from the left sidebar
3. Select **Integrations**
4. Locate **Deepgram** from the list

<figure><img src="/files/LYk1lwv5sPbZoGDiqdFO" alt=""><figcaption></figcaption></figure>

6. Click on the **Configure** or **Connect** option

***

### How to Integrate Deepgram

#### Step 1: Open Deepgram Configuration

* Navigate to **More → Integrations → Deepgram**
* Click **Connect**

<figure><img src="/files/AizYaFQ4tngMykFRdI2Q" alt=""><figcaption></figcaption></figure>

***

#### Step 2: Add Credentials

On the **Add Credentials** screen, enter the following details:

* **Configuration Name**\
  A friendly name to identify this Deepgram setup (e.g., *Voice Bot Production*, *Testing*, etc.)
* **API Key**\
  Paste your Deepgram API key generated from your Deepgram account dashboard

<figure><img src="/files/bm0JGdez8aosCSE8I65w" alt=""><figcaption></figcaption></figure>

***

#### Step 3: Connect

* Click **Connect**
* Once connected, the configuration will appear in the list with an **Active (green)** status

***

### Managing Deepgram Configurations

You can manage multiple Deepgram configurations from the configuration list.

#### Available Actions:

* **Edit (✏️)** – Update the configuration name or API key

<figure><img src="/files/V9AWsVRFNLRlsL82n8tx" alt=""><figcaption></figcaption></figure>

* **Enable / Disable** – Toggle the configuration status
* **Delete (🗑️)** – Remove the configuration if no longer needed

<figure><img src="/files/9gkPznSf8X2oZH4PkHGJ" alt=""><figcaption></figcaption></figure>

* **Info (ℹ️)** – View configuration details

> ⚠️ At least one active configuration is required for voice agents to function correctly.

on clicking the info icon configuration code will be visible&#x20;

<figure><img src="/files/5mI4VhhEnWmtkDQ0k2bd" alt=""><figcaption></figcaption></figure>

***

### Using Deepgram with Voice Agents

Once Deepgram is connected:

* Your **Voice Agents** automatically use the active Deepgram configuration
* User speech is transcribed in real time
* Transcriptions are passed to the bot’s AI for processing and response

No additional setup is required inside the agent flow.

***

### Best Practices

* Use **separate configurations** for testing and production environments
* Keep your **API keys secure**
* Ensure only **one primary configuration** is active to avoid confusion
* Regularly test voice interactions after updating credentials

***

### Troubleshooting

**Integration not working?**

* Verify the API key is valid
* Ensure the configuration status is **enabled**
* Check your Deepgram account usage limits
* Reconnect the integration if credentials were recently changed

### FAQs&#x20;

<details>

<summary>Do I need a Deepgram account to use voice agents?</summary>

Yes. A valid **Deepgram account and API key** are required to activate speech recognition for voice agents on BotPenguin.

</details>

<details>

<summary>Where can I find Deepgram integration settings?</summary>

You can access Deepgram integration from:\
**BotPenguin Dashboard → More → Integrations → Deepgram**

</details>

<details>

<summary>What details are required to connect Deepgram?</summary>

You need:

* **Configuration Name** (for internal identification)
* **Deepgram API Key** generated from your Deepgram account

</details>

<details>

<summary>Can I add multiple Deepgram configurations?</summary>

Yes. BotPenguin allows you to create **multiple Deepgram configurations**, which is useful for testing, staging, or production environments.

</details>

<details>

<summary>Which Deepgram configuration is used by voice agents?</summary>

Voice agents use the **active (enabled)** Deepgram configuration. Make sure at least one configuration is turned on.

</details>

<details>

<summary>Can I edit or update my Deepgram API key?</summary>

Yes. You can click the **Edit (✏️)** icon next to a configuration to update the API key or rename the configuration.

</details>