# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.botpenguin.com/settings/integrations/deepgram.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.