The Chat tab can read messages aloud and run a hands-free interactive voice mode, powered by ElevenLabs. Both directions use one ElevenLabs credential: text-to-speech for playback and Scribe speech-to-text for the microphone.
Setup
- Open Settings (gear icon, top right) → Voice tab.
- Pick an ElevenLabs credential, or click Add credential to create one. The API key needs the Text to Speech, Speech to Text, and Voices permissions enabled in your ElevenLabs account.
- Choose a Voice from your ElevenLabs account.
- Click Save Voice Settings.
If you press a voice button before setting this up, the Voice tab opens automatically so you can finish configuring.
The ElevenLabs API key is stored encrypted and never reaches the browser — all calls are proxied through the Heym backend. See Credentials and Settings.
Read a message aloud
Every message bubble (yours and the assistant's) has a speaker button next to Copy. Click it to play the message; click again — or play another message — to stop. Playback uses the ElevenLabs multilingual model, so the language of the text is detected automatically.
Interactive voice mode
The waveform button in the chat input opens a full-screen, hands-free voice mode (light/dark and mobile aware):
- It listens through your microphone and detects when you stop speaking.
- Your speech is transcribed with Scribe (language auto-detected — no manual TR/EN toggle).
- The transcript is sent as a normal chat message in the same conversation.
- The assistant's reply is read back aloud, then it resumes listening.
Use the mute button to pause listening and the ✕ to exit (which releases the microphone). Recording works in all modern browsers, including Firefox.
Notes
- Voice and credential selection are per-user preferences; the active conversation, model, and credential for the LLM are unchanged.
- ElevenLabs usage (both TTS and STT) is billed to your own ElevenLabs account.
Related
- Chat Tab – Dashboard chat where voice lives
- Credentials – How API keys are stored and referenced
- Settings – Where the Voice tab lives