|
IVR Software Library
ivr_mixed_messages
Database Systems Corp. (DSC) provides an API subroutine library of IVR Software routines that perform phone functions The following is a description of one of the functions within this library that controls the IVR operation - ivr_mixed_messages.
The routine is from our C programming library, although this same routine has an equivalent for Visual Basic, .NET, C++ and Active-X. DSC provides a separate user guide for each of these languages.
Contact DSC to obtain the most current IVR manuals in your required programming language.
ivr_mixed_messages()
int
ivr_mixed_messages (int call, IVRMIXEDPROMPTS *prompts, int nprompts, int
allow_interrupt)
The
ivr_mixed_messages function plays a series of prompts to the specified
call. The menu items can either be text or wave files.
Parameters
int
|
call
|
Specifies which
call play to:
CALL_PRIMARY: Play to Primary Call
CALL_SECONDARY: Play to Secondary Call
|
IVRMIXEDPROMPTS *
|
prompts
|
Array of IVRMIXEDPROMPTS
structures containing the pathnames or text of the prompts to play.
|
int
|
nprompts
|
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
|
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_messages(CALL_PRIMARY,prompts,4,INTERRUPT) != IVR_SUCCESS){ ...handle error; }
|
|