Designer

<=Cell title, used to identify cell
<=Cell type, defines behaviour of cell

<=Description, free comment

<=Voice file(s)
Dbl click to select or enter Result Variable
<=Options
<=Parameters

<=Targets, next steps
Some of the cells have only SUCCESS/FAIL as trigger option, some only NEXT.

Double click on trigger or target to change

This cell always requires a TimeOut trigger to be defined.

In this example the caller may press the "1" key which leads to the GetName cell or wait 10s and go to the GetID cell.
If Beep at end of module is selected the caller will hear a beep at the end of the announcement.

Keys allowed :
Defined by Trigger

Result Variable :
Key pressed by caller

If Beep at end of module is selected the caller will hear a beep at the end of the announcement.

Keys allowed :
(No key entry)

Result Variable :
None

Keys allowed :
"1234567890*#"
"12" (in confirm number)

Result Variable :
Number entered by caller

If the words in the string are pre-recorded, the actual voice files are played. =>Voice Engine
Alternatively you may select to use the Microsoft TTS Engine and let the text read by a computer voice.

Then it plays the Voice file after.

In this example it reads back the string created as Result Variable of the cell Check ID.

Setting the TimeOut value to zero allows continuing straight to the End cell without waiting for the caller to press a key.

Keys allowed :
Defined by Trigger

Result Variable :
Key pressed by caller

First plays the voice file Msg before. Then the caller has Timeout [s] seconds to speak a word or a sentence that is then recognized by the speech engine. If no word is spoken, the FAIL path is taken, otherwise the SUCCESS path is selected and the recognized word is available in the Result Variable of this cell.
To redue the accuracy of the speech recognition it is highly recommended to use a SAPI grammar file. If no file is defined, INS will return any word/phrase spoken.
 

Tip:
To control the flow of the call, you may use a Result Variable Switch as next cell and evaluate which cell is to be executed next.

Keys allowed :
None

Result Variable :
Recognized word or sentence.

In this example it calls the external application TestID and passes the result variable from the cell Get ID as parameter. If successful Speak PW is the next cell, if not the End cell is selected.

FAIL/SUCCESS is decided like follows:
If the "Wait until completed" flag is set, then the external application needs to create a two line text file RESULTx.TXT (x for the channel ID. IE for the first channel RESULT1.TXT, for the second channel RESULT2.TXT, etc),
where the first line is either the string FAIL or SUCCESS, indicating failure or success. The second line can contain a string, which is used as result variable for this cell. The file needs to be created in the C:\INS directory.
If the "Wait until completed" flag is not set, the SUCCESS path is taken and the result variable is empty.


If the application contains spaces, do not include it in "", if the parameter contains spaces, then include it in "":
Example :
C:\Program Files\Windows Media Player\mplayer2.exe "C:\MAW Software\My Scripts\Test\test.wav"

Keys allowed :
(No key entry)

Result Variable :
2nd line returned by RESULTx.TXT

Warning: All result variables of the old script are lost.

The left example would call a new script Script2 and start it at cell Start.

Keys allowed :
(No key entry)


Result Variable :
None

Keys allowed :
(No key entry)

Result Variable :
Parameter returned by WScript.Quit(param) if any.

To return strings from a VBS, you have two option:

1) You may set an environment variable inside the VBS as follows:
 Set WSHShell = WScript.CreateObject("WScript.Shell")
 WSHShell.Environment.item("MyVariable") = "Hello world"
and then use $RV[@ENVVAR{MyVariable}] to access this variable inside the INS script.

2) You may write a variable to the predefined registry key HKCU\SOFTWARE\MAW Software\INS\Script\variablename as follows:
 Set WSHShell = WScript.CreateObject("WScript.Shell")
 WSHShell .RegWrite "HKCU\SOFTWARE\MAW Software\INS\Script\MyVariable", "MyValue"
and then use $RV[@REGVAR{MyVariable}] to access this variable inside the INS script.

Please read here for some important information about running VBS code in INS.

The URL does not need the leading http://. Just directly enter the address of the web page, IE www.mawnet.com/order.html

Keys allowed :
(No key entry)


Result Variable :
Contents (raw HTML text) of the web site returned

In the left example the script starts a DDE session with Excel and reads R1C1 (=A1). This value becomes the result variable of this cell. If the DDE transaction is successful the next cell becomes Speak Value, otherwise Error DDE.

Note: The external application (IE Excel or MsAccess) needs to be running during the execution of the script.

Keys allowed :
(No key entry)

Result Variable :
If action is Get Data the value received by the DDE server, otherwise none.  

In this example the filename of the recorded file is made up of a string "C:\INS\Recorded_" and a result variable , followed again by a string ".WAV"
So if the result variable is "123" the resulting filename would become "C:\INS\Recorded_123.WAV"

Keys allowed :
Defined by Trigger

Result Variable :
Key pressed by caller

NOTE: The comparison is text wise, hence 2 is bigger than 10.

In this example the cell checks the Caler ID of the current caller and chooses the next cell accordingly.
See below for notes on Conditions.

Keys allowed :
(No key entry)

Result Variable :
None  

Blind transfer puts the current call on hold, dials the new number and transfers the call without checking if the new call is available and waiting for the new call to answer.

Consultation transfer can wait for the new call to be answered before transferring the call. If the new call does not answer (or is busy), the call will not be transferred.

If Wait [s] for busy is equal to 0, then the call is transferred without waiting for a potential busy signal (unless Wait [s] for connect is not equal to 0)
If Wait [s] for connect is equal to 0, then the call is transferred without waiting for the call to be answered.

If both values are 0, then the function behaves the same than the blind transfer.

Keys allowed :
(No key entry)

Result Variable :
Phone Number

If you select (User default) as Send Type, depending on the capacity of the communication device specified for the contact the message will be adapted, IE a valid voice file path may be sent as voice file to a phone rather than character by character. (See Voice and Fax/E-mail messages)

Keys allowed :
(No key entry)

Result Variable :
Message ID attributed to this message. For messages to a contact list, the return string has the format sID1,sID2, sID3 where sID is the 17 digit message ID for every message.

In the left example the ID of the owner of the VMB is made up of a string "User" and a result variable . So if the result variable is "123" the resulting Admin ID is "User123".

The Admin ID is used to identify the owner of the mailbox in the cell Voice Mail Admin.

Keys allowed :
(No key entry)

Result Variable :
Filename of recorded voice message

If the owner of the VMB (Admin ID) has mail, the second voice file with the instructions is played, followed by the recorded voice messages. If all files were accessed the third file is played. If there is no mail the first file is played.

In this example the ID of the owner of the VMB is made up of a string "User" and a result variable. So if the result variable is "123" the resulting Admin ID is "User123".

The instructions are as follows:
1  Listen to next message
4  Delete current message
6  Re-listen current message
9  Exit

Keys allowed :
"1469"


Result Variable :
None

You can also use Message Center to access your voice mail

Valid fax files are:
APF - Fax files
BMP - Windows Bitmap
DCX - Multi page PCX
PCX - PC Paintbrush
TIF - Tagged Image File
TXT - ASCII text file


Keys allowed :
"1234567890#*"

Result Variable :
Number entered

The Generate Digits method is intended for end-to-end signaling over an established call, it may be used to navigate through automated call center menus etc., but may also be used to transfer an existing call (of course the telephone switch must support call transfer by this method). e.g. Call Send DTMF String with the DTMF parameter set to "!101" to flash the hookswitch and dial extension 101, then call the HangUp cell to effect the transfer.

Valid characters for the Digits parameter are '0' through '9', 'A', 'B', 'C', 'D', '*', '#', ';' and ',' (comma). A comma injects an extra delay between the signaling of the previous and next digits it separates. The duration of this pause is configuration defined, the telephony device settings dictate what this duration is. Multiple commas may be used to inject longer pauses. The exclamation character '!' is a valid character in the string causing a "hookflash" operation, that is, one-half second on hook, followed by one-half second off-hook before continuing. Other dial modifiers may also be accepted (W @ etc), consult the telephony device documentation for details.

Keys allowed :
(No key entry)


Result Variable :
DTMF String

IE
Text = MAW Software
Substring = maw
Return = SUCCESS

Result Variable :
None

IE
Text = MAW Software
Nbr of chars = 3
Return = MAW

Result Variable :
String found

IE
Text = MAW Software
Nbr of chars = 3
Return = are

Result Variable :
String found


IE
Text = MAW Software
Until string = $RV[@SPACE]
Return = MAW

Result Variable :
String found

IE
Text = MAW Software
From string = $RV[@SPACE]
Return = Software

Result Variable :
String found

IE
Text = MAW Software
From string = $RV[@SPACE]
Until string = ware
Return = Soft












Result Variable :
String found

IE
Text = The dog barks
Replace string... = dog
...by string = cat
Return = The cat barks

This function is quite useful for filtering characters that disturb and replace them. IE filtering ", etc






Result Variable :
Filtered string


Result Variable :
Contents of the file

Result Variable :
Filename or empty string

Valid functions are

+ - * / ^
ABS, ACOS, ASIN, ATAN, COSH, COS, EXP, LOG10, LOG, POW10, ROUND, SINH, SIN, SQRT, SQR, TANH, TAN, TRUNC

You can also use () to combine multiple operations. IE
cos(sin(1))

Result Variable :
Result of the calculation

You can modify the system value by entering a new value into the Set to value field. If no value is entered, the system variable is not changed.

The following system variables can be accessed and changed:

Result Variable :
Current value of the selected system variable.

Result Variable :
Path of the saved file as entered under Filename.

Result Variable :
None

Result Variable :
None