SFTP: How do I bulk-upload call / contact records and recordings?


The EvaluAgent Bulk File Upload Integration feature enables you to:

  1. Upload a CSV file containing a list of calls or contacts processed by your contact centre.
  2. Meta-data associated with the call / contact can be included in the file. E.g. date and time of call, call-type, etc.
  3. For each contact, you can also choose to upload a voice / screen recording linked to the contact in the CSV file.

Uploading files to our Bulk File integration requires the use of Secure File Transfer Protocol (SFTP). In layman's terms, this protocol allows the server your side (where the files are stored) to securely connect and upload files to our server.

Getting started

Go to Integration settings to reveal the following screen and then click Setup.


Setting up this feature on your account is relatively simple but does require some system configuration on our side.

To get the process started, on pressing the Setup link, you'll be redirected to a page that contains a simple application form:


We need some contact details and request that you upload a sample of the CSV file format that contains your call (meta) data. This is typically the file that is returned from your call-recording / contact management platform when you select to export calls / contacts.

Every call-recording / contact management system is slightly different in terms of exporting data and we'd direct you to the help guides of the third-party system for more information on how to export calls / contacts / recordings.

Word of warning: some of the old-school systems (you know who they are!) like to hold your data to ransom, and make it really difficult or expensive to get access to your data so before you waste too much time, it's advisable to confirm you can bulk-export records before spending any time working out how to import them.

As part of completing the form above, we'd also recommend that you upload a sample of a call recording if you plan to upload and connect a recording to each call record.

We've tried to keep the process as simple and flexible as possible and we can process most file formats. However, as a minimum, your CSV file of call / contact records will need to contain the following columns. The file may contain additional columns, but without the columns listed below, we won't have the information we need to present calls / contacts in the imported contacts table in EvaluAgent and link them up to agents in the EvaluAgent platform.

Required columns in your CSV file


For more information on linking-up agents in your system(s) to agents in EvaluAgent, please view the guide

Once you've completed the form and attached your sample CSV (plus a sample Audio File if you're planning on uploading recordings) the request will be submitted to our Customer Success team who will contact you to discuss the request.

Next Steps: Completing the set-up process

Once we've configured your account, we'll provide you with the details of how to connect to our SFTP server. These details will include the following:

  • Host name (this is the URL of our SFTP server)
  • Username (this unique to you)
  • SSH key-pair (if you wish us to generate this for you). Alternatively you can generate your own and send to us. For maximum security and peace of mind, EvaluAgent's SSH key-pairs are generated using the SHA256 algorithm.

Completing the set-up process will likely require some technical effort on your side. This work typically involves you either establishing an automatic or manual process that enables you to transfer files to our SFTP server at a regular frequency.

Our SFTP servers are hosted by AWS. For guidance on how to transfer files using AWS SFTP, click here

Once you're set-up

Once you're set-up, you can start uploading your files. At this point, you'll be able to set up connectors. A Connector is a set of filters that enable you to group imported contacts together based on their match to pre-configured criteria. E.g. You may wish to create a Connector that matches (and tags) all calls processed in the last 7 days where call duration is greater than 100 seconds and less than 300 seconds.

Data storage and Archiving Rules

We process, store, and present call / contact records and any recordings securely within the EvaluAgent platform. As with all data held in EvaluAgent - it's secure - any files uploaded to our SFTP service are also automatically encrypted whilst at rest using the industry best-practice standard - AES256 encryption.

Our archiving rules help you manage imported contacts and any associated data that is imported into EvaluAgent.


Any contacts that are not evaluated after a defined period of time will be deleted from EvaluAgent (including any associated audio/screen recordings). This period is set by configuring the rule; Delete non-evaluated contacts after X days.

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.