Play
The Play
module can :
- Play a sound file,
- Speak the typed text (Text to
Speech),
- Speak the specified text file
(Text to Speech),
- Play DTMF tones
- Send Hookflash signal
While playing
the module will await a key press from the caller. You can select
the number of times the message will be re-played, and the pause
between the replays.
Result Variables
can be used
when specifying the sound file to be played. In the example below
the file played will be different depending on what selection the
caller made in the 'Get Language' module.
Multiple
sound files can be selected to be played by separating the
successive files by commas. eg:
prompts\1.wav,
prompts\2.wav
would result
in two files from the script's prompts subdirectory being played
(1.wav and 2.wav) one after another.
If the sound
files are specified without a full path then VoiceGuide will search
for the sound files in the script's directory, or in a
script's \voice\
subdirectory (if it
exists).
Text to Speech
The
Text to Speech option (TTS) is only
available in the Enterprise and the Trial versions of
VoiceGuide.
The text
entered in the "Text to speak" box will be spoken. XML tags can be
used when specifying the text to be spoken. For full details on the
XML tags which can be used please refer to Microsoft's SAPI 5
specification, or to your TTS engine's reference.
If
a text file can be specified in the ”Sound File” text box then
VoiceGuide will read in the text file and will speak (TTS) the
contents of that file.
Paths
Paths
specify which
module the caller will go to if they press a key. A simple example
is below.
If the
pressed key matches one of the specified paths the caller will go
to the corresponding module.
If no Timeout
path is specified and no selection is made within 10 seconds of the
last message replay finishing, VoiceGuide will hang up the
call.
Playing DTMF
tones and Hookflash
The Play
module can also play DTMF tones, and send Hookflash signals. To
specify the DTMF tones to send, type in the DTMF tone sequence in
the “Sound File” text box. An exclamation mark
“!”
indicates a hookflash, and a comma “,”
indicates a pause, whilst characters “0-9“ and “A-D“
are used to indicate DTMF tones
When using
Voice Modems you can only specify either a hookflash or DTMF tones
in a Play module. This means that in order to have the modem send a
hookflash followed by DTMF tones you will need to use two Play
modules one after another. The first Play module would just contain
the hookflash, and the next module will contain the DTMF string.
You should then use a Timeout path to link the two modules together
(eg: On {Timeout 1} Goto
[Dial Number] ). In this situation using
the Timeout path allows you to specify exactly how long after the
hookflash will the DTMF tones be dialed. Pause characters cannot be
used at all with most Voice modems.
When using
Dialogic cards any combination of DTMFs, hookflashes and pauses can
be specified on the one line and the Dialogic card will play them
correctly.
Automated
DNIS based file selection
VoiceGuide
allows per-DNIS sound file specification.
If DNIS is
supplied on the call then VoiceGuide will see if a "DNIS-tagged"
derived filename exists. The "DNIS-tagged" derived filename is the
original filename with a "_DNIS" inserted just before
the ".wav" in the filename.
eg. if the
Play module is configured to play a file welcome.wav and the DNIS on the call is 1234 then
VoiceGuide will first search for file welcome_1234.wav If welcome_1234.wav does not exist then VoiceGuide will play the
sound file welcome.wav
NB: DNIS is an
expression indicating th1e number dialed by the caller, and is only
really available on ISDN and VoIP systems. On analog systems a
close replacement of this functionality can be achieved by using
$RVs within the filename to be played, and setting RV value
previous based on Inband Signaling or user selection
etc.
