VoiceThere

Voice metrics

Voice metrics show how your cloud voice sessions perform for a single project — speech-to-text and text-to-speech latency percentiles, utterance volume, user barge-in rate, and voice-activity (VAD) speech start/end events. Data is scoped to that project only; another project's API key or session cannot read your metrics.

Dashboard: Metrics → Voice

Open Project → Metrics and select the Voice tab (next to Usage). Choose a time window with the presets:

  • 1 hour
  • 6 hours
  • 24 hours
  • 7 days

The Voice tab includes:

  • Summary cards — STT and TTS p50, p95, and p99 latency in milliseconds for the selected window.
  • STT / TTS latency charts — percentile lines over time.
  • Utterance volume — STT and TTS events per second.
  • Barge-in rate — user interruptions per second while the agent is speaking.
  • VAD transitions — speech start and speech end events per second.

Session counts, billable minutes, and credit usage stay on the Usage tab — Voice metrics are independent of billing snapshots.

Empty range vs Voice unavailable

Two different states:

  • No samples in range— Voice metrics are available, but no voice activity was recorded in the selected window. Charts show "No samples in this range yet" and a note to run a voice session and check back after a few minutes.
  • Voice not available — the platform cannot load voice metrics for this environment (for example when the metrics backend is not configured). An amber banner explains that Voice metrics are unavailable; the Usage tab and billing continue to work normally.

Barge-in and VAD charts

Turn-taking charts (barge-in rate and VAD speech start/end) fill in as sessions run on a voice runtime that reports those events. If you only see latency and volume today, latency and utterance volume may still populate while barge-in and VAD stay empty until your deployed workers pick up a build that emits the new counters.

API

Authenticate with an organization session (dashboard cookie) or a personal / project API key that belongs to the same organization as the project. The key must be allowed to read that project — cross-tenant access is denied.

GET /api/v1/projects/{projectId}/voice-metrics?period=24h

Period query parameter — 1h, 6h, 24h, or 7d. Invalid values return a validation error; the dashboard defaults to 24h when the query is missing or unrecognized.

The JSON body matches the dashboard: available, aggregate stt / tts percentiles, and time-series arrays for latency, volume, barge_in, and vad. See the Control plane API reference for auth headers and error shapes.

Cross-tenant isolation: a key scoped to project B cannot read voice metrics for project A. Project identity is resolved from verified credentials, not from client-supplied project headers alone.

Related guides

← All documentation