Introduction #

Experience the power of 3CX Audio Scheduler, a versatile tool that allows you to effortlessly schedule the activation of tones or alarms across your paging system and phones. Enhance your workplace communication with this dynamic solution, designed to effectively notify employees of important events such as break times and shift changes. Seamlessly manage multiple alarms throughout the day, ensuring optimal efficiency and organization.

Customize your auditory experience to suit your unique requirements with 3CX Audio Scheduler. Tailor the tones to match your specific needs, whether it be fire alarms, tornado warnings, or shift change notifications. This exceptional feature ensures that your staff remains alert and informed at all times, promoting a safe and productive environment.

Industries such as schools, airports, and shift-based organizations can particularly benefit from the comprehensive functionality of 3CX Audio Scheduler. Streamline operations and improve coordination within educational institutions, airports, and any environment that operates on shift schedules. Unlock the true potential of your workplace communication with this indispensable solution.

Discover the convenience and reliability of 3CX Audio Scheduler today and elevate your communication system to new heights. Stay one step ahead with the ability to schedule and manage tones and alarms with ease. Take advantage of this invaluable tool and witness the positive impact it can have on your organization.

Why 3CX Audio Scheduler? #

	SCHEDULE NOTIFICATIONS	Effortlessly schedule the playback of tones or alarms on your paging system and phones, enhancing your communication efficiency. Take advantage of seamless scheduling capabilities to ensure timely delivery of custom tones or alarms, optimizing your workplace productivity.
	SIMPLE CONFIGURATION	Leverage our intuitive web portal to actively schedule and manage your paging notifications effortlessly. With user-friendly controls and a straightforward interface, you can efficiently coordinate and customize your notifications to meet your specific needs.
	CUSTOM AUDIO	Effortlessly enhance your communication strategy by uploading personalized audio files for your announcements or notifications. Seamlessly integrate custom audio files to ensure your messages stand out and capture the attention of your audience.
	AUTOMATE NOTIFICATIONS	Enhance organizational efficiency by utilizing robust scheduling capabilities to seamlessly plan and deliver an unlimited number of notifications or messages.

What’s New? #

• Compatible with 3CX Version 15-16
• Greatly simplified administration of scheduled audio
• Upload custom audio files
• Play an unlimited number of different audio files
• You can page to any device type including traditional overhead paging, phones, PA1 (and similar products)
• The improved installer allows you to add, edit, delete, and run scheduled audio directly from the configuration screen

Prerequisites #

Before you begin with the installation steps mentioned in this guide, you need to ensure that your computer meets the minimum requirements mentioned below for installing 3CX Audio Scheduler.

1. 3CX Version V18
2. Microsoft .Net 4.7.2 or above
3.  Internet Information Server (IIS) 7.0 or above
4. VoIPTools Relay Agent (Free)

NOTE:

When installing IIS, be sure to install Basic Authentication, .Net Extensibility, and ASP.Net 4.X

Installation overview #

	DOWNLOAD SOFTWARE	You can order 3CX Audio Scheduler online at https://www.voiptools.com.  Your order confirmation email will include your license key and a link to download the software.
	INSTALL PREREQUISITES	There are a number of prerequisites that must be installed prior to installing the 3CX Audio Scheduler. These prerequisites include Microsoft Internet Information Server (IIS) and Microsoft SQL Server
	INSTALL 3CX AUDIO SCHEDULER	This User Guide contains step-by-step instructions to successfully install 3CX Audio Scheduler. Begin by extracting the installer from the downloaded zip file (Step 1 above), then run the setup program named AudioSchedulerInstaller.exe
	REGISTER YOUR LICENSE KEY	You must register your license key to activate 3CX Audio Scheduler. Your license key is included in your order confirmation email, and can also be found in your order history on our website.

Step By Step Installation Procedure #

The following section guides you through a detailed walk-through of the installation process:

Step 1: Download 3CX Audio Scheduler #

1. Find the software download link in the Order Confirmation Email, or you can find it in your order history on our website and download the 3CX Audio Scheduler application.
2. In the Microsoft Defender SmartScreen, click the More Info option.

3. Click the Run Anyway option to start the installation.

Step 2: Install the prerequisites #

Click on the software installer downloaded in Step 1. The installation wizard will automatically identify the prerequisites and assist you with each installation required to 3CX Audio Scheduler.

1. Click the downloaded installer executable to launch the Prerequisites Setup Wizard and click Next.

2. In the Prerequisites window, install all the required prerequisites identified by the installer, or select/ unselect the applications based on your requirements and click Next to continue.

The installer will download and install the selected applications. It may take several minutes to complete.

3. Click Yes in the Reboot Confirmation message box to reboot your computer.

NOTE:

You must reboot your device to continue with the installation process.

Step 2:  Start the Installation #

1. Click the downloaded installer executable to start the 3CX Audio Scheduler setup wizard.

2. On the Select Installation Folder window, view the installation folder. You cannot change the installation path.

Step 4: Test Relay Settings #

1. In the 3CX Relay Services window, in the Relay Host field, enter the FQDN of your 3CX server.
2. Enter 8801 in the Relay Port field.
3. Enter the public key you took from VoIPTools Relay services in the Public Key text area.

4. Click the Test Relay Settings to confirm ‘3CX Audio Scheduler’ can communicate with the Relay services running on the 3CX server.
5. If the ‘3CX Audio Scheduler’ is successfully able to communicate with the Relay services that run on the 3CX server, a Success message box appears. Click OK. If the test fails, you will not be able to continue until communication with the relay is established.

6. Click Next to continue with the installation.

NOTE:

If the test was unsuccessful: 

1. confirm you have the correct firewall port open (default TCP 8801) on the 3CX server and the firewall protecting the 3CX server.
2. confirm that you have entered the correct IP address / FQDN for the 3CX server.
3. confirm that 3CX Audio Scheduler and the Relay are using the same port and protocol.

Step 6: Installing 3CX Audio Scheduler #

1. In the Ready to Install window, click Install to start the installation of the ‘3CX Audio Scheduler’.

The application installation progresses. This may take several minutes to complete.

2. Check the Launch 3CX Audio Scheduler check box and then click Finish to close the setup wizard and open the configuration screen. You can uncheck the box to close the installer without opening the configuration screen.

Step 7: Register your software #

To ensure the authorization of your license key, it is necessary to complete the registration process. By registering with VoIPTools, you gain access to a range of benefits:

Key Replacement Assistance	In the unfortunate event of a lost license key, registering with VoIPTools enables us to provide you with a replacement key promptly.
Product Updates and Reminders	By registering, you will receive timely notifications from VoIPTools regarding any product updates. Additionally, we will send reminders when your key is nearing its renewal date, ensuring uninterrupted access to our services.

Follow the procedure to register your software,

1. Double-click 3CX Audio Scheduler on your desktop.
2. On the Configuration application, click the License tab.
3. In the License Key field, enter the valid license key.
4. Enter appropriate details in all the other fields of the page Click Register to complete your registration.

NOTE:

The license key permits you to install the software on one computer. This is not free software.

Configuration Screen #

The Audio Scheduler configuration screen enables you to perform various activities as mentioned below:

• Register Software
• configure the paging dial code
• Upload/ delete/ play audio files
• Create/ edit/ delete/ run the scheduled tasks

Settings tab #

The Settings screen enables you to set paging code that causes the phone to auto-answer, set path for ‘Audio Folder’ to store audio files, upload a new or delete an existing audio file from the 3CX Audio Scheduler.

3CX Dial Code #

When dialing a phone, using the paging dial code will cause the phone to auto-answer (provided it is provisioned correctly).

• Under 3CX Dial Code section, in the Paging Dial Code field enter valid dial code that is already configured in the 3CX Management console.

NOTE:

Dial codes are configured in the 3CX Management console at:

• V12.5: Settings ? Advanced ? Dial Codes ? Paging
• V14: Settings ? PBX ? Dial Codes ? Paging

Audio Files #

Follow the procedure to set Path for Audio Files,

1.  On the Audio Scheduler configuration screen and in the Settings tab, beside Audio Folder field, click Browse button.
2. Select an appropriate folder to store the audio files you uploaded into the 3CX Audio Scheduler.

Follow the procedure to Upload an Audio File,

1. In the Settings tab, click the Upload button.
2. Browse for the audio file you want to upload.

Follow the procedure to Delete Audio File,

1. In the Settings tab, under Audio Files section, from the ‘Audio File’ list box, select the audio file that you want to delete.
2. Click Delete button.

Schedule tab #

The Schedule tab enables you to create new scheduled tasks and delete, edit or run existing scheduled tasks.

Create New Scheduled Task #

1. In the Schedule tab and in the toolbar, click the New button.

2. In the New Task dialog box, and in the Task Name field, enter the name for the scheduled task.

3. From the Dial Ext dropdown, select the extension for which you want to schedule the new scheduled task.
4. From the Audio File dropdown, select the audio file that you want to play for this new scheduled task.
5. If you want the phone to auto-answer the call, check the Use Dial Code box.
6. Click Create Task.
7. In the Properties dialogue box fill the necessary fields and click OK.

Edit Scheduled Task #

1. In the Schedule tab and from the Scheduled Tasks list box, select the scheduled task that you want to edit.
2. From the toolbar, click the Edit button. The Schedule Task Properties dialog box appears.

General Tab #

The General tab allows you to set the general properties of a task.

1. In the Schedule Task Properties dialog box and in the Description text field, enter the description for the task.

2. Click Change User or Group button to select a different user or group account for a task to run under.
3. Select the Run only when user is logged on option if you want to run the task interactively.
4. Select the Run whether user is logged on or not option if you want to run the task when the user is logged in or not. When you select this option, you may be prompted to enter account credentials while saving the task, regardless of whether you checked the Do not store password box or not.
5. Check Do not store password box if you do not want the Task Scheduler to store the credentials on the local computer.
6. Check Run with highest privileges to allow the scheduler to run the task that is registered using the Administrators group.
7. From the Configure for dropdown select the operating system that the task is configured for.
8. Check the Hidden box if you want to hide the task.

Triggers tab #

When you create a task, you can specify the conditions that will trigger the task.

From the Triggers tab, you can view the list of existing triggers for the schedule task, add new trigger and, edit or delete existing trigger. You can access trigger settings from the New Trigger or Edit Trigger dialog box.

Follow the steps to Add a new Trigger,

1. In the Triggers tab, click New… button. New Trigger dialog box appears.

2. In the New Trigger dialog box, from the Begin the task dialog box, select appropriate trigger. For more details, see Trigger Type table below.

3. From the Settings section, select appropriate trigger setting and set the time at which you want the trigger to occur. For more details, see Trigger Settings table below.

4. In the Advanced settings section,
   • Check Delay task for up to (random delay) box to specify an amount of time to delay the task from running, after the task is triggered.
   • Check Repeat task every box to set a repetition time interval for the task. The task will run, wait for the time interval specified, and then run again. This cycle will continue until the duration time is met
   • Check Stop task if it runs longer than: box to stop long running tasks by setting a time limit on the amount of time the task is allowed to run (execute the action).
   • Check Expire box to set a date and time for the trigger to expire.
   • Check Enabled box to enable the task so that it can run.
5. Click OK to save your changes.

Follow the steps to Edit an Existing Trigger,

1. In the Triggers tab, click Edit button. Edit Trigger dialog box appears.
2. Edit all the required details. (See Trigger Type and Trigger Settings tables for more details)
3. Click OK to save your settings.

Follow the steps to Delete Existing Trigger

1. In the Triggers tab, from the trigger list box, select the trigger that you want to delete.
2. Click Delete to delete the trigger.

Actions tab #

A task action is the work that is performed when the task has run. A task can have single action or a maximum of 32 actions. Each action contains settings that determine how the action is performed. When you create a task, you must specify the action that will occur when your task starts. You can access ‘Actions’ settings when you create a new or edit an existing action.

Follow the steps to Add a New Action,

1. In the Actions tab, click New… button. New Action dialog box appears.
2. From the Action dropdown,
   • Start a program – This action starts a program on the script.
     1. In the Program/ script text box, enter the name of the program or script that you want to start.
     2. In the Add arguments (optional) text box, enter the arguments if the program or script takes command line arguments.
     3. In the Start in (optional) text box, you can specify the working directory for the command line that executes the program or script. This should be either the path to the program or script file or the path to the files that are used by the executable file.

• • Display a message – This action shows a message box with a specified message and title
    1. In the Title field, enter the title for the message.
    2. In the Message field, enter the message that you want to send.
    3. Click OK.

Follow the steps to Edit an Action,

1. In the Actions tab, click Edit button. Edit Action dialog box appears.
2. Edit all the required details. (See New Action dialog box for more details)
3. Click OK.

Follow the steps to Delete an Action,

1. In the Actions tab, from the actions list box, select the action that you want to delete.
2. Click Delete.

Conditions tab #

Conditions control whether a task along with the trigger should run. The task will not run if any condition specified is not true.

Conditions are of 3 categories:

Idle	Idle conditions are set to run the task only when the computer is in an idle state for a specific amount of time when a task trigger is activated.
Power	Power conditions are set to run the task only when the computer runs on AC power (not battery power) when the task trigger is activated. If this condition is set, the task will stop if the computer switches to battery power.
Network	Network conditions are set to run the task only if a specified named network connection is available or if any network connection is available when the task’s trigger is activated. If your task action requires a network connection to execute, then set this condition.

Idle Conditions #

1. Check Start the task only if the computer is idle for: box if you want the task scheduler to start the task if the computer is idle for the specified time. You can select the time from the dropdown.
2. From the Wait for idle for dropdown, select the amount of time to wait (after the task is triggered) for the computer to enter an idle state.
3. Check Stop if the computer ceases to be idle check box so that when a task is running while the computer is in idle state, it will stop running when the computer ceases to be idle.
4. Check Restart if the idle state resumes box so that the task that stopped when the computer was in idle state will start running again the next time the computer enters an idle state.

Power Conditions #

1. Check Start the task only if the computer is on AC power box if you want to run the task only when the computer runs on AC power.
2. Check Stop if the computer switches to battery power box to stop the task if the computer switches to battery power.
3. Check Wake the computer to run this task box to wake the computer from sleep mode and run the task when the trigger is activated.

Network Conditions #

1. Check Start only if the following network connection is available box if your task action requires a network connection to execute.
2. From the network connection dropdown, select required network connection so that the task will run when the specified network is available.

TABLE 1: Trigger Type-Definitions

Begin the task: dropdown

ON A SCHEDULE	This trigger causes the task to run according to a schedule, and the trigger settings allow you to set the schedule.
AT LOG ON	This trigger causes the task to run when a user logs on to the computer, and the trigger’s settings allow you to specify that the task should be triggered when any user logs on the computer or when a specific user logs on.
AT START UP	This trigger causes the task to run when the computer starts up. The only settings for this trigger are the described in the Advanced Settings section of the New Trigger dialog box.
ON IDLE	This trigger causes the task to run after the computer enters an idle state, and the idle settings can be set from the Conditions tab in the Create Task or Task Properties dialog box.
ON AN EVENT	This trigger causes the task to run when specific event entries are added to an event log.
AT TASK CREATION/ MODIFICATION	This trigger causes a task to run as soon as it is created and when the task is modified. The only settings for this trigger are the advanced settings described in the Advanced Settings section of the New Trigger dialog box.
ON CONNECTION TO USER SESSION	This trigger causes a task to run when a user session is connected to the local computer or from a remote desktop connection.
ON DISCONNECT FROM USER SESSION	This trigger causes a task to run when a user session is disconnected from the local computer or from a remote desktop connection.
ON WORKSTATION LOCK	This trigger causes the task to run when the computer is locked.
ON WORKSTATION UNLOCK	This trigger causes the task to run when the computer is unlocked.

TABLE-2: Trigger Settings-Definitions

Trigger Settings

ONE TIME	Choose date and time to trigger the task.
DAILY	Choose the recurrence interval for the task and the date and time to start the task. An interval of 1 produces a daily schedule and an interval of 2 produces an every other day schedule. The task will start at the specified time each day.
WEEKLY	Choose the recurrence interval for the task, the date and time to start the task, and the days of the week in which to start the task. An interval of 1 produces a weekly schedule and an interval of 2 produces an every other week schedule. The task will start at the specified time on each of the specified days.
MONTHLY	Choose the months in which you want to start the task and the weeks of the month and the days of the week for each month in which you want to start the task. You can also specify that you want to start a task on the last day of each month.

Settings tab #

Settings tab enables you to specify additional settings that affect the behavior of the task. The task settings specify how a task should run, stop or delete.

1. Check “Allow task to be run on demand” box if you want to run the task at any time on demand.
2. Check “Run task as soon as possible after a scheduled start is missed” box so that the Task Scheduler service will start the task if the task was scheduled to run at a certain time, but for some reason the task was not activated.

NOTE:

The Task Scheduler service will not start the task immediately after the task was missed. By default the service waits for ten minutes before starting the missed task.

3. Check “If the task fails, restart every:” box to restart a task if the last run of the task fails. From the dropdown, specify the time interval that takes place between task restart attempts and the number of times to try to restart the task.
4. Check “Stop the task if it runs longer than:” box to limit the amount of time a task is allowed to run. From the dropdown, select appropriate time.
5. heck “If the task is not scheduled to run again, delete it after:” box so that the task Scheduler service will automatically delete the task after waiting for the specified time period, if it is not scheduled to run again.

6. From the “If the task is already running, then the following rule applies:” dropdown,

Do not start a new instance	The Task Scheduler service will not run the new instance of the task and will not stop the instance that is already running.
Run a new instance in parallel	The Task Scheduler service will run the new instance of the task in parallel with the instance that is already running.
Queue a new instance	The Task Scheduler service will add the new instance of the task to the queue of tasks that the service will run, and the service will not stop the instance of the task that is already running.
Stop the existing instance	The Task Scheduler service will stop the instance of the task that is already running, and run the new instance of the task.

Run Times tab #

Run Times tab allows you to view the scheduled tasks have not yet run and are ready to run once the time arrives.

1. From the From calendar, select appropriate date and time from which you want to see the run times of the scheduled tasks that need to run.
2. From the To calendar, select appropriate date and time before which you want to see the run times of the scheduled tasks that need to run.

History tab #

History tab enables you to view the scheduled task logs that have run. The details include level, date and time, event id, task category, operation, and correlation id. To view further details, select the log and click General and Details tabs

Delete Scheduled Task #

1. In the Schedule tab and from the Scheduled Tasks list box, select the scheduled task that you want to delete.
2. From the toolbar, click Delete button.

Run Scheduled Task #

1. In the Schedule tab and from the Scheduled Tasks list box, select the scheduled task that you want to run.
2. From the toolbar, click Run button. The scheduled task causes it to perform the call.

TTS tab #

The TTS screen enables you to type the text that you want the ‘Audio Scheduler’ to convert into speech. The conversion will be done according to the Culture you select and the voice of the speech will be according to the Voice you select.

Steps:

1. On the 3CX Audio Scheduler configuration screen, in the TTS tab, and in the Text-To-Speech textbox, type the text that you want the ‘Audio Scheduler’ to convert into speech.
2. From the Culture dropdown, select the type of language into which you want to the ‘Audio Scheduler’ to convert the Text-To-Speech.
3. From the Voice dropdown, select the voice so that the ‘Text-To-Speech’ audio file will play according to the voice you have selected.
4. In the File Name field, enter the name for the ‘Text-To-Speech’ audio file.
5. Click Save to save the ‘Text-To-Speech’ audio file.
6. Confirmation message box appears. Click OK.
7. Click Play to play the ‘Text-To-Speech’ audio file.

NOTE:

Every time you play the ‘Text-To-Speech’ audio file, you should save it or else the file will be deleted from the database.

Need Support? #

Visit our website to access our online manuals and get quick answers to most of your inquiries. If you prefer direct contact, we offer various support channels, including phone, email, live chat, and our helpful VoIPTools forums.