Using Notification Services › Example VOX Environment Applications › Inbound Application with Input from Caller › VOX Commands Used

VOX Commands Used

When coding such a VOX environment application, use the following ADDRESS VOX commands:

ANSWERPLAY

Begins the application in an ANSWER state. When a call comes in, the application can play a voice file or words from a word library. The advantage of using ANSWERPLAY instead of ANSWER, then PLAY, is that the VOX environment automatically loads the voice message segment to play prior to answering the phone call, thereby improving performance during the initial connection.

GETCHANNEL

Obtains an available channel using a hardcoded channel number or retrieving a channel from a group (see the note after the table).

GETDIGITS

Obtains a user's user ID (in DTMF tones), assuming the voice message segment played with ANSWERPLAY has prompted the user appropriately.

PLAYGETDIGITS

Plays voice messages with a prompt to retrieve the user's response to the prompt. PLAYGETDIGITS is recommended instead of PLAY then GETDIGITS because it facilitates an improved reading and maintenance of your application.

RELEASECHANNEL

Releases the channel used by the phone call, placing the channel in an available state for the next caller.

VERIFYUSER

Verifies the caller as a valid user of the application.

Note: When coding an inbound application, you can eliminate the GETCHANNEL command by using the ANSWERPLAY command with the GROUP keyword (waiting for a phone call from a group of channels); when a call comes in, the ANSWERPLAY command returns the appropriate channel handle to be used on subsequent ADDRESS VOX commands.