Troubleshoot common issues
Fix recording, permissions, transcript quality, API, and media capture issues.
- Audience
- Users who hit a blocked workflow and need a calm recovery path.
- Time
- 16 minutes
- Level
- All levels
Scenario
Start with the workflow this guide is designed for before moving into the steps.
As a user preparing a real workflow, I want a checklist for common failures so I can fix the problem without losing the recording or exposing private data.
You can identify the likely failure layer and collect safe details for support.
Complete steps
Classify the failure
Decide whether the problem is capture, upload, transcription, template output, API auth, or review.
Collect safe support details
Capture screenshots or logs that show the error, but redact keys, private names, and raw sensitive transcripts.
Retry the smallest safe step
Use a small sample recording or placeholder API request instead of repeating the full high-stakes workflow.
Details
Failure map
Most issues become easier once you separate where the failure happened.
- Capture: microphone, permissions, file format.
- Processing: upload, transcription, long-audio behavior.
- Output: template quality, dictionary terms, review state.
- Automation: auth header, endpoint, secret handling.
Connected feature paths
This tutorial should not dead-end. These are the natural next features and workflows it connects to.
Install the desktop app
Prepare macOS or Windows for stable meeting capture.
Make your first recording
Record a short voice note and turn it into a reviewable transcript.
Use API keys and Shortcuts
Connect repeatable capture or transcription workflows without exposing secrets.