Text cleaner

Cognigy helps you clean up user input (text or voice) with built-in functions. For example, if a user says alpha tango hotel double seven three nine minus L for London and C for Canada, it can automatically be converted to ath 7739 - lc. These text cleaner functions support the English (en) and German (de) locales and are available in:

Functions

Function name	Description
`cleanDisallowedSymbols`	Removes all symbols that aren’t explicitly allowed. All letters and numbers are allowed by default, and additional allowed symbols can be set.
`resolveSpelledOutNumbers`	Replaces all number words with their numerical representation. For example, “five and three hundred nineteen” > “5 319”.
`resolvePhoneticAlphabet`	Detects and replaces all words that are part of the phonetic alphabet. For example, “alpha tango lima” > “a t l”.
`replaceSpecialWords` (Deprecated)	Replaces specifically set words with their replacements. For example, “lufthansa” > “lh”. As of Cognigy 4.58.0, this function is deprecated. Use the `replaceSpecialPhrases` function instead.
`replaceSpecialPhrases`	Replaces specific words or phrases with replacements. For example, “Conversational AI” is changed to “CAI”, “New York” to “NY”, and “lufthansa” to “lh”.
`resolveSpelledOutAlphabet`	Resolves phrases like “a for anton b as in bertram” to “a b”.
`resolvePhoneticCounters`	Resolves strings like “3 times 2” to “222” or “double 4” to “44”. Learn more about special rules in the Rules for resolvePhoneticCounters section.
`contractSingleCharacters`	Joins all single characters standing alone into a full string. For example, “my name is c o g n i g y” > “my name is cognigy”.
`contractNumberGroups`	Joins all numbers standing next to each other. For example, “his number is 333 43 22 44” > “his number is 333432244”.
`trimResult`	Trims the start and end of the string and replaces all double (or more) spaces with single spaces.

Rules for resolvePhoneticCounters

This function is designed to convert phrases like “3 times 2” into their numeric representation, such as “3 times 2” to “222” or “double 4” to “44.” The function handles sentences that include both a multiplier (for example, “3 times” or “double”) and a multiplicand (for example, “2” or “4”). The multiplicand can be either a number or a character. Some examples can be ambiguous. For instance, consider the phrase “double ap 3 4”, which could be interpreted as either “aap34” or “apap34.” To avoid this ambiguity, Cognigy defines the following rules for multiplicand types:

Multiplicand type	Rule	Example
Number		2 times 3, 2 times 16
Multiplicand is a number less than 13	The multiplicand is repeated in full.	”2 times 3” will return “33” “2 times 11” will return “1111”
Multiplicand is a number greater than or equal to 13	Only the first digit is repeated. The first digit is given priority due to the more common usage of phrases like “3 times 4” or “3 times 12,” compared to “3 times 25”.	“2 times 16” will return “116”
Character		2 times alpha, 2 times ox
Multiplicand is a phonetic character	It’s resolved, and the character is repeated.	”2 times alpha” will return “aa”
Multiplicand has more than one character and isn’t a phonetic character	Only the first character is repeated. Cognigy assumes that the speech-to-text (STT) system transcribed the user input incorrectly and that the user intended to say separate characters.	”2 times ox” will return “oox” (Cognigy assumes that the user intended to say “2 times o, x”)

Getting started

Design

Test

Deploy

Analyze

Advanced

Functions

Rules for resolvePhoneticCounters

​Functions

​Rules for resolvePhoneticCounters

Functions

Rules for resolvePhoneticCounters