wispr-common-errors

name	wispr-common-errors
description	Wispr Flow common errors for voice-to-text API integration. Use when integrating Wispr Flow dictation, WebSocket streaming, or building voice-powered applications. Trigger: "wispr common errors".
allowed-tools	Read, Write, Edit, Bash(npm:*), Grep
version	1.3.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","voice","dictation","wispr"]
compatibility	Designed for Claude Code

Wispr Flow Common Errors

Overview

Guidance for common errors with Wispr Flow voice-to-text API.

Instructions

Key Wispr Flow Concepts

• WebSocket API: wss://api.wisprflow.ai/api/v1/ws (recommended, low latency)
• REST API: POST /api/v1/transcribe (simpler, higher latency)
• Auth: API key (backend) or access token (client-side)
• Audio format: 16kHz mono PCM preferred
• Context awareness: Understands code, CLI commands, dev jargon
• Platforms: Mac, Windows, iOS, browser API

Error Handling

Error	Cause	Solution
401 Unauthorized	Invalid key	Check at wisprflow.ai/developers
WebSocket closed	Network issue	Reconnect with backoff
Poor accuracy	Wrong context	Set context to 'programming' for code

Resources

• Wispr Flow Developers
• API Docs
• WebSocket Quickstart

Next Steps

See related Wispr Flow skills for more patterns.