For manual review, use Review voice calls in Studio. This guide covers managed phone/widget call lifecycle events; a raw Socket.IO client uses socket events and must not assume managed-call Webhooks.

Before you begin

  • A configured project Webhook endpoint subscribed to Call started, Call ended and Session ended.
  • Its signing secret stored only on your backend.
  • A durable event store or queue for follow-up work.

Endpoint setup and exact fields are in Session lifecycle Webhooks.

Process a completed call

1

Verify the original request

Install svix and use its signature verifier on the original request bytes and incoming Svix headers. Parse or act on the event only after verification.

Verify before handling a call event

Your HTTP adapter must preserve the raw body. Do not verify a JSON object that has been parsed and serialized again.

2

Store calls and sessions separately

Use runtime.call.end for the connection’s start/end times and endReason. Use runtime.session.end for the conversation lifetime. A returning caller can reuse a session, so a second call does not require another session-start event. Deduplicate deliveries using their verified svix-id in your persistent store.

3

Join the Transcript and recordings

Read data.transcriptID when present. It can be null or absent; a reused session can have no Transcript ID on call start. When an ID is available, call List transcript files with your authorized server key and retrieve the listed artifacts. Do not construct a recording URL or assume an audio file exists for every call.

Verify the receiver

Place a test call and inspect the verified call-end event, its end reason and any returned Transcript files. Repeat a call from the same identity to check session reuse. Confirm an invalid signature is rejected before any follow-up job runs.

Handle missing artifacts

If the Transcript ID is missing, retain the call metadata and handle the nullable field rather than failing the receiver. Recording must have been enabled before the call. A call-end event does not guarantee a recording or Evaluation result is already available.

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.