Skip to end of metadata
Go to start of metadata
You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 2
Next »
This group manages the audio playing.
Playback | Description Here you can play an audio file without any interaction between the customer and the application. The audio is unstoppable
Parameters
Exit Arrows This box provides just one arrow out to the next step |
Menu | Description This is probably one of the most important application box available on Cally Square. Here you can build a complex menu using a single box: you can play the message, count the retries on errors (i.e. to avoid dangerous loops) and set a variable with the digit value(s) pressed by the customers
Parameters Label: here you can type a brief description Audio: the name of the audio file you want to play in the current box Response Timeout: the maximum number of seconds the system waits before considering the customer not interacting with the application Max Digit: the maximum number of digits the system waits before moving on to the next step Retries: here you can set the number of loops automatically performed in case of digits not valid or timeout** Variable: the variable you want to fill with the digits pressed by the customer.
** Please consider the menu box gives the top priority to the invalid (i) or timeout (t) branches (if present) before routing the call in a loop. # key can be used as an escape digit or as a valid exit key. If the user doesn't press any keys when the message plays, there is $timeout milliseconds of silence then the command ends.
The user has the opportunity to press a key at any time during the message or the post-message silence. If the user presses a key while the message is playing, the message stops playing. When the first key is pressed a timer starts counting for $timeout milliseconds. Every time the user presses another key the timer is restarted. The command ends when the counter goes to zero or the maximum number of digits is entered, whichever happens first.
Exit Arrows The menu box lets you draw many exit arrows according to the following syntax: X: the box waits for one digit if the MaxDigit parameter is set to one XX: the box waits for exactly N digits (in this example N=2) i: the system takes this path if the entry selected is invalid t: the system takes this path if the box goes in case of timeout -: the system considers this branch when the retry value is reached. Timeout and Invalid branches have higher priority than this branch.
It is possible to add multiple choices for each output branch: use just the comma separated characters. |
Say Digits | Description Here you can play the digits, one by one, in the chosen language (defaults to English)
Parameters Label: here you can type a brief description Digits: the digits you want to be played: they can be both a digit string (i.e. 1234) or a VARIABLE (i.e. {CALLERID(num)}) Escape digits: special character to exit from the playing (i.e. #)
Exit Arrows
This box provides just one arrow out to the next step
|
Say Number | Description Here you can play a number (i.e. 2583 will be played like "two thousand, five hundred and eighty threes")
Parameters Label: here you can type a brief description Number: the number you want to be played: they can be both a digit string (i.e. 1234) or a VARIABLE (i.e. {CALLERID(num)}) Escape digits: special character to exit from the playing (i.e. #)
Exit Arrows
This box provides just one arrow out to the next step |
SayPhonetics | Description Here you can sequentially play each asterisk sound file located in /var/lib/asterisk/sounds/phonetic/character_p.gsm for each character in input using the NATO Phonetic Alphabet.
Parameters Label: here you can type a brief description Text: the text you want to be played: it can be both a digit string (i.e. Joe) or a VARIABLE (i.e. {CALLERID(name)}) Escape digits: special character to exit from the playing (i.e. #)
Exit Arrows
This box provides just one arrow out to the next step |
GetDigits | Description Here you can prompt the user to insert a series of digits: you can play the message, count the retries on errors (i.e. to avoid dangerous loops) and set a variable with the inserted digits value.
Parameters Label: here you can type a brief description Audio: the name of the audio file you want to play in the current box Response Timeout: the maximum number of seconds the system waits before considering the customer not interacting with the application Min Digit: the minimum number of digits the system can accept without considering it an invalid entry Max Digit: the maximum number of digits the system waits before moving on to the next step Retry: here you can set the number of loops automatically performed in case of invalid digits ** Variable: the variable you want to fill with the digits pressed by the customer.
Exit Arrows
The getdigits box lets you draw many exit arrows according to the following syntax: x: is the exit arrow, the path taken when a valid digit is inserted. If not present, on valid entry the call will be dropped. i: the system takes this path if the entry is invalid. If not present it will simply loop the getdigits box until it runs out of retries. -: the system takes this path if it runs out of retries. If not present, when the system runs out of retries will simply drop the call.
|
GetSecretDigits | Description Here you can prompt the user to insert a series of digits and some of them will be hidden, for security reasons. You can play the message, set how many digits you want to hide, count the retries on errors (i.e. to avoid dangerous loops) and set a variable with the inserted digits value.
Parameters Label: here you can type a brief description Audio: the name of the audio file you want to play in the current box Response Timeout: the maximum number of seconds the system waits before considering the customer not interacting with the application Min Digit: the minimum number of digits the system can accept without considering it an invalid entry Max Digit: the maximum number of digits the system waits before moving on to the next step Retry: here you can set the number of loops automatically performed in case of invalid digits ** Hidden Digits Number: the number of digits that the system will hide, for security reasons Hidden Digits Position: you can set if the First or Last #N digits will be hidden Variable: the variable you want to fill with the digits pressed by the customer.
Exit Arrows The getsecretdigits box lets you draw many exit arrows according to the following syntax: x: is the exit arrow, the path taken when a valid digit is inserted. If not present, on valid entry the call will be dropped. i: the system takes this path if the entry is invalid. If not present it will simply loop the getsecretdigits box until it runs out of retries. -: the system takes this path if it runs out of retries. If not present, when the system runs out of retries will simply drop the call.
|
Send DTMF | Description
This block allows interaction with the system by sending DTMF (Dual-Tone Multi-Frequency) tones enabling users to provide input using the telephone keypad during a phone call.
So caller can select for example menu option, enter numbers or provide answers through the use of DTMF tones transmitted during the call.
Parameters DTMF Tones to play: list of digits accepted 0-9, *#, a-d, A-D, w (for a half-second pause), W (for a second pause) , f (for a flash-hook, if the channel supports it).
Max 30 digits Timeout between tones: amount of time to wait between tones. expressed in milliseconds (max 60000) Tone duration: duration of each digit, expressed in millseconds (max 60000)
Exit arrows This box has one exit arrow |