Conversations

A conversation is the durable record of everything that happened across one or more sessions on the same call: the transcript turns, the operator results, and rolled-up usage, all threaded by a single conversation_id. Where a session is live and ephemeral, the conversation is what persists — the unit you retrieve, query, and report on after the fact.

What a conversation holds

• conversation_id — the stable identifier for the conversation.
• medium — the communication medium, such as voice.
• status — open while a session is live, closed once the last session ends.
• transport_key — the medium-native key; the telephony call_id for voice.
• source_sessions and configuration_ids — the sessions that contributed turns, and the distinct configurations active over the conversation.
• turn_count and usage — the number of transcript turns, and rolled-up audio_seconds and operator_results_emitted.
• started_at / ended_at — when the earliest session started and the last session ended; ended_at is absent while the conversation is open.

A single conversation can span more than one session — for example a call analysed under one configuration, then another after a mid-call swap — and its configuration_ids records each one.

Retrieving and querying

• GET /conversations lists your conversations; GET /conversations/{conversation_id} retrieves one.
• GET /conversations/{conversation_id}/operator-results returns the operator results, optionally split out per_session.
• GET /conversations/{conversation_id}/transcript returns the transcript, paged: each turn carries a seq, the diarised speaker, the text, and when it occurred_at, and you page forward with after_seq.

Today and tomorrow

Today, conversations are synchronous: they come from live calls, each backed by one or more sessions. The model is medium-agnostic by design — support for asynchronous conversations such as messaging and email, which have no live session and are analysed as each message arrives, is planned. A conversation's medium distinguishes the two.