Welcome Call IVR application

Last updated by FlySIP Support on November 11, 2019 23:01

Call routing setup

No special routing setup required for the application to work. But special configuration may be created for the SER to prevent recording CDRs for the calls generated by the application.

TODO: write simple ser.cfg example

Configuration options

WARNING! Both Section and Option values MUST be lowercase in the database. They are mixed case here for readability only.

SectionOptionMeaningDefault
FirstRegistrationScanIntervalSecThe time between the attempts to find accounts to make a Welcome Call to30 seconds
FirstRegistrationBackoffIntervalSecFailed attempts to make welcome call will be retried after the interval increasing by this value10 minutes
FirstRegistrationMaxCallIntervalSecThe time between retries to make Welcome Call cannot exceed this value14400 seconds (4 hours)
FirstRegistrationTimeoutMsecThe amount of time the application will wait for answer30000 milliseconds
FirstRegistrationThresholdMsecThe minimum amount of time that the user must keep listening to the message after which Welcome Call is considered successful*3000 milliseconds
FirstRegistrationcliCLI to use while originating Welcome Calls**NULL (means Anonymous)
FirstRegistrationFLYSIProxyThe host:port tuple defining the host where originated calls are to go127.0.0.1:5060
FirstRegistrationMaxAttemptsThe maximum number of failures to make welcome call.20
* If the duration of the message is less than this value then a Welcome Call is considered successful after the whole prompt has been playe.** If the CLI is not NULL then the application finds the account corresponding to CLI and uses it's authentication information to originate a call.

Database usage

The application uses IVR Prompts facility for the Welcome Call message storage.

Setting a custom prompt

It is possible to play a custom greeting to the user from the Welcome Call application. The first step is to create an IVR prompt:

$ /home/ssp/scripts/ivr_prompt_utils -c welcome.sln welcome_prompt 'This is a Welcome Call prompt' New prompt created with i_ivr_prompt = 30

The prompt is ready. Now assign this prompt to the accounts:

UPDATE accounts SET welcome_call_ivr = 30 WHERE ...