IVR's or interactive voice response Input functions are setup under Applications → IVRs → Input. An IVR Input function allows you to gather DTMF data from the caller and process it using a web application. This function is available on ipbx 2.2.1 and higher versions. - All changes made, become effective instantly, so be careful when changing settings on a production system! For an example on how to use this function see also Creating an IVR Input Function.
IVR Input Dialog
Like with an ordinary IVR, you will only able to create an input function if you have a prompt recorded or uploaded.
A descriptive name for your input function.
A unique extension for your input function. This can be used for testing purposes or internal applications. Note that we always recommend, wherever possible, to use the function itself when calling it from other applications.
The prompt to play back when the function is accessed.
The maximum number of input digits. Pressing the # key will complete the input.
The maximum alloted time of no input until the system times out in seconds.
Input validation is performed if an validation URL has been specified.
A validation URL that returns a response to ipbx. The following responses are considered a valid response: any string except for INVALID. The following responses are considered an invalid response: A) the string INVALID or a zero length reply. If for some reason your URL is unreachable or times out, the system will consider the validation to have failed. The default timeout is 2 seconds. Both HTTP and HTTPS are supported. See below for allowed URL Variables.
A prompt that will be played back if a successful validation has been performed. Only applicable with a validation URL.
A prompt that will be played back if the validation has failed. Only applicable with a validation URL.
The maximum number of validation attempts. 1 retry indicates a maximum of two attempts. Only applicable with a validation URL.
Hangup on Failure
Whether to hangup the call after the validation has failed. Only applicable with a validation URL.
This is the URL that will be called after the input has been completed or timed out. Use the %%input%% variable to pass the value to your URL. The default timeout is 2 seconds. Both HTTP and HTTPS are supported. See below for allowed URL Variables.
If set, this indicates where to continue with the call. This function has no effect if hangup on failure has been checked and the input was not successfully validated.
URLs can contain the following variables:
- %%accountcode%% the current ipbx account code
- %%calleridnumber%% the current caller ID number
- %%calleridname%% the current caller ID name
- %%calleridani%% the current caller ID ANI
- %%uniqueid%% the unique ID of the call as stored in the CDR records
- %%channel%% the channel, if available
- %%exten%% the dialed extension
- %%input%% the DTMF digits entered
- %%attempts%% the number of attempts/retries