Dynamic Audio
Last updated
Was this helpful?
Last updated
Was this helpful?
The Dynamic Audio node allows a textual value to be read out to a caller as spoken words, using a predefined format in either a male or female voice. Date, Time and Currencies can be read out as English words and numerical values as conversational words. Alphanumeric characters can be read out individually either verbatim or phonetically.
Branch Name
Mandatory
Description
Continue
No
Taken when the audio playback has completed.
Failed
No
Taken if the Value could not be interpreted using the configured format.
There are four fields to configure within this node: Gender - Choose from Male or Female voice. Input Value - This is where the data to be read out is held. Interpret As - This informs the system what type of data is in the Input Value Spoken Format - This is where you specify the way you want the Input Value read out.
The following tables provides the expected characters for the input value property. Any character not included in this table will be removed from the input value before it is interpreted.
Interpret As
Expected Characters
Alpha Numeric
A to Z 0 to 9 "Space"
When the interpreter encounters a "Space", a 0.2 second pause will be inserted for each space into the audio playback. Any special characters will be removed, for example if the value contains a decimal point, "15.96", it will become "1596" and be played back according to the selected format. The largest number value that can be played back using the conversational format is 999,999,999,999
Date
A to Z 0 to 9 "Space" "/" ":" "-"
Date values are expected in British date format dd/mm/yyyy or dd-mm-yyyy but can also be in long date format. "01 January 2020", "01 Jan 2020", "01/01/2020", "01-Jan-2020" are all acceptable. It is also acceptable but not required for the date value to also include the time. The time part of the value will be ignored by the interpreter.
Time
A to Z 0 to 9 "Space" "/" ":" "."
Currency
0 to 9 "."
Integer or decimal values are acceptable. Values with more than two decimal places will be rounded to two. "23.123" would become "23.12" "23.126" would become "23.13" The largest decimal value that can be played back is 999,999,999,999.99
Value
Interpret As
Format
Audio Playback
123
AlphaNumeric
Conversational
"One Hundred and Twenty Three"
10 99
AlphaNumeric
Conversational
"Ten" [pause] "Ninety Nine"
100b
AlphaNumeric
Conversational
"One Hundred Bee"
a b c200
AlphaNumeric
Conversational
"Ay" [pause] "Bee" [pause] "Cee Two Hundred"
1001 0
AlphaNumeric
Conversational
"One Thousand and One" [space] "Zero"
word
AlphaNumeric
Conversational
"Doubleyou Oh Arr Dee"
123abc
AlphaNumeric
Phonetically
"One Two Three Alpha Bravo Charlie"
123 45 b
AlphaNumeric
Verbatim
"One Two Three" [space] "Four Five" [space] "Bee"
01/12/2020
Date
DW
"Wednesday"
01/12/2020
Date
DWDDMM
"Wednesday The First Of December"
01/12/2020
Date
DDMM
"The First Of December"
01/12/2020
Date
DDMMYYYY
"The First Of December Twenty Twenty"
01/12/2020
Date
DWDDMMYYYY
"Wednesday The First Of December Twenty Twenty"
01/12/2020
Date
MMDD
"December The First"
01/12/2020
Date
DWMMDD
"Wednesday December The First"
01/12/2020
Date
MMDDYYYY
"December The First Twenty Twenty"
01/12/2020
Date
DWMMDDYYYY
"Wednesday December The First Twenty Twenty"
15:30
Time
HM12
"Three Thirty Pee Em"
03:30
Time
HM12
"Three Thirty Ay Em"
01:00
Time
HM12
"One Pee Em"
00:00
Time
HM12
"Twelve Ay Em"
01:00
Time
HM24
"Oh One Hundred Hours"
15:30
Time
HM24
"Fifteen Thirty"
03:30
Time
HM24
"Oh Three Thirty"
00:00
Time
HM24
"Zero Hundred Hours"
15.16
Currency
GBP
"Fifteen Pounds and Sixteen Pence"
15
Currency
GBP
"Fifteen Pounds"
15.00
Currency
GBP
"Fifteen Pounds"
1.99
Currency
GBP
"One Pound and Ninety Nine Pence"
0.32
Currency
GBP
"Thirty Two Pence"
26.15
Currency
USD
"Twenty Six U S Dollars and Fifteen Cents"
1.01
Currency
USD
"One U S Dollar and One Cent"
28.28
Currency
EUR
"Twenty Eight Euros and Twenty Eight Cents"
The maximum length of the Input Value property is 32 characters including spaces. The input value can either be a literal value or a . It is important to set the input value property to a value that can be interpreted using the format you have selected. The Interpret As and Spoken Format properties determine how the value will be interpreted and played back to the caller. If you have selected the input value to be interpreted as a Date, the textual value must represent a valid date in the British format. The validation of the value does not take place in the when saving the Service so it is possible to enter unexpected values and characters for a selected format. The interpretation and sanitation of the input value takes place during the call. Before the input value is interpreted it is first sanitized, removing any characters that are not in the expected characters for the selected format (see table below). If it is still not possible to playback the input value according to the configured format, the call flow will continue down the Failed branch.
Times are expected in hh:mm or hh.mm and can be in 12 or 24 hour format. The value can also contain the seconds (hh:mm:ss) but the seconds will be ignored by the interpreter. Values such as "15:30", "3:30pm", "03:30am", "03.30 p.m" are acceptable. Time Zone information is not currently supported. The interpreter will ignore any time zone information, also if a Time Zone is specified in the node this will be ignored. The value can also include a date but it not required. The date part of the value will be ignored by the interpreter.