Skip to main content

SFTP imports

SFTP imports collect recordings from your own SFTP server. Every hour, Speechlytics connects, finds new recordings and queues them for transcription. It is the simplest way to integrate a phone system that can drop recordings into a folder.

SFTP import is enabled per account by Speechlytics.

Configuring the connection​

The connection is configured per account:

FieldMeaning
ServerSFTP host name.
Username, PasswordSFTP credentials. Use a dedicated read-only user.
PortDefaults to 22.
DirectoryThe folder to collect from, for example /recordings. Subfolders are included. Required: collection is skipped while it is empty.

Collection runs only when server, username, password and directory are all set.

What is collected​

  • Files ending in lower-case .wav, .mp3 or .wma, in the directory and its subfolders. Folders whose names start with . are skipped. Rename files with upper-case extensions such as .WAV.
  • A file is imported once: a file whose name already exists as a call on the account is skipped. Give each recording a unique file name.
  • Files are not moved or deleted on your server. Clean up old recordings with your own retention process.
  • Imported calls do not carry agent, direction or phone numbers. If you need agent attribution, submit recordings through the API with metadata instead.

Sync history​

Each run's date, number of files processed, directory and any error is recorded in the account's sync history and audit log.

A directory that does not exist is reported as a run with no errors and no files, so check the path if nothing ever arrives.

Troubleshooting​

SymptomWhat to check
A run shows an errorHost, port, credentials and that the directory exists. The server must speak SFTP (SSH), not plain FTP.
New files are not collectedThe file names already exist on the account (from any source), or the extension is not lower-case .wav, .mp3 or .wma.
No runs are recordedOne of server, username, password or directory is empty.
Files appear an hour lateCollection runs hourly. Use the API for immediate processing.