IVR (Interactive Voice Response) is an automated answering machine that guides callers to their Destination by providing a number of choices and waiting for a caller to make a selection through DTMF tones by utilizing the device keypad.
The first page on the IVR section displays a list of all existing IVRs on the system. Please note that the '#' option can be used for transferring an IVR to a different Destination.
Displays an IVR name
(E.g. Office)
(Display)
Displays the IVR number
(E.g. 105)
(Display)
Click this button to edit the existing IVR configuration.
(Button)
Click this button to delete an existing IVR.
NOTE: Upon clicking the button, the following warning message will appear: "Are you sure you want to remove XYZ*?"*. If users click the Cancel button, then the action will be abandoned. On the contrary, if OK is clicked, the selected IVR will be deleted.
For more information, please refer to the screenshot.
(Button)
Once a user clicks the 'Add IVR' button, s(he) will be prompted to a different section where s(he) can configure all the details for a certain IVR.
NOTE: Please make sure to create a greeting sound before adding a new IVR.
Users can create one by dialing '*301' from the UAD/phone or by uploading a custom sound file from a computer through the 'System' -> 'Sounds' section.
Enter a unique IVR name (identifier)
(E.g. This name will be displayed once IVRs are accessed.)
([a-z][0-9])
NOTE: This is a required field.
Enter a unique IVR number
(E.g. This number should be be dialed in order to access this specific IVR.)
([0-9])
NOTE: This is a required field.
Select a greeting sound file
(E.g. Once a user enters the IVR number, a greeting with instructions is played, for instance "Welcome. For Sales Press 1...". )
(Select box)
NOTE: This is a required field, and it is highly recommended that the greeting file name starts with 'greeting-***'.
To record a custom greeting message, users can dial '*301' from their Extension. This newly recorded greeting file will have the current date stamp in the title. For example, if the greeting was recorded on 17th of May, 2020, then the title would be as shown -> 'greeting-May-17-2020'.
Select a desired IVR type
(E.g. Standard IVR)
(Select box)
NOTE: Users can choose between four different IVR types:
1. Standard IVR - It is used for a small range of options (0-9).
2. Multi-digit IVR - It is used for a wider range of options (10-9999999999).
3. PIN-based IVR - It is used for dialing local/remote Destinations by providing a pre-set IVR PIN number.
4. Meeting IVR - It is used when a user wants to join the Conference only via audio. A user needs to call a DID that is connected to a Meeting IVR and follow the instructions in order to join a Meeting. The necessary information (Meeting Number and Participant ID) is provided in an e-mail when the Meeting is being created.
NOTE: If the 'Meeting IVR' type is selected, the pre-recorded system's greeting is used and the field is therefore grayed out. Since the user gets asked for the Meeting Number immediately in the Greeting, the “Play Greeting” option will define how many times s(he) can miss saying a Meeting number and get re-prompted.
Set a proper 'Destination Type' for each digit pressed
(E.g. 'Extension')
(Select box)
Users can choose among the following 'Destination Types':
• IVR - After selecting this 'Destination Type', enter the number of the IVR in the 'Destination' field.
• Queue - After selecting this 'Destination Type, enter the number of the Queue in the 'Destination' field.
• Conference - After selecting this 'Destination Type', enter the number of the Conference in the 'Destination' field.
• Extension - After selecting this 'Destination Type', enter the number of the Extension.
• Ring Group - After selecting this 'Destination Type, enter the number of the Ring Group in the 'Destination' field.
• Voicemail - After selecting this 'Destination Type', enter the number of the Extension that will point to its Voicemail in the 'Destination' field.
• Directory - After selecting this 'Destination Type, the 'Destination' field will be grayed out, but for further configuration, please refer to the screenshot below.
• Remote Access - After selecting this 'Destination Type', choose between 'Destinations' or 'Voicemail'.
• Fax to E-mail - After selecting this 'Destination Type', enter the number to which the specific fax will be sent as an e-mail.
• Call External Number - After selecting this 'Destination Type', define an external number.
• CRM Routing - After selecting this 'Destination Type', select a specific CRM rule.
Select a specific Destination to which the call would be redirected
(E.g. If 'Extension' is set as a 'Destination Type', then a specific Extension number should be entered in this field.)
(Select box)
EXAMPLE: Once a greeting message (e.g. 'Press 1 for Sales') is played to the caller, s(he) should be redirected to a specific Destination. Users can here set a Destination to which the call would go after the caller presses '1'. So, if John from the Sales department is to be reached after this digit is pressed, then 'Extension' pointing to John should be selected in this field. In case users want to provide additional options to the caller, they can point him/her to another IVR with its separate set of options by selecting 'IVR' here.
Click the 'More Options' button to access additional settings.
(Button)
Once this button is clicked, the window for more options will be opened. If one of the following 'Destination Types' is chosen, users can configure two fields 'Default CallerID' and 'Language': IVR, Conference, Extension, Ring Group, Voicemail, Remote Access, Fax to E-mail, CRM Routing.
Enter a default Caller ID that would override the incoming Caller ID with some custom information
(E.g. It is useful to know from which IVR the call is coming. By setting 'LobbyIVR' here, all calls coming through this IVR will be displayed as 'Lobby IVR' on the phone display. To show the actual phone number along with the name, use '%CALLERID%' with the same text (e.g. 'Lobby IVR %CALLERID%'). This will display 'Lobby IVR 55528790' on the phone display, where '55528790' represents the phone number of the person calling us.)
([a-z][0-9])
NOTE: Users can enter %CALLERID%, %CALLERIDNUM%, and %CALLERIDNAME%.
Set a language used for this 'Destination Type'
(E.g. us)
([a-z])
If Queue is set as a 'Destination Type', after clicking the 'More Options' button, one additional field will appear:
Set the priority in regards to other callers in that Queue, with '1' having the highest priority
(E.g. 5)
([0-9])
If Directory is set as a 'Destination Type', after clicking the 'More Options' button, more additional fields will appear:
If this option is ticked, the system will spell the Extension number after the Extension name.
(Check box)
Select whether to search the directory by first name, last name, or both
(E.g. 'Last Name')
(Select box)
Select the department that will be applied to this directory
(E.g. 'None', 'Accounting', etc.)
(Select box)
Select the exit digit that a user can press to exit the Directory app at any moment
(E.g. '#' or '0')
(Select box)
If Call External Number is set as a 'Destination Type', after clicking the 'More Options' button, users will only have to set the 'Default CallerID' option.
Clicking 'Show Advanced Options' will result in the additional configuration being displayed.
Rather than deleting the IVR, users can set its status to 'Off'. This will make the IVR inactive and all calls will be transferred to 'Operator Extension'.
(E.g. 'Lobby IVR' has this option set to 'Off'. John dials this IVR number, e.g. 1003, but instead of receiving further IVR instructions, his call is transferred to 'Operator Extension'.)
(Options button)
Choose the Operator Extension to which all calls will be redirected if the 'IVR Status' is set to 'Off'
(E.g. 'Lobby IVR' has the 'Status' set to 'Off'. John dials this IVR but instead of receiving further IVR instructions, his call is transferred to the Extension Number provided here.)
(Select box)
Disable a CallerID but only for PIN-based IVRs
(E.g. 'Yes')
(Options button)
Define the time period in seconds during which an IVR option must be dialed by the user
(E.g. John enters the Sales IVR and hears the instructions. If this field is set to '4', John will have 4 seconds to dial an IVR option.)
([0-9])
Define the delay time in seconds inserted before the IVR greeting message is played
(E.g. The user A enters the IVR and hears this incomplete message: "..me. For sales press 1". If this field is set to '1', there will be a one-second pause before the message is played. Now, when the user A enters the IVR, s(he) will hear "Welcome. For Sales press 1").
([0-9])
NOTE: This solves the 'half-played' file problem. Please keep this value between 1-3.
Define the timeout in seconds during which a new digit must be dialed. This option is used with Multi-digits IVR.
(E.g. John has entered the IVR and wants to dial the '25' option. If '1' is provided in this field, John will have one second to dial number '2', and additional one second to dial number '5'. If the time exceeds, and John hits '5' too late, IVR will assume that John has dialed option '2' instead of '25'.)
([0-9])
Define the number of rings played to the caller before a call is allowed to enter the IVR
(E.g. Rather than just 'falling' into IVR, it is recommended to set the number of ring sounds played to the caller.)
([0-9])
NOTE: This is a required field.
Enter an e-mail address to which all received faxes should be mailed
([a-z][0-9])
NOTE: In order for this option to work, users need to enable 'Fax Detection' in 'Settings' -> 'Protocols' -> the 'SIP' page.
Define the number of times that the greeting message is played to the caller
(E.g. John enters the sales IVR and hears the IVR options. If John does not dial one of the options, the IVR options sound file will be played again, a number of times set in this field, before the call gets transferred to 'Timeout Destination').
(Select box)
NOTE: This is a required field, and if there is no response from the calling party within this time, the call is disconnected.
Select the Extension Number to which the IVR call will be transferred if there is no response from the user during the 'Play Greeting' time period
(E.g. John enters the sales IVR and hears the IVR options. If John does not dial one of the options, the IVR options sound file will be played again, a number of times set in 'Play Greeting' field, before the call gets transferred to the Extension Number provided here.)
(Select box)
Set whether the 'Timeout Destination' is pointing to voicemail or not
(E.g. 'No')
(Options button)
For more information on 'Operation Times', please refer to the following link HOWTO Operation Times
Select the ringing type played back to the calling party before they enter the IVR
(E.g. Rather than just 'falling' into IVR, play the ring sound to the user or music files located under the MOH class.)
(Select box)
NOTE: This is a required field.
Select the MOH/Music on Hold class that is played to users after they make a selection in IVR
(E.g. A MOH class usually contains one or more sound files. To see these files, please navigate to 'System' -> 'MOH'.)
(Select box)
NOTE: This is a required field.
Select a custom ringtone that will be heard when a phone set as a Destination in IVR rings
(E.g. If the caller in IVR presses '3' and a Linksys phone is used for that Destination, it will ring with this ringtone, ie. .)
([a-z][0-9])
Enable dialing local network Extensions or proper/mobile phone numbers
By setting this option to 'Yes', the IVR will be allowed to dial local network Extensions only.
(E.g. If IVR has this option set to 'Yes', only local network Extensions will be accessible from this IVR. Please note that no proper/mobile numbers would be dialed.)
(Option buttons)
Set this option to 'Yes' to send a fax to e-mail to any local Extension which is dialed
(E.g. If John dials an IVR which has this option turned on, he will have the ability to dial the local Extension number to which the system will generate a fax tone. He will then send a fax which will be sent to e-mail of the Extension that he dialed.)
(Option buttons)
NOTE: In PBXware v6, this option is enabled by default.
This option tells the system which Extensions on the local network IVR will be able to be dialed
(E.g. Yes, No, Not Set)
(Option buttons)
Define the starting number in the available range of Extensions
(E.g. 1000)
([0-9])
Define the ending number of the available range of Extensions
(E.g. 2000)
Define any Extension in this field that cannot be called from that IVR even if it is within the set range
(E.g. 1005)
([0-9])
Permissions are used to allow an organization to restrict who is able to enter an IVR. In particular, there are organizations where access to the IVR is only allowed to callers with a valid account number, but it can be used for other similar purposes.
Allow only certain PBXware Extensions to access the IVR
(E.g. If this option is set to 'Yes', only Extension numbers set under the 'Account list' will be allowed to access this IVR.)
(Option buttons)
Define local Extension numbers that will be allowed to enter this IVR
(E.g. If John dials this IVR, but his Extension number is not in the 'Account list', he will be transferred to 'Sales Extension'.)
([0-9])
NOTE: If 'Account Access Only' is set to 'Yes', this is a required field, and local Extension numbers have to separated with a single space in this field.
Define the Extension number to which all calls which are not in the 'Account list' will be redirected after not entering the IVR
(E.g. If John dials this IVR, but his Extension number is not in the 'Account list', he will be transferred to the Extension number provided here.)
([0-9])
NOTE: If 'Account Access Only' is set to 'Yes', this is a required field.
The only difference between 'Standard IVR' and 'Multi-digit IVR' is that the latter accepts two or more digits as a response, for example, numbers between 10-100. Therefore 'Multi-digit IVR' gives more options compared to the 'Standard IVR', but some advanced features are excluded.
Displays the multi-digit IVR access code
(E.g. '12345789')
(Display)
Displays the description of the access code
(E.g. 'Test')
(Display)
Displays the Destination to which the call will be transferred
(E.g. 100)
(Display)
Click this button to edit the existing Access Code configuration.
(Button)
Click this button to delete an existing Access Code.
NOTE: Upon clicking the button, the following warning message will appear: "Are you sure you want to remove XYZ*?"*. If users click the Cancel button, then the action will be abandoned. On the contrary, if OK is clicked, the selected IVR will be deleted.
For more information, please refer to the screenshot.
(Button)
Once a user clicks the 'Add Access Code' button, s(he) will be prompted to a different section where s(he) can configure all the details for a certain IVR.
(Button)
Set the access code to be dialed from the 'Multi-digit IVRs' that will transfer users to PBXware 'Destination' number
(E.g. '99')
([0-9])
NOTE: This is a required field.
Add a short description of this access code and its Destination
(E.g. Once the administrator goes to the 'Multi-digit IVR codes' section, a list of 'Access Codes', their 'Descriptions' and 'Destinations' will be displayed.)
([0-9])
NOTE: This is a required field, and it is viewed by the Administrator only.
Set a PBXware Destination to which a call will be transferred once the 'Access code' is dialed from the Multi-digit IVR
(E.g. John enters the Multi-digit IVR and dials '99', and this 'Destination' is set to lead to the PBXware Extension '1000'. When John dials '99', he will be transferred to the PBXware 'Destination' provided here.)
([0-9])
NOTE: This is a required field.
PIN-based IVR allows dialing local/remote Destinations by providing a pre-set IVR PIN number. PIN-based IVR is commonly used for temporary cases. PIN with an expiration date is useful when there is no need for a permanent IVR option. After a certain ‘Expiry Date’, the same defined PIN will not be valid. PIN-based IVR lacks some advanced features.
Displays the IVR PIN number
(E.g. 1234)
(Display)
Displays the IVR PIN short description
(E.g. Test)
(Display)
Displays the PIN expiry date
(E.g. 23 Feb 2021)
(Display)
Displays the Destination dialed once the IVR PIN is provided
(E.g. 100)
(Display)
TIP: If the item is grayed out and the 'Expiry date' field underlined, that PIN has expired. Please refer to the screenshot.
Click this button to edit the existing PIN configuration.
(Button)
Click this button to delete an existing PIN.
NOTE: Upon clicking the button, the following warning message will appear: "Are you sure you want to remove XYZ*?"*. If users click the Cancel button, then the action will be abandoned. On the contrary, if OK is clicked, the selected IVR will be deleted.
For more information, please refer to the screenshot.
(Button)
Click this button to upload a CSV file with multiple PIN and Destination codes in one step.
To do so, click the 'Browse' button and select a desired .csv file, then click the 'Upload' button to add new PIN codes to PBXware.
(Button)
Sample .csv file | |||
10002 | John Smith Office | 31-08-2021 | 123456789 |
20002 | George Nimara Home | 31-08-2021 | 987654321 |
Click this button to download a CSV template.
(Button)
Once a user clicks the 'Add PIN' button, s(he) will be prompted to a different section where s(he) can configure all the details for a certain IVR.
(Button)
Define a unique PIN number
(E.g. John dials local IVR '1003' and is asked to provide a PIN. He enters PIN '1234' and PBXware then dials the number provided under the 'Destination' field.)
([0-9])
NOTE: This is a required field, and the PIN defined here should be provided once requested by IVR.
Enter a short description of the PIN
(E.g. 'John's Mobile Number', or 'Test')
([a-z][0-9])
NOTE: This is a required field, and the description is used for describing the 'Destination' number.
Define a date to which this PIN can be valid
(E.g. If this field is set to expire on '23 Feb 2021', all IVR calls made with this PIN by this date will pass through to the 'Destination' number. Any calls made after the expiration date will not go through.)
(Options button)
NOTE: Even though this is not a required field, users are strongly encouraged to set the expiration date by clicking the 'Calendar' icon and selecting a desired date. The date can also be provided manually in the following form 'dd-mm-yyyy'.
Select a Destination from the drop-down menu that will be dialed once the IVR PIN is provided
(E.g. 100 - M 100)
([0-9])
NOTE: This is a required field.
IVR Tree is a special form of IVR where the creation of a particular IVR is more graphically oriented than it is with regular IVR.
NOTE: IVR Tree is not available in PBXware v5.
Once the 'Create' button is clicked, users will be asked to enter an IVR name and Extension after which the IVR will be available for editing.
After a certain IVR Tree is created, users can select the specific one from the drop-down menu and click the 'Edit' button as shown in the screenshot to edit the further configuration.
Enter the IVR name
(E.g. Test)
([0-9][a-z])
Enter the IVR Extension number
(E.g. 255)
([0-9])
Define the number of rings before the caller enters the IVR
(E.g. 4)
([0-9])
Define the time period in seconds during which an IVR option must be dialed by the user
(E.g. 4)
([0-9])
NOTE: This option is useful when 'Local dialing' is turned on.
Define the timeout in seconds during which a new digit must be dialed
(E.g. 1)
([0-9])
NOTE: This option is useful when 'Local dialing' is turned on.
Define the timeout in seconds during which the selection must be made
(E.g. 3)
([0-9])
If ticked, this option disables direct access to this IVR which means that the IVR in question can be accessed only through another IVR.
(Check box)
Enables the user to dial local Extensions while inside the IVR.
(Check box)
The other two options in the menu are as follows:
NOTE: The 'Save' button has to be clicked after every change in order for it to be applied.
The main part of the IVR Tree are 'Action' and 'Selection'. they can be added by clicking the 'plus' icon and deleted by clicking the 'Delete' button right next to it. Actions are items that are going to be executed when the user enters IVR. They will get executed in the order in which they are placed on the list.
When 'Action' is selected in the 'IVR Tree' section, users can add various 'Actions':
•Dial Local Extension - This option lets users dial the local Extension set in the 'Extension' field, when the action is executed.
•Dial Remote Extension - This option lets users dial the remote Extension set in the Destination field.
•Dial Voicemail - This option enables users to leave a voicemail for the given Extension.
•Check Voicemail - This option enables users to check the voicemail of the Extension which is provided with the keypad.
•Go to context - This option allows users to go to the given 'Context' and 'Extension', for example 'Context' -> 'time', 'Extension' -> '222'.
•Start Recording - This option allows users to start recording the conversation. Please note that if the 'Silent recording' option is ticked, the user will not hear the announcement that his/her call is being recorded.
•Set Queue Priority - This option allows users to set Queue priority, so if a user is about to enter a certain Queue, s(he) will enter it with a given priority.
•Set Language- This option allows users to set the language to be used in IVR. Please use the two-letter notation like 'us'.
•Play Sound - This option allows users to play a sound file which the user can select and also set a language for it if the sound file was provided in several languages. Also, users can set to accept DTMF tones or keypad buttons during play, so they can dial local Extensions if that option is enabled in the IVR properties.
•Change CallerID - This option allows users to change users' CallerID.
•Wait - This option allows users to wait the given number of seconds before the IVR continues to execute actions.
•Busy signal - This option allows users to play the busy sound to the caller.
•Hangup - This option allows users to hang up the current call.
When 'Selection' is chosen in the 'IVR Tree' section, users can add various 'Actions'. These can range from 'Selection 0' to 'Selection *'. Users can also choose between 'Invalid Selection' or 'Timeout Selection'.
Once users select their desired selection from 'Selection 0' to 'Selection *', the Destination Types that can be added are as follows:
•Go to IVR Tree
•Local Destination
•Remote destination
•Voicemail
•Ring Group
•Queue
•IVR
Select the PBXware Destination applicable to the type selected first
(E.g. If 'Go to IVR Tree' is selected as a 'Destination', then select the number of the applicable 'IVR Tree'.)
(Select box)
In other case, if the Selection is 'Invalid Selection' or 'Timeout Selection', the configuration will be different. Please refer to the screenshots.
Invalid Selection
Select the sound file
Timeout Selection
Select one of the Destination types listed above
(E.g. 'Go to IVR Tree')
(Select box)
Select the PBXware Destination applicable to the type selected first
(E.g. If 'Go to IVR Tree' is selected as a 'Destination', then select the number of the applicable 'IVR Tree'.)
(Select box)
Once the IVR Tree is created, when users click the 'IVR Tree Graph' in the sidebar menu, they will get a graphical representation of their IVR Tree as shown in the screenshot below.
1. When calling a PIN-based IVR, it is asking to enter a ten-digit phone number.
Navigate to 'IVR' → 'General' → 'Disable CallerID (PIN-based IVR only)' → set to 'YES'.
2. Displaying IVR Options – Option that allows the user to view which IVR option was selected by callers on the phone display.
Navigate to 'IVR' → navigate to the setting wheel → edit 'Default CallerID' → add “OptionNumber %CALLERID%”
3.IVR Statistics
NOTE: IVR Statistics are only available for the Contact Center Edition.
Navigate to 'Home' → 'IVR' → 'Statistics'
Statistics in v5 PBXware | ||
IVR Calls | Standard IVR | Inbound |
IVR Calls per Original Caller ID | Standard IVR | Inbound |
IVR Calls per Option | All | Inbound |
--- | --- | --- |
Statistics in v6 PBXware | ||
IVR Calls | Standard IVR | Inbound |
IVR Calls per Original Caller ID | Standard IVR | Inbound |
IVR Calls per Option | All | Inbound |
IVR Calls per DID | All | Inbound |
To view statistics for a specific IVR:
Select the IVR from the 'IVRs' drop-down menu
Select a 'Report Type' from the Reports table
4.Greetings
Record a greeting or any other sound file that can be used in PBXware
(E.g. Dial '*301' and after the beep sound, say the message to be recorded.)
([0-9])
(E.g. Dial '*303xxx' where 'xxx' is an IVR, Ring Group, Queue, etc. When dialed, a user is prompted to record a new greeting. Once accepted, the greeting is set as the Destination's new greeting.)
(E.g. Dial '*304xxx' where 'xxx' is an IVR, Ring Group, Queue, etc. When dialed, a user is prompted to record a new greeting. Once accepted, the greeting is set as the Destination's new greeting.
The previous greeting, if it existed, will be deleted accordingly.)
Recording an IVR greeting sound file
To record an IVR greeting sound file:
1. Navigate to 'Settings: Access Codes' and make sure that '*301' is set under 'Greetings'
2. Dial '*301' from the Extension and speak into the microphone after the tone
NOTE: In PBXware versions up to 3.1, the message is recorded as soon as a user drops the phone. However, if a user has PBXware 3.8 and later, s(he) needs to press '#' to finish recording,
After this, the voice menu will be played with three available options:
1 - Accept the message
2 - Listen to the message
3 - Re-record the message
NOTE: Please note that only after '1' is pressed, the greeting message is recorded.
Note the following:
1. The recorded sound file should be saved under 'greeting-$DATE.gsm' name.
2. Edit the IVR and select 'greeting-$DATE.gsm' under the 'Greeting' option.
3. Click 'Save'.
Every caller that calls this IVR will hear the custom greeting message.
Uploading IVR greeting sound file
To upload an IVR greeting sound file:
1. Navigate to 'System' -> 'Sound Files'
2. Click 'Browser'
3. Select a greeting file from the desktop
NOTE: The file must be in the '.gsm' format and a file name must start with 'greeting-' prefix.
4. Click 'Open'
5. Click 'Upload'
6. Select 'g' letter from the alphabet navigation bar
The uploaded sound file should be displayed there.
NOTE: The uploaded sound file is located in '/opt/pbxware/pw/var/lib/asterisk/sounds/' directory.