¶ IVR
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 of the IVR section displays a list of all existing IVRs in the system. Please note that the '#' option can be used for transferring an IVR to a different Destination.
- Name
Displays an IVR name.
(E.g., Office)
(Display)
- Number
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, 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)
¶ Search
- Search
Search by entering data into the field and hitting the 'Enter' key afterward.
([a-z][0-9])
¶ Add/Edit IVR
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 uploading a custom sound file from a computer through the 'System' -> 'Sounds' section.
¶ General
- IVR Name
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.
- IVR Number
Enter a unique IVR number.
(E.g., This number should be dialed to access this specific IVR.)
([0-9])
NOTE: This is a required field.
- Greeting
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. Please note that the greeting file name should start with 'greeting-***'.
Users can dial '*301' to record a custom greeting message from their Extension. This newly registered greeting file will have the current date stamp in the title. For example, if the greeting was recorded on the 17th of May, 2020, the title would be as shown -> 'greeting-May-17-2020'.
- IVR Type
Select the desired IVR type.
(E.g., Standard IVR)
(Select box)
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 broader 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 only when a user wants to join the Conference via audio. A user must call a DID connected to a Meeting IVR and follow the instructions to enter 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.
- Destination Type
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 Queue number 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 extension number.
• 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 Extension number pointing 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.
NOTE: With this option selected, users can dial an Extension by entering the first three letters of the Extension's first or last name if provided. Choosing whether to use the first or last name depends on the selection in the 'Options' menu. Directory's "Response timeout" and "Digit timeout" are inherited from the IVR's 'General Settings'. After entering the Directory from an IVR, for example, the user will have the same amount of time to start typing as set on IVR.
• Remote Access - After selecting this 'Destination Type', choose among 'Agent Login', '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.
- Destination
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 set a Destination to which the call would go after the caller presses '1'. So, if John from the Sales department is reached after this digit is pressed, then 'Extension' pointing to John should be selected in this field. If users want to provide additional options to the caller, they can point them 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 pop-up window with more options will appear. 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.
- Default CallerID
Enter a default Caller ID that would override the incoming Caller ID with some custom information.
(E.g., It is helpful 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 and the name, use '%CALLERID%' with the exact 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%.
- Language
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:
- Queue Priority
Set the priority regarding 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:
- Read Extension Number
If this option is ticked, the system will spell the Extension number after the Extension name.
(Check box)
- Search for Name
Select whether to search the directory by first name, last name, or both.
(E.g., 'Last Name')
(Select box)
- Department Filter
Select the department that will be applied to this directory.
(E.g., 'None', 'Accounting', etc.)
(Select box)
- Exit Digit
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 select the 'Default CallerID' option.
¶ Advanced Options
Clicking 'Show Advanced Options' will display the additional configuration.
- Status
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)
- Operator Extension
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 CallerID (PIN-based IVR only)
Disable a CallerID but only for PIN-based IVRs.
(E.g., 'Yes')
(Options button)
¶ General Settings
- Response Timeout (sec)
Define the period in seconds during which the user must dial an IVR option.
(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])
- RTP Delay (sec)
Define the delay time in seconds inserted before the IVR greeting message is played.
(E.g., 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. When 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.
- Digit Timeout (sec)
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 an 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])
- Rings to Answer
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.
- Fax Email
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.
¶ Greeting Options
- Play Greeting
Define the number of times 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.
- Timeout Destination
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.
(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 the 'Play Greeting' field, before the call gets transferred to the Extension Number provided here.)
(Select box)
- Is Voicemail
Set whether the 'Timeout Destination' is pointing to voicemail or not.
(E.g., 'No')
(Options button)
¶ Operation Times
Calls can be redirected to different PBXware destinations depending on the time they are received.
- Operation Times
Enable Operation Times.
(E.g., Yes, No, Inherit)
(Option buttons)
The 'Inherit' option will allow administrators to put the higher level of 'Operation Times' settings back into effect if deemed necessary.
- Default Destination
Set the PBXware Extension to which all calls are redirected during closed hours.
(E.g., 1000)
([0-9])
- Greeting
Set the greeting sound file that is played to callers during closed times.
(E.g., greeting-***)
(Select box)
Please refer to the following description:
- Open Days
This section allows users to set the working hours during which the IVR redirects calls as specified in the IVR 'Add/Edit' window. If any calls are received during the hours that are not defined here, the calls will be redirected to the 'Custom Destination'. If it does not apply, the call is redirected to 'Default Destination' ('Closed Dates').
- Custom Destinations
This section allows users to redirect all calls received during the set hours to the PBXware Destination.
- Closed dates
This section allows users to set the specific date/s when all calls are redirected to the 'Default Destination'. If the 'Destination' field is set in the 'Closed Dates', the calls will not go to the 'Default Destination' but to this number.
NOTE: If users manually open/close the system using '*401'/'*402' access codes, the time rules defined in 'Operation Times' will not be valid for that day. They will be applied to the system after midnight.
¶ Ringing Type
- Ringing Type
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.
- Music on Hold
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.
- Custom Ringtone
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, i.e.)
([a-z][0-9])
¶ Local Dialing
- Dial Local/Network Destinations
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 will be dialed.)
(Option buttons)
- Fax Dialing
Set this option to 'Yes' to send a fax to e-mail to any local Extension dialed.
(E.g., If John dials an IVR, which has this option turned on, he will be able 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 the e-mail of the Extension that he dialed.)
(Option buttons)
- Enable Range Limit
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)
- Start At
Define the starting number in the available range of Extensions.
(E.g., 1000)
([0-9])
- End At
Define the ending number of the available range of Extensions.
(E.g., 2000)
- Exclude List
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
Permissions allow an organization to restrict who can enter an IVR. In particular, there are organizations where access to the IVR is only permitted to callers with a valid account number, but it can be used for other similar purposes.
- Account Access Only
Allow only specific PBXware Extensions to access the IVR.
(E.g., If this option is set to 'Yes', only Extension numbers assigned under the 'Account list' will be allowed to access this IVR.)
(Option buttons)
- Account List
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 separate with a single space in this field.
- Sales Extension
Define the Extension number to which all calls 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.
¶ Multi-digit IVR codes
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 than the 'Standard IVR', but some advanced features are excluded.
- Access Code
Displays the multi-digit IVR access code.
(E.g., '12345789')
(Display)
- Description
Displays the description of the access code.
(E.g., 'Test')
(Display)
- Destination
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, 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)
¶ Search
- Search
Search by entering data into the field and hitting the 'Enter' key afterward.
([a-z][0-9])
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)
¶ Add/Edit Access Code
- Access Code
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.
- Description
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 is viewed by the Administrator only.
- Destination
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
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 specific ‘Expiry Date’, the same defined PIN will not be valid. PIN-based IVR lacks some advanced features.
- PIN
Displays the IVR PIN number.
(E.g., 1234)
(Display)
- Description
Displays the IVR PIN short description.
(E.g., Test)
(Display)
- Expiry date
Displays the PIN expiry date.
(E.g., the 23rd of February 2021)
(Display)
- Destination
Displays the Destination dialed once the IVR PIN is provided.
(E.g., 100)
(Display)
IVR Expired
TIP: If the item is grayed out and the 'Expiry date' field is 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, 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)
¶ Search
- Search
Search a phrase by entering data into the field and hitting the 'Enter' key afterward.
([a-z][0-9])
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)
¶ Add/Edit PIN
- PIN
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.
- Description
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.
- Expiry Date
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: Although this is not a required field, users are strongly encouraged to set the expiration date by clicking the 'Calendar' icon and selecting the desired date. The date can also be provided manually in the form 'dd-mm-yy.
- Destination
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
IVR Tree is a unique form of IVR where the creation of a particular IVR is more graphically oriented than regular IVR.
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 specific 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.
¶ IVR Tree Actions
- Name
Enter the IVR name.
(E.g., Test)
([0-9][a-z])
- Extension
Enter the IVR Extension number.
(E.g., 255)
([0-9])
- Number of Rings
Define the number of rings before the caller enters the IVR.
(E.g., 4)
([0-9])
- Response Timeout (sec)
Define the time in seconds during which the user must dial an IVR option.
(E.g., 4)
([0-9])
NOTE: This option is useful when 'Local dialing' is turned on.
- Digit Timeout (sec)
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.
- Selection Timeout (sec)
Define the timeout in seconds during which the selection must be made.
(E.g., 3)
([0-9])
- Direct Access
If ticked, this option disables direct access to this IVR, meaning that the IVR in question can be accessed only through another IVR.
(Check box)
- Local dialing
Enables the user to dial local Extensions while inside the IVR.
(Check box)
The other two options in the menu are as follows:
- Delete - Click this button to delete the selected IVR.
- Save - Click this button to save the changes.
NOTE: The 'Save' button has to be clicked after every change for it to be applied.
¶ IVR Tree
The IVR Tree's central parts 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 will 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 Extension's voicemail, 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 conversations. Please note that if the 'Silent recording' option is ticked, the user will not hear the announcement that their call is being recorded.
•Set Queue Priority - This option allows users to set Queue priority, so if a user is about to enter a specific Queue, s(he) will enter it with a given focus.
•Set Language- This option allows users to set the language used in IVR. Please use the two-letter notation like 'us'.
•Play Sound - This option allows users to play a sound file that they can select and also set a language for it if it is 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 their 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 dynamic sound to the caller.
•Hangup - This option allows users to hang up the current call.
Users can add various' Actions' when 'Selection' is chosen in the 'IVR Tree' section. 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
- Destination
Select the PBXware Destination applicable to the type selected first.
(E.g., If 'Go to IVR Tree' is selected as a 'Destination', then choose the number of the applicable 'IVR Tree'.)
(Select box)
In other cases, the configuration will be different if the Selection is 'Invalid Selection' or 'Timeout Selection'. Please refer to the screenshots.
Invalid Selection
- Sound File
Select the sound file.
Timeout Selection
- Sound File
Select one of the Destination types listed above.
(E.g., 'Go to IVR Tree')
(Select box)
- Destination
Select the PBXware Destination applicable to the type selected first.
(E.g., If 'Go to IVR Tree' is selected as a 'Destination', then choose the number of the applicable 'IVR Tree'.)
(Select box)
¶ IVR Tree Graph
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.