Calling card configuration options

The Calling Card IVR application is configured through option rows under Advanced Parameters of the application. This page groups the options you are likely to change, with their default values; the complete list, the CLD override syntax and the script hooks are in the module reference Calling Card IVR application. Options you do not add keep their default.

Card entry and authentication

Option	Default	Meaning
Card Number Length	`20`	Maximum digits of a card number; input stops at this length
Minimum Card Number Length		Minimum digits; shorter input is rejected
Allow Empty PIN	`True`	Accept cards whose account has no PIN
Number Of Attempts To Enter A Card	`3`	Wrong card or PIN entries before hang-up
Number Of Timeouts	`3`	Input timeouts before hang-up
CLI As Card Number	`False`	Try the caller’s number as the card number before asking
Use VoIP Login As Card Number	`False`	Look the card up by VoIP Login instead of Account Name
Use Word PIN	`True`	Say “PIN code” instead of “card number” in every prompt; disables the password check. Set `False` to ask for a card number and a separate PIN
Allow Own Accounts Only	`False`	Accept only cards of the customer that owns the application

Trusted CLI

Option	Default	Meaning
Trusted CLI Authentication	`False`	Recognise callers by a trusted number linked to a card
PIN-less CLI Authentication	`False`	Do not ask for the PIN after a caller was recognised by number
Enable CLI Registration	`True`	Offer the sub-menu where a caller registers their number to the card
Automatic CLI Registration	`False`	Register the caller’s number after the first successful card entry
Silent Automatic CLI Registration	`True`	Register without asking the caller
Minimum Valid CLI Length	`6`	Shorter caller numbers are never registered
Use CLI Authentication Only	`False`	Only registered numbers may use the service
Balance Threshold	the Minimum Balance	Below this balance the PIN is asked even for a trusted CLI

Announcements and calls

Option	Default	Meaning
Announce Balance	`True`	Announce the balance after authentication
Say Negative Balance As Zero	`True`	Announce zero instead of a negative amount
Announce Duration	`True`	Announce how long the caller can talk to the destination
No Seconds In Duration, No Hours In Duration	`False`	Shorten the duration announcement
Play Service Plan Minutes Only	`False`	Announce the plan’s included minutes instead of the full allowance
Ignore Connect Fee	`False`	Leave the connect fee out of the announced duration
Minimum Call Duration	`10`	Below this computed duration the IVR says there are insufficient funds
Maximum Call Duration	`3600`	Longest single call in seconds
Disconnect Warning Time		Seconds before the end of the balance when the warning is played
Call Several Destinations	`True`	Let the caller dial again after a call
Disconnect On Failure	`False`	Hang up after a failed attempt instead of offering another destination
Normal Calls Are Allowed	`True`	With `False` only service codes work, no outside calls
Preserve Original CLI	`False`	Send the caller’s number to the destination instead of the card number
Destination Number Completion Regex		Regular expression that ends number entry without `#`

Minimum balance and black list

Option	Default	Meaning
Minimum Balance		A card below this balance cannot be used; `2 USD` or a plain number
Say ‘No Card’ On Low Balance	`True`	Answer a low-balance card as if the number were wrong
Enable Black List	`False`	Block caller numbers that enter wrong card numbers repeatedly
Number Of Attempts To Blacklist	`3`	Wrong card numbers in a row before the caller number is blocked

Hot dial, smart dial, top-up, password

Option	Default	Meaning
Enable Hot Dial	`True`	Let the caller store numbers behind single keys
Enable Direct Hot Dial	`False`	A single digit from the main menu dials the stored number
Limit Hot Keys	`False`	Only keys `1` to `3` act as hot keys
Hot Dial Menu Extension, Hot Dial Edit Menu Extension		Extension numbers of the hot dial menus
Smart Dial Exclusive Mode	`False`	A smart dial DID serves one account instead of many
Enable Top-Up feature	`True`	Offer the top-up sub-menu. See Set up top-up cards
Top-Up Card Length	`10`	Digits of a top-up card
Top Up Menu Extension		Extension number of the top-up menu
Enable Password Change	`True`	Offer the PIN change sub-menu
Change Password Menu Extension		Extension number of that menu

Greetings and language

Option	Default	Meaning
Enable Custom Greeting, Custom Greeting File	`False`	Play an audio file before the language menu
Early Greeting Prompt ID, Late Greeting Prompt ID		Prompts from the IVR prompt table played before and after the language menu; the late one is per language
Suppress Pound Phrase	`False`	Do not say “followed by the pound key”
Default Calling Card Language	`en`	Language used when the caller does not choose one
Fallback To Default Calling Card Language	`False`	Fall back to the default after too many wrong language choices

Advanced

Outbound SIP Proxy sends the IVR’s outbound calls to a specific host and port; Custom Script To Check Destination and Custom Script To Change Announced Duration call Python scripts on the switch for every call. The application can also be driven by options appended to the dialled CLD, which lets one application serve several differently configured access numbers; the parameter names are listed in the module reference.

Calling Card IVR application: the full reference
Options common to all IVR applications
Configure calling card parameters
Tiny version of the Calling Card application