{"site":{"name":"Koji","description":"AI-native customer research platform that helps teams conduct, analyze, and synthesize customer interviews at scale.","url":"https://www.koji.so","contentTypes":["blog","documentation"],"lastUpdated":"2026-05-18T13:05:40.474Z"},"content":[{"type":"documentation","id":"dddac6ce-358b-48e4-bacf-cfafbfd18837","slug":"voice-interview-not-working","title":"Voice Interview Not Working","url":"https://www.koji.so/docs/voice-interview-not-working","summary":"Troubleshooting guide for Koji voice interviews that are not working. Covers browser requirements (Chrome/Edge recommended), HTTPS requirements, microphone permissions, hardware issues, network/firewall considerations for ElevenLabs WebSocket connections, and text mode fallback.","content":"# Voice Interview Not Working\n\nVoice interviews require a working microphone, a supported browser, and a secure connection. If your voice interview is not working, this guide walks you through every common cause and its fix.\n\n---\n\n## Quick Checklist\n\nBefore diving into detailed troubleshooting, run through this quick checklist:\n\n- [ ] Are you using Chrome or Edge? (Recommended browsers for voice)\n- [ ] Is your page loaded over HTTPS?\n- [ ] Have you granted microphone permission to the site?\n- [ ] Is your microphone working in other applications?\n- [ ] Is your browser up to date?\n\nIf you answered \"no\" to any of these, that is likely your issue. Read the relevant section below for the fix.\n\n---\n\n## Step 1: Check Your Browser\n\nVoice interviews work best in **Google Chrome** and **Microsoft Edge**. These browsers have the most reliable support for the audio technologies Koji uses, including WebSocket connections and the Web Audio API.\n\n**Firefox** supports voice interviews but occasionally has issues with echo cancellation and microphone selection.\n\n**Safari** has limited support. Voice interviews may work on recent versions of Safari on macOS, but we recommend switching to Chrome or Edge if you encounter problems.\n\nIf you are using an unsupported or outdated browser, voice features may fail silently or behave unpredictably. Check [Browser Compatibility](/docs/browser-compatibility) for the full support matrix.\n\n### How to check your browser version\n\n- **Chrome**: Click the three-dot menu > Help > About Google Chrome\n- **Edge**: Click the three-dot menu > Help and feedback > About Microsoft Edge\n- **Firefox**: Click the hamburger menu > Help > About Firefox\n\nUpdate your browser if it is more than a few versions behind the latest release.\n\n---\n\n## Step 2: Check HTTPS\n\nBrowsers require an HTTPS connection to allow microphone access. This is a security feature built into all modern browsers -- it is not a Koji-specific requirement.\n\nIf you are accessing Koji through:\n- **koji.so** -- This is always HTTPS. No action needed.\n- **An embedded widget** -- Make sure the host page uses HTTPS. If the page embedding the Koji widget uses HTTP, the browser blocks microphone access.\n- **A development server** -- Use `localhost` (which browsers treat as a secure context) or configure HTTPS on your development server.\n\nLook at the URL bar. If there is a lock icon, you are on HTTPS. If there is a \"Not Secure\" warning, microphone access is blocked.\n\n---\n\n## Step 3: Grant Microphone Permission\n\nThe most common cause of voice interview issues is a missing or denied microphone permission.\n\n### Chrome / Edge\n\n1. Look for a camera/microphone icon in the address bar (right side).\n2. Click it to see the current permission state.\n3. If it says \"Blocked\", click the dropdown and select **Allow**.\n4. Reload the page.\n\nAlternatively:\n\n1. Click the lock icon in the address bar.\n2. Find **Microphone** in the permissions list.\n3. Set it to **Allow**.\n4. Reload the page.\n\n### Firefox\n\n1. Click the lock icon in the address bar.\n2. Click **Connection secure** > **More Information**.\n3. Go to the **Permissions** tab.\n4. Find **Use the Microphone** and set it to **Allow**.\n5. Reload the page.\n\n### Safari\n\n1. Go to **Safari > Settings > Websites**.\n2. Find **Microphone** in the sidebar.\n3. Find the Koji domain (koji.so) and set it to **Allow**.\n4. Reload the page.\n\n### System-Level Permissions (macOS)\n\nOn macOS, your browser also needs system-level microphone permission:\n\n1. Open **System Settings > Privacy & Security > Microphone**.\n2. Make sure your browser (Chrome, Edge, etc.) is listed and enabled.\n3. If it is not listed, you may need to restart the browser and try accessing the microphone again to trigger the system prompt.\n\n### System-Level Permissions (Windows)\n\n1. Open **Settings > Privacy > Microphone**.\n2. Make sure \"Allow apps to access your microphone\" is turned on.\n3. Scroll down and confirm your browser is in the allowed list.\n\n---\n\n## Step 4: Test Your Microphone\n\nBefore blaming the browser or Koji, confirm your microphone is working:\n\n1. Open your operating system's sound settings.\n2. Speak into your microphone and check if the input level meter moves.\n3. Try recording a short clip in a voice memo app or an online microphone tester.\n\nIf the microphone does not work in other applications, the problem is at the hardware or OS level, not with Koji.\n\n### Common Microphone Hardware Issues\n\n- **External microphone not selected.** Your system may default to a built-in microphone. Go to sound settings and select the correct input device.\n- **Mute switch on.** Some headsets and microphones have physical mute switches. Check for a switch or button on the device.\n- **USB connection issues.** If using a USB microphone, try a different USB port. Hubs can sometimes cause connection problems.\n- **Bluetooth connection dropped.** Bluetooth headsets can disconnect silently. Check your Bluetooth settings to confirm the headset is still connected.\n\n---\n\n## Step 5: Check for Conflicting Applications\n\nSome applications lock the microphone and prevent the browser from accessing it:\n\n- **Video conferencing apps** (Zoom, Teams, Meet) may hold an exclusive lock on the microphone, even when minimized.\n- **Voice assistants** (Siri, Cortana) may be listening in the background.\n- **Recording software** (OBS, Audacity) may be capturing the input.\n\nClose any application that might be using the microphone, then reload the Koji interview page.\n\n---\n\n## Step 6: Check Network and Firewall\n\nKoji's voice interviews use **ElevenLabs Conversational AI** for real-time voice processing. This requires a stable WebSocket connection.\n\nIf voice does not connect or cuts out frequently:\n\n- **Firewall or proxy**: Corporate networks may block WebSocket connections. If you are on a company network, ask IT to allow WebSocket traffic to the ElevenLabs API endpoints.\n- **VPN**: Some VPNs add latency or block WebSocket connections. Try disconnecting your VPN temporarily.\n- **Slow connection**: Voice interviews need a stable internet connection with reasonable latency. If your connection is slow or unstable, voice quality may suffer.\n\n---\n\n## How Voice Interviews Work\n\nUnderstanding the architecture can help with troubleshooting:\n\n1. When you start a voice interview, Koji establishes a WebSocket connection to the voice AI service (powered by ElevenLabs Conversational AI).\n2. Your microphone audio is captured via the Web Audio API in your browser and streamed over the WebSocket connection.\n3. The AI processes your speech, generates a response, and streams the audio back to your browser.\n4. The response audio plays through your speakers or headphones.\n\nThis means your browser needs:\n- **WebSocket support** for the real-time connection\n- **Web Audio API** for capturing and playing audio\n- **Microphone access** for recording your voice\n\n---\n\n## Text Mode Fallback\n\nIf voice interviews are not working and you cannot resolve the issue, **text mode is always available** as a fallback. Text interviews do not require a microphone and work in all modern browsers.\n\nTo switch to text mode:\n- On the interview landing page, select the **Text** option instead of **Voice**.\n- If you are already in a voice interview that is not working, you can switch to text mode from the interview controls.\n\nText interviews provide the same research quality and AI-driven conversation as voice -- just through typing instead of speaking. See [Text Interview Experience](/docs/text-interview-experience) for more details.\n\n---\n\n## Still Not Working?\n\nIf you have tried all of the above and voice is still not working:\n\n1. Try a **different browser** (Chrome is most reliable).\n2. Try a **different device** to rule out device-specific issues.\n3. Check the [Voice Interview Experience](/docs/voice-interview-experience) guide for additional context on how voice mode works.\n4. Contact Koji support with:\n   - Your browser name and version\n   - Your operating system\n   - Whether you see any error messages\n   - Whether text mode works for you\n\n## Further reading on the blog\n\n- [AI-Moderated Interview Platforms Compared: Which One Actually Works? (2026)](/blog/ai-moderated-interview-platforms-2026) — Not all AI interview platforms deliver real qualitative depth. This guide compares the top AI-moderated interview platforms in 2026 — Koji, \n- [Best AI Customer Interview Tools in 2026: The Complete Buyer's Guide](/blog/best-ai-customer-interview-tools-2026) — AI has fundamentally changed how product teams conduct customer research. Here are the best AI customer interview tools in 2026 — ranked by \n- [Best Customer Churn Interview Tools (2026): The Top 8 Compared](/blog/best-customer-churn-interview-tools-2026) — A 2024 study found exit surveys match the real churn driver in only 31% of cases. The right interview tool fixes that. Here are the 8 best c\n\n<!-- further-reading:blog -->\n","category":"Troubleshooting","lastModified":"2026-05-13T00:26:36.807295+00:00","metaTitle":"Voice Interview Not Working — Koji Docs","metaDescription":"Troubleshoot voice interview issues including microphone permissions, browser compatibility, and network problems.","keywords":["voice not working","microphone permission","troubleshooting voice","audio issues","browser microphone"],"aiSummary":"Troubleshooting guide for Koji voice interviews that are not working. Covers browser requirements (Chrome/Edge recommended), HTTPS requirements, microphone permissions, hardware issues, network/firewall considerations for ElevenLabs WebSocket connections, and text mode fallback.","aiPrerequisites":["voice-interview-experience"],"aiLearningOutcomes":["Diagnose voice interview problems","Configure microphone permissions","Identify browser compatibility issues","Troubleshoot network-related audio problems"],"aiDifficulty":"beginner","aiEstimatedTime":"7 min read"}],"pagination":{"total":1,"returned":1,"offset":0}}