IVR Applications

IVR Applications
S
Written by Sergiiy
Updated 1 year ago

IVR Applications is the menu that allows configuring IVR applications. Examples of such applications are Calling Card, ANI Callback, Top-up etc. Once created, application can be assigned to one or more DID numbers to be invoked each time the call via that DID number has been received.

For applications that provide language selection there is list of languages to select from. Once the application has been saved there is also section to fine tune application parameters. Detailed description of advanced parameters is provided in the IVR Section:

Basic options

Option Meaning Default
Announce Balance Whether to announce balance upon successful start of application Yes
Normal Calls Are Allowed Only service codes enabled if this option is False True
Disconnect On Failure Whether to drop the Calling Card session upon unsuccessful call attempt. Otherwise the application announces that the failure occurred and offers the user to enter another destination. No
Allow Empty PIN Whether to permit to use the prepaid card accounts with empty PIN True
Preserve Original CLI CLI from the initial call leg will be used to call destination if this option set to true. The calling card username will be used as CLI otherwise. False
Maximum Call Duration Maximum call duration 3600 seconds
Card Number Length Maximum number of digits allowed in a card number 10
Number_Of_Attempts_To_Enter_A_Card Maximum number of attempts to enter card number or PIN code 3
Number Of Wrong Destinations Maximum allowed number of unsuccessful call attempts in a row 3
Number Of Timeouts Maximum number of input timeouts 3
Minimum Call Duration Minimum allowed call duration (in seconds). If calculated maximum duration of the call to the requested destination is less than this value then the user will hear the prompt "You have insufficient funds to make this call" 10
Minimum Card Number Length Minimum number of digits allowed in a card number
No Seconds In Duration Do not pronounce seconds while announcing call duration. If the duration is less than 1 minute then this option is ignored. False
No Hours In Duration Do not speak out hours while announcing call duration, only minutes False
Announce Duration Should the duration of the call be announced True
Call Several Destinations Only one call attempt per session is allowed if this option is False True
Outbound SIP Proxy SIP proxy host:port to send the outbound calls to (this option can also be set from the command line) <Environment_IP>:5061
Disconnect Warning Time Say 'Your call will be disconnected in N seconds' before the call disconnect 60
Play Service Plan Minutes Only Play service plan minutes instead of a sum of plan minutes and duration calculated by tariff. This option does not affect actual maximum duration of a call which is a sum of plan minutes and duration calculated by tariff. False
Destination Number Completion Regex Treat the destination number to have been completed and immediately continue with the call when the input matches the given regular expression pattern
Allow Own Accounts Only Usage of Calling Card application in scope of one customer who owns this application. The option is not restricted to Calling Card application only, it is applicable to every IVR application.
(Available from 4.4 only).
False

Option Meaning Default
Enable CLI Registration If the CLI Registration subapplication enabled True
Automatic CLI Registration After calling card has been entered successfully, add the current CLI to the list of trusted CLIs for this calling card. No
Silent Automatic CLI Registration When this option is set to False the user will be prompted if he wishes to register his phone number (new in 1.7.1). True
CLI Registration Menu Extension Number Extension number for the CLI Registration Subapplication
Trusted CLI Authentication CLI mapping is trusted so the PIN is never asked False
Minimum Valid CLI Length Minimum CLI length that is allowed to trigger the Automatic CLI Registration. 6

Password change

Option Meaning Default
Enable Password Change If password change enabled True
Change Password Menu Extension Number Extension number for the Change Password Subapplication

Option Meaning Default
Balance Threshold If the balance of the card is below this threshold then the card number will be asked even if CLI authentication is successful. Please note that this option doesn't disable cards with the balance below threshold, it just forces the PIN to be entered despite the fact the CLI authentication was successful. If you want to disable cards with low balance, please use the Minimum Balance option. (new in 1.8) The value of the Minimum Balanceoption
Minimum Balance If the balance of the card becomes less than the specified value then the card becomes unavailable. The balance can be specified with or without currency. Currency may follow the balance value, ex: '2 USD'. When no currency specified then the balance checked as an absolute value regardless of card's currency (updated in 1.7.1) NULL
Ignore Connect Fee Do not use connect_fee in the duration calculations False
Say_Negative_Balance_As_Zero When option is and if balance is under zero then say "You have zero dollars". Say "You have minus <amount> dollars" if this option disabled. True

Authentication

Option Meaning Default
Use CLI Authentication Only Only accounts with existing CLI mapping are allowed to enter False
CLI As Card Number Try to use CLI as card number first before other methods False
Use VoIP Login As Card Number Look for a calling card in the accounts table by the authname field (normally the username field is used). False

Custom scripts

Option Meaning Default
Custom Script To Check Destination Set the path to the destination check script
Custom Script To Change Announced Duration Script to calculate custom duration to be announced to the user.

Hot Dial & Smart DialPermalink

Option Meaning Default
Enable Direct Hot Dial Single digit destinations dialed from main menu will be treated as hot dial keys if this option is true False
Enable Hot Dial If the Hot Dial sub application enabled True
Hot Dial Edit Menu Extension Extension number to edit the Hot Dial keys
Hot Dial Menu Extension Hot Dial extension number
Limit Hot Keys If true then only keys 1, 2 and 3 can act as the hot dial keys False
Smart Dial Exclusive Mode Should the Smart Dial DID be shared amongst many accounts. False

Top-Up

Option Meaning Default
Enable Top-Up feature If the Topup sub application enabled True
Top-Up Card Length The maximum allowed number of digits of top-up card 10
Top Up Menu Extension Extension number for Top-Up Card Sub application

Black List

Please note that attempts to enter numbers less than 4 digits long are not treated as fraud activity. Only numbers more than 3 digits long trigger black list.

Option Meaning Default
Enable Black List If the blacklist feature turned on. False
Number Of Attempts To Blacklist How many wrong calling card numbers should be entered in a row to blacklist the current CLI. 3

Miscellaneous

Option Meaning Default
Use Word PIN Use word PIN in all phrases regarding card number. So for example phrase "Enter card number" will sound "Enter PIN code"and so on... Please note that this option disables the password check. False
Suppress Pound Phrase Do not say "...followed by the pound key" when asking destination number and PIN False
Enable Custom Greeting If the custom language independent greeting enabled (it is played at the very beginning of the application before the language selection) No
Custom Greeting File Path to the custom language independent greeting audio file (it is played at the very beginning of the application before the language selection)
Early Greeting Prompt ID The Prompt ID to be played before the language selection menu. This prompt cannot be localized. See an example at the end of the page.
Late Greeting Prompt ID The Prompt ID to be played after the language selection menu before balance announcement. This prompt can be localized. See an example at the end of the page.
VoodooVox Source Key The source key for VoodooVox Ads None
Default Calling Card Language Default fall back language en
Fallback_To_Default_Calling_Card_Language Whether to fall back to default language after the maximum number of wrong attempts to select the language have been made. No
Say 'No Card' On Low Balance Say Wrong card number (PIN code) instead of There is no available balan

Did this answer your question?