Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.superbryn.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Integration methods

SuperBryn supports five ways to ingest production call data. The right method depends on your provider and use case.
MethodBest forReal-time?
WebhookVapi, Retell, ElevenLabs, BlandYes
API key syncVapi, Retell, ElevenLabs, BlandNo (pull-based)
LiveKit SDKLiveKit agentsYes
Audio uploadAny provider, manual QANo
Traces uploadCustom stacks with JSON logsNo

​
Webhook

Webhooks push call data to SuperBryn in real-time as calls complete.
  1. Go to Monitor and click Add Source
  2. Select your provider and choose Webhook
  3. SuperBryn generates a unique webhook URL
  4. Copy the URL and paste it into your provider’s webhook settings
  5. Calls will stream in automatically
You can regenerate the webhook token at any time. This invalidates the previous URL.

​
API key sync

API key sync pulls call data from your provider on demand. Available for Vapi, Retell, ElevenLabs, and Bland.
  1. Go to Monitor and click Add Source
  2. Select your provider and choose API Key
  3. Enter your provider’s API key (and optionally an agent ID to filter calls)
  4. Click Test Connection to verify

​
Sync modes

When syncing calls, you choose a scope:
ModeDescription
IncrementalResume from where the last sync left off
Time rangePull calls between specific start and end dates
Rolling windowPull calls from the last N days
Recent NPull the most recent N calls (up to 10,000)
You can also filter by call duration (minimum and maximum in seconds) and assign labels during sync.

​
LiveKit SDK

For LiveKit-based agents, SuperBryn integrates via the livekit-evals Python package.
  1. Go to Monitor, open the Keys tab, and create a new API key
  2. Set the SUPERBRYN_API_KEY environment variable in your agent’s environment
  3. Install the SDK:
pip install livekit-evals
  1. Wire the webhook handler into your LiveKit agent code following the provided template
Calls are sent to SuperBryn automatically when they complete.

​
Audio upload

Upload recordings directly for analysis. Useful for spot-checking calls or analyzing recordings from providers without a direct integration.
  1. Go to Monitor and click Upload
  2. Drag and drop audio files or click to browse
  3. Supported formats: MP3, WAV, M4A, OGG, FLAC
  4. Maximum 50 files per batch
  5. Optionally assign labels at upload time
Files are uploaded to secure storage via presigned URLs. Each file is confirmed individually, so partial failures don’t block the rest of the batch.

​
Traces upload

Upload JSON trace files containing call records with transcripts and recording URLs.
  1. Go to Monitor and click Upload Traces
  2. Select your JSON files (max 10 files, 50 MB combined)
  3. Choose the channel mode:
    • Mono - single channel, requires speaker diarization
    • Stereo - multichannel, agent and customer on separate tracks
  4. Optionally assign labels
Records are normalized and routed through the same analysis pipeline as all other sources.

​
Managing sources

All sources for an agent appear in the Monitor tab. You can:
  • Rename a source for clarity
  • Enable/disable a source without deleting it
  • Regenerate webhook tokens
  • Delete a source and optionally its associated calls