Submit a conversation
Send a post-call transcript with optional audio and metadata. Transcript metrics begin after submission; audio metrics begin when audio is available.- API: call
POST /v1/conversations/uploaded:submit. See the API reference. - CLI: use
coval uploaded-conversations submit. - App: open Conversations > Uploaded and select Upload.
- Asynchronous audio: submit the transcript first, then attach audio after the recording is finalized.
Audio channels
- Stereo recommended: channel 0 is the agent and channel 1 is the user, so roles are assigned deterministically.
- Mono supported: speaker roles are inferred from the transcript and may be less reliable.
Evaluate production behavior
Metrics can be selected explicitly, applied by rules, or inherited from your organization’s default uploaded-conversation metrics. Send OpenTelemetry traces when the behavior you need to evaluate is not present in the transcript. Uploaded conversations can be searched in Trace Search, charted in dashboards, and added to Human Review. A production failure can also become a test case so future simulated conversations catch the same regression before release.Rerun metrics
To apply updated metrics to historical conversations:- Open Conversations > Uploaded.
- Select one or more rows.
- Choose Rerun Metrics.
- Select the metrics and confirm.