Calls & lifecycle
A call is the central record in VOIX. Everything else, the transcript, the scores, the tasks, hangs off a call. Each call carries the basic facts about the conversation (who called whom, when, in which direction, 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. You will see these reflected in the dashboard and, if you track it, on the call record.
| Status | Meaning |
|---|---|
received | The call has been registered, but its audio has not arrived yet. |
queued | The recording is in and waiting to be picked up for transcription. |
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 | Everything 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 you choose when you send it. That
identifier is what makes the pipeline safe to retry: sending the same call again
updates the existing record rather than creating a duplicate, and a call that
has already completed is not reprocessed.
This is why a call can be sent in two parts, a lightweight “this call just started” notice followed by the recording when it ends, and still resolve to a single, coherent record. The mechanics of that are covered in the Ingest reference.