Information
Interactive Voice Response
IVRS
IVR
IVR Outsourcing
Virtual ACD Systems
IVR Systems
Messaging Service and Systems
Inbound Call Center
Text To Speech Software
Interactive Voice Response System
IVR Software Library
IVR Solutions
IVR Services
|
IVR Software Library
IVR Library Routine Descriptions
The following routine or parameter is maintained in the PACER and WIZARD IVR software library. These routines are developed for programmers who are creating and managing IVR application programs.
IVR programs can be written in C/C++ on Windows, Unix and Linux operating environments.
ivr_menu()
int
ivr_menu(int call, char **prompts, int numprompts, int allow_interrupt, int
max_digits, int timeout, char termchar, int clear, IVRDIGITS
*ivrd)
The
ivr_menu function plays a series of menu items and retrieves the digits
from the specified call.
Parameters
|
int
|
call
|
Specifies
which call to retrieve digits from. It can be one of the following values.
CALL_PRIMARY: Collect Digits from the Primary Call
CALL_SECONDARY: Collect Digits from the Secondary Call
|
|
char **
|
prompts
|
Array of null terminated string containing the pathnames
of the prompts to play.
|
|
int
|
numprompts
|
Number of prompts in the prompts array.
|
|
int
|
allow_interrupt
|
Specifies
if a digit can interrupt the prompts. It can be one of the following values.
NO_INTERRUPT: Do not allow prompts to be interrupted by a digit
INTERRUPT: Allow prompts to be interrupted by a digit
|
|
int
|
max_digits
|
The maximum number of digits to return. This must be less
than 32.
|
|
int
|
timeout
|
The maximum amount of time in seconds to wait for the
digits to be entered.
|
|
char
|
termchar
|
A specific character to terminate digit collection.
|
|
int
|
clear
|
Clear the buffer before digit collection. It can be one of
the following values.
NO_CLEAR: Do NOT clear the buffer before digit collection
CLEAR: Clear the buffer before digit collection
|
|
IVRDIGITS *
|
ivrd
|
Structure of type IVRDIGITS
in which the digits will be returned.
|
Return Value
Returns
IVR_SUCCESS on a successful function call. On error the function returns one
of the IVR Error Codes.
Example
char *prompts[129] = {
"D:\\ivrdemo\\prompt1.wav",
"D:\\ivrdemo\\prompt2.wav",
"D:\\ivrdemo\\prompt3.wav",
"D:\\ivrdemo\\prompt4.wav"
};
IVRDIGITS ivrd; if(ivr_menu(CALL_PRIMARY,prompts,4,INTERRUPT,1,15,'*',NO_CLEAR,&ivrd) != IVR_SUCCESS){ ...handle error; }
|
