No code required. The Sandbox provides full access to Heify’s pipeline — from configuration to analytics — entirely through the browser.
Getting started
Authenticate
Access to the Sandbox requires an account. Login is OTP-based: enter your email, receive a one-time code, and log in — no password required.After login you are redirected to the main dashboard. See Authentication for the full flow.
Automatic setup
When the Sandbox loads for the first time, it automatically provisions a reserved API key on your behalf. This key is validated against the Heify API and stored in the browser’s local storage.A “Setting up the sandbox…” notice appears during provisioning. On success, a “Sandbox ready” notification is shown. If automatic provisioning fails, you are directed to the API Keys & Sandbox page to configure the connection manually.
Sandbox ready
The Sandbox is considered ready when two conditions are both true:
- An API key is stored in the browser.
- That key has been validated against the Heify API.
If the Sandbox is not ready, a SandboxSetupWarning banner appears at the top of affected pages with a Configure button. Transcription, configurations, evaluators, and analytics features are disabled until setup is complete.
Navigation
The Sandbox is organized into seven areas accessible from the collapsible sidebar on desktop and a bottom navigation bar on mobile.Dashboard
Overview of the pipeline, summary counts, and setup status.
Configurations
Create and manage transcription configurations — the foundation of every pipeline.
Evaluators
Define AI quality criteria to score transcriptions automatically.
Participants
Register the people who appear in the audio — agents, candidates, salespeople, or any individual.
Transcribe
Upload audio files or submit URLs for transcription.
Transcriptions
View, filter, and inspect all processed transcriptions and their results.
Analysis
AI-powered analytics dashboards by Configuration, Evaluator, or Participant.
The desktop sidebar also provides quick links to the AI Assistant, Docs, and Support. The user menu at the bottom shows your role, remaining transcription minutes, and analytics quota counts. A dark/light mode toggle (sun/moon pill) is also available in the sidebar footer — your preference is saved automatically.
Core workflow
A typical Heify pipeline follows this sequence:Create a Configuration
Every transcription must be associated with a Configuration. It defines what features are enabled (summaries, field extraction, conversation output) and which evaluator to apply.
Create Evaluators and Participants (optional)
Evaluators add a quality scoring layer — a set of criteria applied to transcriptions to produce a score and flag critical failures. Participants identify the individuals in the recordings — support agents, job candidates, salespeople — enabling per-person performance tracking across analytics dashboards.
Upload audio via Transcribe
Go to Transcribe to upload files or paste a public URL. Associate the transcription with a configuration and optionally link an evaluator and participant.
Review results in Transcriptions
Open any transcription in Transcriptions to view the full transcript, AI summary, extracted fields, evaluation score, and criterion-level breakdown.
Explore trends in Analysis
Use the Analysis dashboards to discover patterns across all transcriptions — by configuration, evaluator, or participant.
Quota
The Sandbox operates under two types of quota:Transcription minutes
Total audio duration that can be processed. Consumed when a transcription completes successfully.
Analytics quota
Number of analysis reports that can be generated per module (configurations, evaluators, participants). Consumed on every request, even if no data is returned.
Remaining quota is shown in the sidebar user menu. When an analytics quota is exhausted, the Generate Analysis button is disabled on the corresponding dashboard.
API keys and team
All API keys are managed from the API Keys & Sandbox page. The auto-provisioned reserved key appears pinned at the top of the list. You can also create additional keys with custom names — up to 10 keys per account. Team members can be invited from the same page. Each member gets their own access to the Sandbox under the same account.| Role | Capabilities |
|---|---|
| Admin | Full access: pipeline, analytics, API key management, team management |
| Member | Pipeline and analytics access. Cannot manage API keys or team settings |