Stream events

Stream events fire when a media stream is created and when it ends. They are useful for billing, observability, and triggering downstream processing once audio is fully delivered.

Wire shape depends on your webhook version. Each payload has a toggle: pick your version once and the whole page switches.

stream.initiated

Fires when Teler successfully opens the WebSocket to your ws_url and delivers the start message.

2026-06-01

{
  "id":           "evt_...",
  "type":         "stream.initiated",
  "api_version":  "2026-06-01",
  "occurred_at":  "2026-06-01T11:30:50.100Z",
  "account_id":   "acc_...",
  "voice_app_id": "va_...",
  "sip_trunk_id": null,
  "call_id":      "cs_...",
  "leg_id":       "cl_...",
  "data": {
    "call_id":    "cs_...",
    "stream_id":  "ms_...",
    "started_at": "2026-06-01T11:30:50.100Z",
    "ws_url":     "wss://your-app.example.com/stream"
  },
  "previous_attributes": null
}

2025-08-01

{
  "event":       "stream.initiated",
  "account_id":  "<uuid>",
  "call_app_id": "<uuid>",
  "data": {
    "call_id":    "<uuid>",
    "stream_id":  "<uuid>",
    "time":       "2026-04-27T11:30:50Z"
  }
}

stream.completed

Fires when the WebSocket closes, whether the call ended cleanly or the connection dropped. The underlying call may continue if the WebSocket closes prematurely.

2026-06-01

{
  "id":           "evt_...",
  "type":         "stream.completed",
  "api_version":  "2026-06-01",
  "occurred_at":  "2026-06-01T11:32:18.501Z",
  "account_id":   "acc_...",
  "voice_app_id": "va_...",
  "sip_trunk_id": null,
  "call_id":      "cs_...",
  "leg_id":       "cl_...",
  "data": {
    "call_id":          "cs_...",
    "stream_id":        "ms_...",
    "ended_at":         "2026-06-01T11:32:18.501Z",
    "duration_seconds": 88,
    "reason":           "normal"
  },
  "previous_attributes": null
}

2025-08-01

{
  "event":       "stream.completed",
  "account_id":  "<uuid>",
  "call_app_id": "<uuid>",
  "data": {
    "call_id":   "<uuid>",
    "stream_id": "<uuid>",
    "time":      "2026-04-27T11:32:18Z"
  }
}

Note

stream.completed does not imply call.completed. A stream can end while the underlying call is still active (e.g. if your Bridge disconnects and the call falls back to silence). Track both events to model the full lifecycle.

Next steps

Call events Lifecycle events for the underlying call.

WebSocket protocol The message protocol carried over the stream.

Signing & verification HMAC-SHA256 verification for production endpoints.