Create or modify a folder

Folders may be created or modified using the UI, or with the API using the /config endpoint. Before using either method, V‑Spark must have at least one company and one organization configured for ASR processing.

Dialog 1

  1. Click settings icon Settings > Folders to navigate to the Monitored Folders screen.

  2. Click add icon Add. The Create New Folder dialog displays.

  3. Specify the settings displayed on the first page of the dialog, as in the following example:first page of create new folder dialog

    Important: Settings configured on the first page of the Create New Folder dialog can't be changed after the folder is created, except for the ASR server in the Servers dropdown. Changing audio settings requires creating a new folder. Check your audio's properties with V‑Spark's built-in evaluation tool.

    Use the first page of the Create New Folder dialog to configure the following options:

    1. Organization — Select the folder's company and organization. A folder's company and organization determine the availability of some of its ASR configuration settings.

    2. Folder Name — Enter a name for the new folder. Folder names are case sensitive, and must not be longer than 100 characters.

    3. Servers — Select the servers to be used for ASR processing. Multiple servers may be selected from the dropdown if available. Server options are based on the folder's company and organization configurations.

      Note: Configuring a folder to use multiple ASR servers that do not use the same language models may result in an error message indicating that "One or more servers does not have this model anymore." This error will only impact ASR processing if the language model has been removed from all of the folder's servers.
    4. # of speakers — Select the number of speakers in the audio, either 1 or 2.

    5. Audio Type — Select either mono (single-channel) or stereo (two-channel) audio.

      Note:

      If a folder is configured with the # of speakers field set to 2 and the Audio Type field set to Mono, that folder's processed audio is separated, or diarized, into 2 channels. Each speaker is assigned to a different channel. Speakers in the resultant transcript are classified as either Agent or Client using side classification.

      To prevent diarization of audio with more than two speakers, configure the folder for Mono audio with 1 speaker.

    6. PCI Redact TextOptional. Select to enable redaction for text transcripts processed by this folder. Enabling text redaction causes the ASR engine to remove payment card information (PCI) and other sensitive numbers from text transcripts.

    7. PCI Redact AudioOptional. Select to enable redaction for audio processed by this folder. Enabling audio redaction causes the ASR engine to remove PCI and other sensitive numbers from the processed audio file.

Dialog 2

  1. Click Next. The dialog displays additional folder configuration options, as in the following example:second page of create new folder dialog

    Use the second page of the Create New Folder dialog to configure the following options:

    Link to Applications — Select the applications to be used for analysis on the transcription output for all audio processed by the folder. See Folder-application links for more information.

    Model — Select the language models to be used for audio transcription requested by the folder. One model must be selected for each audio channel, and channels may use either identical or distinct language models.

    Model selection greatly impacts transcription accuracy because they are tuned to specific audio scenarios and environments, like voicemail or call centers.

    Which channel is the agent on? — Select the audio channel for agent speech. This option is used only with stereo audio folder configuration. A value of 0 refers to the left audio channel, and a value of 1 refers to the right audio channel.

    Important: The agent channel must be set to the correct value for transcription analysis, and it cannot be changed after the folder is created.

    Advanced settings — Enable and configure settings for callbacks, custom metadata, ASR options, and duplicate file rejection.

    Enabling Reject duplicate records by filename prevents the folder from accepting any file with the same name as one that has already been uploaded. The remaining advanced settings must be configured after being enabled.

    To configure advanced settings, enable them and click Next. An additional Create New Folder dialog displays for each enabled setting except for duplicate file rejection. The last page of the configuration dialog has a Create button.

    Refer to the following topics for more information about configuring other advanced settings:

  2. Click Create to close the configuration dialog and create the folder.

  3. View the ASR server status field for the newly-created folder on the Monitored Folders screen. A green circle green circle icon in the server status field indicates an active and authenticated connection which means the folder is ready to process audio.

Modify

To modify an existing folder, click its edit icon Edit icon on the Accounts page. The Update Folder dialog appears with the same fields as the Create New Folder dialog. Some fields may not be modified after a folder is created.