Work with dictionary management
- Speech and Text Analytics > Dictionary Term – View permission
- Speech and Text Analytics > Dictionary Term – Add permission
- Speech and Text Analytics > Dictionary Term – Edit permission
- Speech and Text Analytics > Dictionary Term – Delete permission
Dictionary management lets you improve transcription accuracy by adding organization-specific terms. These terms help ensure that names, acronyms, and industry language appear correctly in transcripts.
You can create dictionary entries for these services:
- Genesys native voice transcription
- Extended Voice Transcription Services (EVTS) using Amazon Web Services (AWS) Transcribe
Each dictionary entry applies to a specific transcription engine and dialect.
How dictionary management works
Dictionary entries influence how the transcription engine recognizes and displays words in conversations.
- Each entry is tied to a transcription engine and dialect.
- Entries are processed and applied automatically after you save them.
- Updates typically take effect within 15 minutes.
- Changes apply to new interactions; ongoing interactions may not reflect updates immediately.
For more information, see Understand dictionary management.
When working with dictionary management, you can perform these actions:
- Click Menu > Conversation Intelligence > Speech and Text Analytics > Dictionary Management.
- From the list that appears, search for a specific term, search for terms associated with a specific dialect, edit a term, and delete a term.
- Click Menu > Conversation Intelligence > Speech and Text Analytics > Dictionary Management.
- Click Add Term.
- Select the transcription engine that you want to target:
- Genesys Native Voice Transcription
- Extended Voice Transcription Services (EVTS)
- Add a new term for a Genesys native voice transcription dialect:
- Under Term, add the term. The term cannot be more than 30 characters.
- Select a dialect.
- (Optional) In the Sounds Like field, type a word that sounds like the term to add and then press Enter. You can add up to 10 words.
- If the Example Phrases field appears for the selected dialect, click Add Phrase and enter an example phrase that contains the dictionary term. Note: The Example Phrases field appears only for dialects whose transcription model uses example phrases. You cannot add more than 20 example phrases. The dictionary management system does not support special characters or capitalization. All entries are processed in lowercase and must contain only standard alphanumeric characters (a—z, 0–9). For English, Spanish, and French language variants that use Genesys Native Transcription, example phrases are not used and the field does not appear.
- (Optional) In the Display As field, enter exactly how you want the recognized term to appear in interaction transcripts. Notes:
- Use this field to specify acronyms, preferred capitalization, product or brand-specific spelling, numbers, punctuation, or other formatting.
- You can enter characters from any character set in this field.
- For example, enter ceo as the dictionary term and C.E.O. in Display As to display recognized instances of the term as C.E.O.
- The Display As value can contain up to 50 characters.
- In the Boost Value field, select the recognition weight for the dictionary term. A higher value increases the likelihood that the transcription engine favors the dictionary term when multiple interpretations are possible. The supported values are 1.0 through 10.0, in increments of 1. The default value is 2.0.
- Click Add to Dictionary. For more information, see Dictionary management best practices.
- Under Term, add the term. The term cannot be more than 30 characters.
- Select a dialect.
- In the Display As field, define how the term is shown in the interaction transcript (for example, four o one k -> 401K).
- Click Add to Dictionary.
- Click Menu > Conversation Intelligence > Speech and Text Analytics > Dictionary Management.
- From the list that appears, click the term you want to edit.
- Make the desired updates. Depending on the selected transcription engine and dialect, you can update Sounds Like, Example Phrases, Display As, and Boost Value. Only fields supported by the selected transcription model appear.
- Click Add to Dictionary.
- Click Menu > Conversation Intelligence > Speech and Text Analytics > Dictionary Management.
- From the list that appears, in the Action column, click Delete .
Dictionary entry status shows at an individual term level, whether it has been successfully applied, and can be expected to appear in conversation transcripts. Possible term statuses include:
- Pending: Waiting to be applied
- Active: Available in transcription
- Failed: Not applied due to error
- Invalid: Not supported or incorrectly formatted
Rules for EVTS dictionary entries
- No digits in terms (spell out numbers)
- No hyphens or unsupported special characters
- Acronyms must include periods (for example, F.B.I.)
- Enter multi-word terms with spaces (the system converts internally)
Character limits
- Term: 30 characters
- Display As: 50 characters
Validation and errors
The system validates dictionary entries when you add or edit them. An error can occur under these circumstances:
- The term includes unsupported characters
- The format is invalid (for example, incorrect acronym format)
- The dialect or engine combination is not supported
Validation applies to both the user interface and APIs.
- Dictionary entries are engine-specific
- Entries are not automatically migrated between engines
- Recreate terms when switching engines
- The same term can exist in both engines
Each supported language has a defined character set that the Native transcription engine recognizes. When you create Native dictionary terms, use only the characters allowed for your dialect. Using unsupported characters cause validation to fail.
For the Native transcription engine, character-set validation applies to:
- Term values
- Sounds Like values
- Example Phrases, for dialects where the Example Phrases field is available
Languages
English character set (en-US, en-GB, en-AU, en-ZA, en-IN)
Spanish character set (es-US, es-ES)
German (Germany) character set (de-DE)
German (Switzerland) character set (de-CH)
French character set (fr-FR, fr-CA)
Portuguese character set (pt-BR, pt-PT)
Italian character set (it-IT)
Dutch character set (nl-NL)
Polish character set (pl-PL)
Arabic character set (ar-001, ar-SA, ar-AE, ar-BH, ar-EG, ar-IL, ar-TN)
Hebrew character set (he-IL)
Korean character set (ko-KR)
Japanese character set (ja-JP)
English character set (en-US, en-GB, en-AU, en-ZA, en-IN)
For English dictionary terms, you can use the following characters in the Term and Sounds Like fields:
- Letters A–Z and a–z only
- Space (” “)
- ‘ (apostrophe)
Spanish character set (es-US, es–ES)
For Spanish dictionary terms, you can use the following characters in the Term and Sounds Like fields:
- A-Z
- a-z
- Space (” “)
You can also use the following Unicode characters in these fields:
| Character | Code | Character | Code |
|---|---|---|---|
á | 00E1 | Á | 00C1 |
é | 00E9 | É | 00C9 |
í | 00ED | Í | 00CD |
ó | 00F3 | Ó | 00D3 |
ú | 00FA | Ú | 00DA |
ñ | 00F1 | Ñ | 00D1 |
ü | 00FC | Ü | 00DC |
German (Germany) character set (de-DE)
For German (Germany) dictionary terms, you can use the following characters in the Term value, Sounds Like and Example Phrases fields:
- A-Z
- a-z
- Space (” “)
- ‘ (apostrophe)
You can also use the following Unicode characters in these fields:
| Character | Code | Character | Code |
|---|---|---|---|
ä | 00E4 | Ä | 00C4 |
ö | 00F6 | Ö | 00D6 |
ü | 00FC | Ü | 00DC |
ß | 00DF | ẞ | 1E9E |
German (Switzerland) character set (de-CH)
For German (Switzerland) dictionary terms, you can use the following characters in the Term value, Sounds Like and Example Phrases fields:
- A-Z
- a-z
- Space (” “)
- ‘ (apostrophe)
You can also use the following Unicode characters in these fields:
| Character | Code | Character | Code |
|---|---|---|---|
ä | 00E4 | Ä | 00C4 |
ö | 00F6 | Ö | 00D6 |
ü | 00FC | Ü | 00DC |
French character set (fr–FR, fr-CA)
For French dictionary terms, you can use the following characters in the Term and Sounds Like fields:
- A-Z
- a-z
- Space (” “)
- ‘ (apostrophe)
You can also use the following Unicode characters in these fields:
| Character | Code | Character | Code |
|---|---|---|---|
à | 00E0 | À | 00C0 |
â | 00E2 | Â | 00C2 |
ô | 00F4 | Ô | 00D4 |
é | 00E9 | É | 00C9 |
è | 00E8 | È | 00C8 |
ë | 00EB | Ë | 00CB |
ê | 00EA | Ê | 00CA |
ï | 00EF | Ï | 00CF |
î | 00EE | Î | 00CE |
ç | 00E7 | Ç | 00C7 |
û | 00FB | Û | 00DB |
Portuguese character set (pt-BR, pt-PT)
For Portuguese dictionary terms, you can use the following characters in the Term value, Sounds Like and Example Phrases fields:
- A-Z
- a-z
- Space (” “)
- ‘ (apostrophe)
You can also use the following Unicode characters in these fields:
| Character | Code | Character | Code |
|---|---|---|---|
ç | 00E7 | Ç | 00C7 |
á | 00E1 | Á | 00C1 |
é | 00E9 | É | 00C9 |
í | 00ED | Í | 00CD |
ó | 00F3 | Ó | 00D3 |
ú | 00FA | Ú | 00DA |
â | 00E2 | Â | 00C2 |
ê | 00EA | Ê | 00CA |
ô | 00F4 | Ô | 00D4 |
ã | 00E3 | Ã | 00C3 |
õ | 00F5 | Õ | 00D5 |
à | 00E0 | À | 00C0 |
Italian character set (it-IT)
For Italian dictionary terms, you can use the following characters in the Term value, Sounds Like and Example Phrases fields:
- A-Z
- a-z
- Space (” “)
- ‘ (apostrophe)
You can also use the following Unicode characters in these fields:
| Character | Code | Character | Code |
|---|---|---|---|
à | 00E0 | À | 00C0 |
è | 00E8 | È | 00C8 |
é | 00E9 | É | 00C9 |
ì | 00EC | Ì | 00CC |
í | 00ED | Í | 00CD |
ò | 00F2 | Ò | 00D2 |
ó | 00F3 | Ó | 00D3 |
ù | 00F9 | Ù | 00D9 |
ú | 00FA | Ú | 00DA |
Dutch character set (nl–NL)
For Dutch dictionary terms, you can use the following characters in the Term value, Sounds Like and Example Phrases fields:
- A-Z
- a-z
- Space (” “)
- ‘ (apostrophe)
You can also use the following Unicode characters in these fields:
| Character | Code | Character | Code |
|---|---|---|---|
à | 00E0 | À | 00C0 |
á | 00E1 | Á | 00C1 |
è | 00E8 | È | 00C8 |
é | 00E9 | É | 00C9 |
ê | 00EA | Ê | 00CA |
ë | 00EB | Ë | 00CB |
ï | 00EF | Ï | 00CF |
ö | 00F6 | Ö | 00D6 |
ü | 00FC | Ü | 00DC |
Polish character set (pl–PL)
For Polish dictionary terms, you can use the following characters in the Term value, Sounds Like and Example Phrases fields:
- A-Z
- a-z
- Space (” “)
- ‘ (apostrophe)
You can also use the following Unicode characters in these fields:
| Character | Code | Character | Code |
|---|---|---|---|
ą | 0105 | Ą | 0104 |
ć | 0107 | Ć | 0106 |
ę | 0119 | Ę | 0118 |
ł | 0142 | Ł | 0141 |
ń | 0144 | Ń | 0143 |
ó | 00F3 | Ó | 00D3 |
ś | 015B | Ś | 015A |
ź | 017A | Ź | 0179 |
ż | 017C | Ż | 017B |
Arabic character set (ar-001, ar-SA, ar-AE, ar-BH, ar-EG, ar-IL, ar-TN)
For Arabic dictionary terms, you can use the following characters in the Term value, Sounds Like and Example Phrases fields:
- A-Z
- a-z
- Space (” “)
- ‘ (apostrophe)
You can also use the following Unicode characters in these fields:
| Character | Code | Character | Code |
|---|---|---|---|
ء | 0621 | آ | 0622 |
أ | 0623 | ؤ | 0624 |
إ | 0625 | ئ | 0626 |
ا | 0627 | ب | 0628 |
ة | 0629 | ت | 062A |
ث | 062B | ج | 062C |
ح | 062D | خ | 062E |
د | 062F | ذ | 0630 |
ر | 0631 | ز | 0632 |
س | 0633 | ش | 0634 |
ص | 0635 | ض | 0636 |
ط | 0637 | ظ | 0638 |
ع | 0639 | غ | 063A |
ف | 0641 | ق | 0642 |
ك | 0643 | ل | 0644 |
م | 0645 | ن | 0646 |
ه | 0647 | و | 0648 |
ى | 0649 | ي | 064A |
Hebrew character set (he-IL)
For Hebrew dictionary terms, you can use the following characters in the Term value, Sounds Like and Example Phrases fields:
- A-Z
- a-z
- Space (” “)
- ‘ (apostrophe)
| Character | Code | Character | Code |
|---|---|---|---|
א | 05D0 | ב | 05D1 |
ג | 05D2 | ד | 05D3 |
ה | 05D4 | ו | 05D5 |
ז | 05D6 | ח | 05D7 |
ט | 05D8 | י | 05D9 |
ך | 05DA | כ | 05DB |
ל | 05DC | ם | 05DD |
מ | 05DE | ן | 05DF |
נ | 05E0 | ס | 05E1 |
ע | 05E2 | ף | 05E3 |
פ | 05E4 | ץ | 05E5 |
צ | 05E6 | ק | 05E7 |
ר | 05E8 | ש | 05E9 |
ת | 05EA |
Korean character set (ko-KR)
For Korean dictionary terms, the supported characters for the Term value, Sounds Like, and Example Phrases fields are listed in the following PDF file:
Japanese character set (ja-JP)
For Japanese dictionary terms, the supported characters for the Term value, Sounds Like, and Example Phrases fields are listed in the following PDF file:
[NEXT] Was this article helpful?
Get user feedback about articles.