Recordings

Call recording with AI transcription and summaries

PBX supports automatic call recording with dual-channel audio (caller on one channel, agent on the other), speech-to-text transcription, and AI-powered call summaries.

Recording Modes

Mode	Description
`none`	No recording
`always`	Record every call automatically
`on_demand`	Agent starts/stops recording during the call

Recording Scope

Scope	Description
`all`	Record all calls (inbound, outbound, internal)
`external`	Record only calls to/from external numbers
`inbound`	Record only inbound calls

Recording mode and scope can be set at the PBX level (default for all extensions) and overridden per extension.

AI Processing Pipeline

After a call ends:

Record -- Dual-channel audio captured during the call
Transcribe -- Deepgram Nova-2 generates speaker-labeled transcript
Summarize -- AI produces:
- Summary -- What the call was about
- Sentiment -- Caller sentiment (positive, neutral, negative)
- Action Items -- Follow-up tasks mentioned
- Topics -- Key subjects discussed

Accessing Recordings

GET/v1/pbx/recordings

List call recordings

Requires:pbx:recordings:read

curl -X GET "https://api.do.dev/v1/pbx/recordings?limit=10" \
  -H "Authorization: Bearer do_live_your_key_here"

{
  "recordings": [
    {
      "id": "rec_abc123",
      "callId": "call_xyz",
      "extensionNumber": "101",
      "direction": "inbound",
      "callerNumber": "5551234567",
      "duration": 245,
      "audioUrl": "https://pbx.dev/storage/rec_abc123.wav",
      "transcription": "Agent: Thank you for calling...",
      "summary": "Customer called about invoice #1234. Agent resolved billing discrepancy.",
      "sentiment": "positive",
      "actionItems": ["Send corrected invoice", "Follow up in 3 days"],
      "createdAt": "2026-03-26T14:30:00Z"
    }
  ]
}

Retention

Recordings are stored for 90 days by default. Retention period is configurable in PBX Settings.