API Reference
Start typing to search…

Call recording events

The call recording webhooks are triggered when a call recording event occurs.

Call Recording Events

Use this event to receive a recording link when a call recording becomes available in the system.

Subscribe to this webhook on the Administration > Webhooks page.
For parameter descriptions, refer to the Webhook Overview article.

EventDescription
call.recording.availableEvent triggered when a call recording becomes available.

call.recording.available

Use this event to:

  • Retrieve the call recording via a pre-signed URL hosted on the CDR
  • Simplify integration with CRMs or external systems by using a 24-hour link
  • Eliminate the need for a dedicated AWS S3 bucket

This event is only triggered when enabled for contact centers on the Pro Plus plan that have call recording enabled.

Sample Payload Structure

The following sample shows the structure of this webhook payload and highlights where standard objects—documented in the Webhook Overview—are used.

{
  "event": "call.recording.available",
  "object": "call",
  "timestamp": "2025-05-24T08:36:39Z",
  "secret": "45XXYYZZa08",
  "contact_center_id": "187edc75-XXXX-44e3-8798-aa0bbc12yt703",
  "data": {
    // call object
    // agent object
    // wrap_up_code object (optional)
  }
}

Example payload

{
  "event": "call.recording.available",
  "object": "call",
  "timestamp": "2025-05-24T08:36:39Z",
  "secret": "45XXYYZZa08",
  "contact_center_id": "187edc75-XXXX-44e3-8798-aa0bbc12yt703",
  "data": {
    "id": "1a234567-XXXX-012a-3456-b7c8de90a1b2",
    "type": "outbound",
    "start_time": "2025-05-24T06:53:50Z",
    "end_time": "2025-04-24T06:54:20Z",
    "duration": {
      "total": 30,
      "dialing_time": 5,
      "talk_time": 20,
      "hold_time": 5,
      "postcall_time": 10
    },
    "disposition": "Answered",
    "end_reason": "Contact disconnect",
    "calling_number": "123456789090",
    "called_number": "909087654321",
    "wrap_up_code": {
      "code": "1234",
      "description": "Send Invoice"
    },
    "notes": "The contact is looking for an updated invoice.",
    "cdr_url": "https://cluster1.voiso.com/cdr/1a234567-XXXX-012a-3456-b7c8de90a1b2",
    "recording": "https://ush9828hod3diwns/2025/05/24/187e8798-aa0bb6962503.mp3",
    "agent": {
      "id": 1,
      "name": "James Carter",
      "email": "[email protected]",
      "extension": "1234"
    }
  }
}

Note: The recording field contains a pre-signed URL that expires after 24 hours.

See also