> 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/hume.md). # Hume ### What is Hume Integration? Hume enables advanced speech-to-text transcription using state-of-the-art voice intelligence. When connected with BotPenguin, it acts as a high-accuracy voice transcription engine for AI agents, enabling seamless voice interactions and enhanced natural-language capture. *** ### Benefits of Hume Integration * 🚀 Delivers high-precision voice transcription, improving conversational accuracy. * 🎤 Enhances voice-enabled interactions for AI agents across touchpoints. * ⚙️ Allows centralized API key management directly within BotPenguin. * 🔄 Supports flexible usage with multiple keys for different agents or environments. * 📈 Scales with your usage through Hume’s billing and plan management console. *** ### Guidance Video *(Embed the official BotPenguin walkthrough video for Hume Integration.)* *** ### How to Use Hume Integration #### Configure Hume in BotPenguin 1. Log in to your **BotPenguin Dashboard**. 2. Navigate to **“More”** from the left-hand sidebar.
3. Click on **“Integrations”**.
4. Search for or select **“Hume”**. 5. Click **“Connect”** to initiate the integration setup. 6. On the next screen, press **“Connect”** again to start configuration. 7. Enter your **Hume API Key** and **Hume Secret Key** into their respective fields. *** #### Retrieve API Keys from Hume Dashboard 1. Visit [**platform.hume.ai**](https://platform.hume.ai) and log in or sign up. 2. On the left sidebar, go to **“API Keys”** under the *Platform* section. 3. Copy your **API Key** and **API Secret**.
4. Paste these values back into BotPenguin to finalize the integration. 5. Regenerate keys in the Hume dashboard whenever required (optional). > New users are automatically assigned the free plan with **10,000 monthly characters** (as of 28th November).\ > You may upgrade plans anytime via **Billing** inside the Hume platform. *** #### Use Hume as a Voice Transcription Engine 1. Open any **AI Agent** that has **voice capabilities enabled**. 2. Navigate to **Advanced AI Settings**. 3. Go to the **Voice Transcript** configuration area. 4. Select **Hume** from the available integrations list. 5. Choose the specific **Hume key** configured earlier. 6. Save your settings to activate Hume-powered transcription. *** ### Hume Integration FAQs
Do I need a paid Hume account to use the integration? No. New Hume users are automatically assigned a free plan with 10,000 monthly characters. You can upgrade based on your usage needs.
Can I configure multiple Hume API keys inside BotPenguin? Yes. BotPenguin allows adding and selecting multiple API keys so different bots or environments can use separate credentials.
Why is my Hume transcription not working inside the AI agent? Ensure that voice mode is enabled, Hume is selected as the transcription provider, and the correct API key is chosen in the dropdown.
Where do I find my Hume API Secret? Log in to platform.hume.ai → API Keys. Both the API Key and Secret Key are visible there.
Can I regenerate my Hume API keys? Yes. Hume allows regenerating API and Secret Keys anytime from the API Keys section.
Does changing my Hume plan affect BotPenguin usage? Yes. Your character limits depend on the plan you choose in Hume. The integration reads from your Hume quota.
Is Hume available for non-voice bots? No. Hume integration is specifically used for voice transcription within voice-enabled AI agents.
Do I need to reconnect the integration after regenerating keys? Yes. If keys are regenerated, update them in BotPenguin to maintain continuous operation.
If you still have questions for our team, write to us at [**support@botpenguin.com**](mailto:support@botpenguin.com). We’ll get back to you within 48 hours. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://help.botpenguin.com/settings/integrations/hume.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.