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_mixed_menu()
int
ivr_mixed_menu(int call, IVRMIXEDPROMPTS *prompts, int numprompts, int
allow_interrupt, int max_digits, int timeout, char termchar, int clear, IVRDIGITS *ivrd)
The
ivr_mixed_menu function plays a series of menu items and retrieves the
digits from the specified call. The menu items can either be text or wave
files.
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
|
|
IVRMIXEDPROMPTS *
|
prompts
|
Array of IVRMIXEDPROMPTS
structures containing the pathnames or text 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
IVRMIXEDPROMPTS prompts[4] = {
{PROMPT_WAVE,"D:\\sounds\\Swelcome.wav"},
{PROMPT_TEXT,"This is a text prompt."},
{PROMPT_WAVE,"D:\\sounds\\SGoodbye.wav"},
{PROMPT_TEXT,"Another Text Prompt"}
};
IVRDIGITS ivrd;
if(ivr_mixed_menu(CALL_PRIMARY,prompts,4,INTERRUPT,1,15,'*',NO_CLEAR,&ivrd) != IVR_SUCCESS){ ...handle error; }
|
