Create and manage phrases and phrase categories

Use the Phrase Manager page to create, manage, import, and export the phrases used in speech and text analytics tasks.

A phrase is a group of one or more words that Calabrio ONE can search for as a single grammatical unit in audio and text tasks. When you provide a phrase that is important to your business, Calabrio ONE searches for that phrase in the transcriptions of audio recordings and the text in emails and chats.

A category is a collection of phrases that you organize together because they have a similar business purpose or language. For example, a category called “Cancel Order” could contain phrases like “about to cancel,” “cancel that one,” and so on. Analytics tasks can process multiple phrase categories, and phrase categories can be used in multiple tasks. You can also use categories to group phrases by language. For example, you can create a “Happy Customer—English” category for agents who speak English and a “Client heureux—français” category for agents who speak French.

A task is a job that tells Calabrio ONE to search specific types of contacts for phrases within specific categories. You manage tasks on the Task Manager page. See Create Analytics tasks for more information about tasks.

The diagram below illustrates the relationship between phrases, categories, and tasks.

Prerequisites

This feature is available to Calabrio GovSuite users.

  • You have the Administer Text Analytics and Administer Speech Analytics permissions

Page location

Application Management > Analytics > Phrase Manager

Procedures

View the phrases in existing categories

  1. (Optional) To view phrases for languages other than United States English, select a language from the drop-down list at the top of the Phrase Categories panel.
  2. Click a category in the Phrase Categories panel. Phrases within that category appear in the Phrases panel.

View the tasks that use a category

  • Click the options icon (the three dots) next to the category, and then select Associated Tasks from the drop-down list. The Associated Tasks window opens with a list of all the tasks that use this category, along with the task type and schedule (ongoing or ad hoc).

Get suggestions for new phrases

Calabrio ONE uses artificial intelligence to generate phrases to add to your categories. Phrase suggestions are based on “seed” phrases that are already in the category.

  1. Click the category in the Phrase Categories panel.
  2. In the Phrases panel, select the check box next to the “seed” phrases that you want Calabrio ONE to use to generate suggestions.

    BEST PRACTICE   Select at least three phrases. Calabrio ONE can make suggestions based on only one phrase, but selecting more gives it more material to work with.

  3. In the Suggestions panel, click Make Suggestions. A list of suggested phrases appears.
  4. Click a suggestion to add it to the category.
  5. (Optional) To get more suggestions, select the check box next to the seed phrases and click Make Suggestions again.
  6. When you are finished adding phrases, click Save.

Add a new phrase

NOTE   A phrase can exist in only one category. If you need to add an existing phrase to a new category, first delete the phrase from its old category.

  1. Click the category that the new phrase will go into in the Phrase Categories panel. Phrases that are already in the category appear in the Phrases panel.
  2. In the Phrases panel, enter the new phrase in the Type to create a phrase field.
  3. Press the Enter key. The new phrase is added to the list of phrases. By default, the new phrase is active.
  1. Click Save.

Add a new category

  1. In the Phrase Categories panel, enter the category name in the Create a phrase category field.
  2. (Optional) Enter a description for the category in the Description field.
  3. Click Save. The category and its description appear in the list of categories.

Edit a phrase

IMPORTANT   Be careful when editing phrases. Editing a phrase can create a mismatch between previous phrase hits and new hits.

  1. Click the phrase you want to edit.
  2. Edit the phrase.
  3. Press the Enter key.

Edit a category

You can edit a category’s name and description.

  1. Click the options icon (the three dots) next to the category and then select Edit from the drop-down list.
  2. Edit the category.
  3. Click Save.

Disable a phrase

Disabling a phrase removes it from all speech-to-text (transcription) tasks. Calabrio ONE does not identify hits for disabled phrases.

  1. Click the phrase.
  2. Select Inactive from the Active drop-down list.
  3. Click Save.

Enable a phrase

Enabling a phrase causes Calabrio ONE to search for it in all speech-to-text (transcription) tasks.

  1. Click the phrase.
  2. Select Active from the Inactive drop-down list.
  3. Click Save.

Delete a phrase

You can delete a phrase only when any contacts that contain hits for that phrase have reached the end of their data retention period and are deleted.

  1. Select the check box next to the phrase.
  2. In the upper-right corner of the Phrases panel, click Delete. The phrase is deleted immediately.

Delete a category

IMPORTANT   Deleting a category also deletes all the category’s phrases. Deleting a category cannot be undone.

  1. Click the options icon (the three dots) next to the category and then select Delete from the drop-down list. A confirmation window opens.
  2. Click Delete. The window closes.

Import categories and phrases

You can use a CSV file to import new categories and phrases and update existing categories and phrases. The file you import must include the columns listed in the table below, in the order shown (top to bottom = order left to right in the file). If there is a format error, the import fails.

NOTE   A phrase can exist in only one category. If you try to import Phrase A to Category B, but Phrase A already exists in Category C, Calabrio ONE will not add Phrase A to Category B.

  1. Click the options icon (the three dots) at the top of the Phrase Categories panel and select Import from the drop-down list. Your device’s file explorer opens.
  2. Locate the CSV file and then click Open.

BEST PRACTICE   We are in the process of removing the Phonetic, Soundslike, and Confidence fields. We recommend that you not use these columns in your imported CSV file.

Column Description

Category

(required) The name of the category.

Phrase

(required) The phrase text.

Phonetic

This column is no longer used.

Soundslike

This column is no longer used.

Confidence

This column is no longer used.

State

(required) 0 (zero) if the phrase is disabled for Analytics, or 1 if the phrase is enabled for Analytics.

LanguageID

(required) The 2-character language code and 2-character country code for the phrase, in the format nn-nn.The table below lists the supported languages.

Language Code

Arabic

ar-ar

Danish

da-dk

Dutch (Netherlands) nl-nl
English (Australia) en-au
English (Euro) en-eu
English (South Africa) en-za
English (U.K.) en-uk
English (U.S.) en-us
Finnish fi-fi
French (Canada) fr-ca

French (France)

fr-fr

German (Germany)

de-de

Italian

it-it

Norwegian

no-no

Portuguese (Brazil)

pt-br

Spanish (Euro)

es-eu

Spanish (North America)

es-mx

Swedish

sv-se

Export categories and phrases

You can export all Phrase Manager data to a CSV file.

  • Click the options icon (the three dots) at the top of the Phrase Categories panel and select Export All from the drop-down list. A file named phrases.csv downloads to your device.

Related Topics