Skip to main content
ContactNow: Download Call Recording in Bulk
8x8 Support

ContactNow: Download Call Recording in Bulk


To use the Bulk Downloader tool to download call recordings in bulk.

The Bulk Record is a separate Java application that runs parallel with our application. It must first be downloaded from our system.

The call recording Bulk Download application enables swift downloading of multiple call recordings in a single action. To perform bulk downloading hover over the Configuration icon from the Navigation bar and click Bulk download.

The bulk downloader is a separate Java application developed by us, and requires Java 7 or above installed on your machine for it to work. Visit the Java download site to get the latest version.

Applies To

  • Call Recordings
  • Bulk Download


Getting Started

  1. From Configuration, click Bulk Download.
  2. Click Download App.
    • If it is your first time downloading the app Select App With New Config. App With New Config downloads a zip file named Extract the files and open the file Pull_recordings.
    • If you already have a configuration set up and need an updated version of the app select Just the app.
  3. When you open the app you will be presented with a message prompting you to log in with your username and password.
    Screen Shot 2017-04-07 at 16.51.41.png
  4. Enter your credentials and click login.


  1. When opening the file Pull_recordings from your Download you will be presented with a message prompting you to configure directories.
  2. Select OK then complete the Edit Configuration page:
  3. Click Browse under the Recording Destination heading, select an appropriate location for your recordings to be stored. Repeat this process for the Indices destination and Log File destination.
  4. Provide a minimum free space value for all three destinations. This is to ensure that your free space will not fall below this level. The download will fail if your free disk space falls below this.
    • Optional: enter your email address to be notified when the bulk download is complete or if any errors occur. When configuration is complete
  5. Click Save.

Create New Job

  1. From the menu you're presented with, select File and then New Job from the drop-down menu.
  2. This will open the Add New Job... window.
  3. You can run a bulk download job against matched criteria of Agents, Outcomes, Queues, and Datasets.
  4. Select all from each field by leaving it blank (don't click any options) or select multiple holding down CTRL (PC) or CMD (Mac) and clicking each one.
  5. Select a Dataset range or leave blank to select all.
  6. Enter a Description: Name the bulk download job.
  7. Enter a Filename Format: Allows you to adjust the format of the filename given to the call recordings. Fields that can be included are; {{callid}} the Call ID, {{agent}} Agent ID, {{outcome}} Outcome ID, {{qid}} Queue ID and {{dataset}} Dataset ID. The default is {{callid}}. An example of an edited Filename could be: Filename: call-{{callid}}-ddi-{{ddi}}, which would include the Call ID (callid) as well as the number dialled (ddi)
  8. Enter the Schedule Type: Select the frequency which the job will run.
  9. Enter a Start Date and Time: State the time and date to start the job, or checking ‘Immediate?’ will start the job straight away.
  10. Enter Range Type (Range Start and Stop): Select the time period of calls to be downloaded (for custom range only).
  11. Select a Category: Choose from both Recordings and Segments (Call Highlights) or select individually.
  12. Click Add.

Running Task

Once a job is running you can view it on the running task tab. The running task tab can be found for each job that is active by selecting it in the menu on the left.

A job can also have multiple runs and each run will have its own tab (left side).


Job Log

  1. You can view the log of jobs by selecting View > View Log from the menu.
  2. You will be presented with the screen below.

Scheduled Jobs

A list of scheduled jobs can be viewed under the scheduled job tab.


Recent Runs

Recent runs are shown on the Recent Runs tab. It shows whether the job was completed successfully or not.

You can also check how much storage you have on your device on the Storage Device info tab.



Can I download call highlights?

These are called Call Segments and can be downloaded separately or with your recordings.

Can I schedule repeat jobs?

Jobs can be repeated daily or weekly by choosing a Schedule type.

How do I edit a job that has already been scheduled?

Select the job and then click Edit > Edit Job.

How can I download all of my calls?

If you do not select any filters all of your calls in the period chosen will be downloaded.

There is an error when the bulk downloader starts or it does not run. What steps should I take?

In order to run the bulk downloader you need to have Java 7 installed on your computer.

What if my PC reboots or I lose internet connection?

You will get an error message. It will attempt to run again every 5 minutes. It will allow for 20 of these 5-minute errors before the job fails. If the job fails, you can go into failed jobs tab and click re-start which will resume the job from the position it was last at.

Can I schedule a job to run immediately?

Yes, checking the Immediate? box will schedule the job to run as soon as you click Add.

Can I use special characters in file names and descriptions?

Yes, only forwards slash ( / ), colon ( ; ), asterisk ( * ), question mark ( ? ), backslash ( \ ), double quote ( “ ), less than ( < ), greater than ( > ) and pipe ( | ) are not allowed.

I cannot see any jobs in my logs?

You must first select a job and then a run period to view the logs.

Can I export to an external drive?

Yes. Any of the three folders that the Bulk downloader uses can be on any drive connected to your computer.

Do my destination folders have to be within a folder?

No. The three folders specified can be outside a folder (e.g., on the desktop), in different locations or even on different drives.

Do the alert and completion email addresses have to be the same? Can I enter more than one?

They can be different if you require.

Can I enter more than one email address?

No, only one email address can be entered for each alert.

Can I change the email addresses I have set?

Yes, editing the config file allows you to update or remove the email addresses entered.

What are the differences between the range types available?

A custom range will download all the calls based on the start and stop time selected. ‘Last 24 hours’ and ‘last 7 days’ will use the start time of the job as the stop time and download the calls in the period previous to that time.

What happens if I select more free space than I have available on my drive?

Should this happen the job will fail and an alert email will be sent if configured to do so. The log file will also state that this was the problem. It can be solved by editing the config file to the correct amount of space available.

What is the difference between a Run and a Job?

A Run is an instance of a Job. A job can be run several times, for example, a scheduled Job that repeats and runs weekly.

What will happen if my Job is larger than the space available?

Jobs will run until the available space limit is reached. An alert email will be sent if configured to do so.

Do I need to know the Dataset ID before I start?

We recommend that you find the IDs of the datasets you wish to export before you create a job as this will make the process much quicker once you begin.

Can I compress my files?

Yes, you can do this on your PC after the files have been downloaded.

Can I delete a job?

You cannot currently delete a job. You can, however, schedule a job for a date in the past (for start time) which will allow this to hide from scheduled jobs tab.

  • Was this article helpful?