Dynamic Audio

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 Input Value Property

The maximum length of the Input Value property is 32 characters including spaces. The input value can either be a literal value or a Custom Service Variable. 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 Service Designer 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.

Expected Characters

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" "/" ":" "."

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 Start 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.

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

Example Playback

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"

Last updated

Was this helpful?