Calls & lifecycle
A call is the central record in VOIX. Every other output (the transcript, the scores, the tasks) attaches to a call. Each call carries the basic facts about the conversation, namely who called whom, when, in which direction, and for how long, and then accumulates everything VOIX derives from the recording.
Status
A call moves through a fixed set of statuses as it is processed. These statuses are reflected in the dashboard and, where tracked, on the call record.
| Status | Meaning |
|---|---|
received | The call has been registered, but its audio has not arrived yet. |
queued | The recording has arrived and is waiting to be transcribed. |
transcribing | The recording is being converted to a speaker-separated transcript. |
analyzing | The transcript is being read and scored, with tasks and contacts extracted. |
completed | Processing is finished and the full call record is available. |
failed | Processing could not complete. The call can be resubmitted. |
One call, one identity
Every call has a stable identifier that the sender assigns at submission. This
identifier makes the pipeline safe to retry: resubmitting the same call updates the
existing record rather than creating a duplicate, and a call that has already
completed is not reprocessed.
For this reason, a call can be submitted in two parts, a lightweight notice that the call has started followed by the recording once it ends, and still resolve to a single, coherent record. The mechanics are described in the Ingest reference.