Skip to main content

Speech Insights FTP

Speech Insights FTP is the WinnerWare ingestion-source module for teams that receive call recordings through FTP or FTPS.

Overview​

This module is used when recordings are delivered to a managed file-transfer server instead of a local drop folder. It extends Speech Insights by adding an FTP or FTPS connection option inside the Ingestion Sources area.

Key Features​

  • Adds FTP/FTPS as an available Speech Insights ingestion-source type.
  • Supports both standard FTP and secure FTPS connections.
  • Supports connection-mode, encryption, and SSL/TLS options.
  • Supports a source root path for controlled ingestion scope.
  • Stores the connection password securely.

How It Works​

Add an FTP or FTPS source to Speech Insights​

After the module is enabled, admins can create a new ingestion source and choose FTP/FTPS as the source type. That source then becomes part of the standard Speech Insights ingestion workflow.

Keep source metadata and connection settings together​

Each FTP source combines the common Speech Insights source fields with the FTP-specific connection details. That lets implementation teams define both the business meaning of the source and the technical connection in one place.

Map incoming metadata before ingestion runs​

Like other Speech Insights sources, FTP sources rely on the field map maintained in the base source editor. This is how WinnerWare knows which incoming values represent the recording file name, call date, and other metadata needed during transcript creation.

Configuration​

Enable the source module​

Turn on this module after the main Speech Insights feature is enabled.

Common source fields​

Every FTP source also uses the shared Speech Insights source fields:

  • Name
  • Client
  • Locale
  • Candidate locales (optional, for calls in more than one language)
  • Active?
  • the Metadata File Map for recording and call metadata

See Speech Insights for what each field does.

FTP connection settings​

The FTP/FTPS editor adds these connection fields:

SettingPurpose
FTP hostServer name or IP address.
FTP portConnection port. The default is 21.
UsernameLogin name for the FTP account.
PasswordLogin password for the FTP account. After you save, the password is stored securely and the field stays empty. Enter a new value only to replace it.
Use secure connection?Switches the source to secure FTPS-style communication.
Data connection typeChooses how the data channel is opened: Auto (Passive), Passive (PASV), Extended Passive (EPSV), Auto (Active), Active (PORT), or Extended Active (EPRT).
Encryption modeSets the FTP encryption behavior.
Ignore certificate errorsAllows the connection to continue even when certificate validation fails.
SSL/TLS protocolSelects the protocol version used for the secure connection. The default is TLS 1.2.
Root pathLimits ingestion to a specific server folder.

Usage​

Use FTP when recordings arrive through a classic file-transfer process​

This module is a good fit when another system drops recordings and metadata onto an FTP or FTPS server that WinnerWare can reach.

Check the source before you activate it​

On Speech Insights -> Ingestion Sources, open the Actions menu of the source:

  1. Click Test connection. WinnerWare connects with the saved settings and lists the root folder. The result shows on the source row. A failure usually means a wrong host, port, credential, or Root path.
  2. Click Get statistics to see how many audio and metadata files are waiting and how many are Ready to ingest.
  3. Turn on Active? and click Ingest recordings, or wait for the hourly run.

To set up a similar server, use Clone. The copy keeps the connection settings and credentials and starts as inactive.

What happens when something fails​

  • If the server cannot be reached during a run, WinnerWare logs the error, but the source list can show a normal Processed time with 0 recordings ingested. If a source ingests nothing when you expect recordings, click Test connection.
  • An unexpected error that stops a run shows as Last error on the source until a later run completes.
  • A single recording that fails is left on the server and tried again on the next run.
  • A recording that cannot be decoded is moved to a failed folder next to it on the server and is not tried again.
  • Files changed in the last 2 minutes are left for the next run, so files that are still uploading are not read.

Operational Notes​

  • The module registers FTP/FTPS as a Speech Insights recording provider.
  • Password values are protected before they are stored.
  • The editor supports passive and active data-connection modes, secure encryption modes, and SSL/TLS protocol selection.