Search, export and archive call recordings
Find any call by direction, campaign, agent, phone or date, play it, export recordings as one file per day, and archive them every day to your own AWS S3 bucket.
Backups & restore · 3 min read
Recordings (in the sidebar under Tools) lets you search, play, export and archive call recordings from any of your servers or clusters, and from servers you have terminated. Pick the server or cluster at the top of the page.
Search and play
- Choose Outbound, Inbound or both, a date range of up to 31 days, and any of: time of day, campaigns, in-groups, the number called (DID), agents, user groups, lists, dispositions, call length, phone numbers and lead IDs.
- On the server searches the server itself. Archive searches the recordings your archive rules delivered in the last 13 months, including from servers that no longer exist.
- Press play on any row. Archived recordings play straight from wherever the archive keeps them.
- Dates and times are the server’s own clock, the same as VICIdial shows.
Export recordings
- Search for what you want, then choose Export all matching (or tick rows and choose Export selected).
- We count the recordings and their size on the server and show it before you start.
- We pack one file per day and email you when it is ready. Download the files from the Exports tab within 48 hours; after that they are deleted from our storage. Your server keeps its own copies.
Each file is an uncompressed .tar holding the recordings in a folder per date, named by time, direction, campaign or in-group, agent, phone and lead, plus manifest.csv (every call, with the file it is in and its SHA-256) and index.html. Extract the file and open index.html to search and play the recordings offline. For a big export, Copy all links gives you every file’s link to download with wget -i.
Archive rules: a copy off the server, every day
- A rule packs a day’s recordings (or just the ones its filters pick) into one .tar with its manifest and sends it out, automatically.
- Every day sends yesterday; Mondays sends last week; the 1st of the month sends last month. Always one file per day. Pick the time it runs, in the server’s clock.
- Send to your own storage (your AWS S3 bucket, any S3-compatible store such as Backblaze B2, Wasabi or Cloudflare R2, or an SFTP server) or to a download link we keep for 48 hours.
- A confirmation email goes to the addresses you list. People on your account get a link to the files; any other address gets the summary only.
- Run for past dates sends days that are already on the server, one day at a time, so you can archive everything you have so far.
- We check every file arrived whole (size and SHA-256) and index it, so archived calls stay searchable and playable for 13 months, even after the server is gone.
Use your own AWS S3 bucket
- Create a bucket in AWS S3 and an IAM user whose policy allows s3:PutObject, s3:GetObject, s3:DeleteObject and s3:AbortMultipartUpload on that bucket (the Recordings page shows the exact policy).
- In Recordings, open Archive rules and fill in Your storage: choose AWS S3 or S3-compatible, leave the endpoint blank, and enter the region, bucket, an optional folder, and the access key.
- Create a rule that sends to your own storage. Use Run for past dates to send what is already on the server.
Free up space on the server (optional)
A rule that sends to your own storage can also delete recordings from the server once they are a set number of days old (30 or more). Only files we delivered to your storage and checked are removed. The calls stay in VICIdial’s history, and playing one from Recordings plays the archived copy. It is off unless you turn it on and type DELETE to confirm.
Clusters and terminated servers
- A cluster is one choice in the list: its database server holds every recording, so search, exports and rules cover all its dialers.
- A terminated server shows its archive (what its rules delivered) and, for 90 days after termination, a download of its termination backup’s recordings.