Recording events

Recording events fire after a call has ended, once Teler has finished processing and storing the audio. Recording is opt-in: enable it on the SIP Trunk, on the Voice App call, or via the record option on the dial verb.

Note

Recording events are post-call only. Expect a short delay (typically seconds, occasionally minutes) between call.completed and recording.completed while the audio is finalized.

Wire shape depends on your webhook version. Each payload has a toggle.

recording.completed

Fires when a recording is fully processed and ready to download.

2026-06-01

{
  "id":           "evt_...",
  "type":         "recording.completed",
  "api_version":  "2026-06-01",
  "occurred_at":  "2026-06-01T11:32:22.010Z",
  "account_id":   "acc_...",
  "voice_app_id": "va_...",
  "sip_trunk_id": null,
  "call_id":      "cs_...",
  "leg_id":       null,
  "data": {
    "call_id":       "cs_...",
    "recording_id":  "rec_...",
    "recording_url": "https://recordings.frejun.ai/..."
  },
  "previous_attributes": null
}

2025-08-01

{
  "event":       "recording.completed",
  "account_id":  "<uuid>",
  "data": {
    "call_id":       "<uuid>",
    "recording_id":  "<uuid>",
    "recording_url": "https://recordings.frejun.ai/..."
  }
}

Caution

Treat recording_url as time-limited: fetch it promptly, or request a fresh URL via the API when you need to access the file later. URLs are typically valid for 24 hours.

recording.failed

Fires when recording was attempted but could not be produced: the source file was unavailable, storage was unavailable, the upload timed out, or a network error occurred. Details are carried in a nested failure object.

2026-06-01

{
  "id":           "evt_...",
  "type":         "recording.failed",
  "api_version":  "2026-06-01",
  "occurred_at":  "2026-06-01T11:32:22.010Z",
  "account_id":   "acc_...",
  "voice_app_id": "va_...",
  "sip_trunk_id": null,
  "call_id":      "cs_...",
  "leg_id":       null,
  "data": {
    "call_id":      "cs_...",
    "recording_id": "rec_...",
    "failure": {
      "reason":      "storage_unavailable",
      "description": "Recording storage backend was unreachable"
    }
  },
  "previous_attributes": null
}

2025-08-01

{
  "event":       "recording.failed",
  "account_id":  "<uuid>",
  "data": {
    "call_id":      "<uuid>",
    "recording_id": "<uuid>"
  }
}

failure.reason values: file_unavailable, storage_unavailable, upload_timeout, network_error, unknown_error. An optional failure.details object carries additional diagnostic context when available.

Next steps

Call events Lifecycle events for the underlying call.

Stream events Lifecycle events for media streams.

Signing & verification HMAC-SHA256 verification for production endpoints.