Table of Contents

Scheduled Events: Overview & Use Cases

Mitchell Paul-Soumis Updated by Mitchell Paul-Soumis

Read Time: 8 mins

Open Sonar Cast

Scheduled events are automated actions that you can set up to modify an account on a future date. They are useful when an account change needs to happen outside business hours, and can also be used as an alternative to making a note to complete an account change at a later date. The scheduled events are configured individually per account, and once set up, are viewable from the Overview tab of an account.

If you are scheduling a data service change, you must first remove the existing data service on the account — this can be done manually, or by scheduling the data service removal first.

If you do not remove the existing data service before adding a new data service, the scheduled event will fail.

Scheduling service or account status changes can also be prorated, and the dropdown will default to using your instance's default settings. If you'd like to override these settings, expand the dropdown, and select whether to pro-rate the services.

How To Set Up A Scheduled Event

To set up a scheduled event, first, navigate to the account that you wish to set it up for. From the Overview tab of the account screen, you will see a Scheduled Event section on the right-hand side. Any upcoming scheduled events will appear here; otherwise, it will say “no results to display”. In this section, you will also find the Create Scheduled Event button, to set up a new scheduled event.

Clicking Create Scheduled Event will cause a pop-up window to appear, where you will define the event. This window will only have 3 fields displayed initially:

  1. Date & Time: This is where you will select the date and time that you want the scheduled event to occur. You will first select the date, and then the option for the time will appear directly after.
    For more information on how to use the Date/Time picker, please review this linked article.
  2. Event: This is a drop-down list of predefined events, where you will need to select which event you would like to schedule. The available options are: adding a package, adding a service, changing the account status, making a bank account payment, making a credit card payment, price overriding an existing service on the account, removing a package, removing a service, and removing a price override from a service on the account. Depending on the event you choose, additional fields may appear and be required to fill out as well.
    If you are scheduling a payment event (i.e., for a credit card or bank account payment to be made), please note that once the scheduled event triggers, the payment amount will be moved into the account's Available Funds; the payment will not be used to pay down any open invoices.
  3. Description: This field is primarily for providing some information regarding the scheduled event that is set to happen. It can be used to provide details around why the event is happening and if it was requested, by whom, just so that when anyone else is viewing the account they can see any necessary information.

Once you create the scheduled event, it will appear on the right-hand side of the account screen within the Overview tab. From here, clicking on the scheduled event name will open the sidebar, where you can see the main details of the scheduled event, including the account it is happening on, the event, description, date & time of the event, and the event assignee. In this same section, you're also provided with a view of when the events are scheduled to occur — detailed in years, months, days, hours, and minutes — as well as being able to see how long ago these events occurred, using the same metrics. Additionally, hovering over the time counter of the event will provide you with the exact date and time the event is or was scheduled to occur.

When utilizing the "Price override an existing service on the account" scheduled event option, the "Amount" field is where you specify the new total for the service that will be used going forward. For example, if the service is originally $89.99 and you enter 79.99 into the "Amount" field, the new price for the service will now be $79.99.


To view Completed Scheduled Events, click on the Completed tab.

Example #1: Removing A Service

A customer, Charlie Child, calls in and wants to upgrade from the Silver Internet service currently on his account to the Gold Internet service. However, he does not need the upgrade to happen just yet, and instead would like it to take effect on January 9th. To complete this request, we can use scheduled events rather than making a note for ourselves to complete in the future.

First, we will need to create a scheduled event to remove the Silver Internet service from Charlie's account (we will handle adding the new service in Example #2 below).

Since billing runs at 5 minutes past midnight within Sonar, scheduling the event for midnight on January 9th allows it to take effect before billing runs. Now that we have created the event, we will be able to view it and monitor the progress from the right-hand panel of the Account Overview screen.

When scheduling an event that adds or removes a service, the selection will always be tied to the specific ID of the service. For example, if your organization overnight decides to change the SILVER (ID 19) service in your instance and re-add an identically named SILVER (ID 36) service to all accounts. Any scheduled events that were pointed to the original SILVER service will fail, even though the names are the same.

Example #2: Adding A Service

Continuing from the above example, since we have successfully created a scheduled event to remove the Silver Internet service, now we need to create a scheduled event to add the Gold Internet service to Charlie's account.

Since billing runs at 5 minutes past midnight within Sonar, scheduling the event for midnight on January 9th will allow it to take effect before billing runs – this means that on January 9th, Charlie's account will now have 2 actions taking place: 1) the Silver Internet service will be removed, and 2) the Gold Internet service will be added. Now that we have created the event, we will be able to view it, as well as the other scheduled events, from the right-hand side of the Account Overview screen.

When scheduling an event that adds or removes a service, the selection will always be tied to the specific ID of the service. For example, if your organization decides to change the GOLD (ID 18) service in your instance overnight and re-add an identically named GOLD (ID 35) service to all accounts, any scheduled events that were pointed to the original GOLD service will fail, even though the names are the same.

Example #3: Change The Account Status

Victor Moen, a customer, calls in saying that he will be on vacation from March to July, and will therefore not be needing any services during this time. Instead of making a note to set their account to Inactive and also to change the status back to Active once they return, or having them call in again when they are back from their vacation, we can use scheduled events to automatically change Victor's account status.

First, we will need to create an event to change the account status to Inactive on March 1st.

Next, we will need to create an event to change the account status back to Active, for when Victor returns from vacation on July 1st.

Now, both scheduled events have been set up and Victor's account will change to the appropriate status during her vacation as well as return to Active once they're back.

Considerations when changing the account status

The above example for changing the account status works for most situations where customers are away for periods of time. However, if the account's billing parameters have the Day Billing Runs and Invoice Day as different values, this might cause an unexpected result in the case of prorating when the account is reactivated.

For example: We have an ISP that bills on the 20th of the month, but their invoice date is set for the 1st of the month because they bill in advance. If the customer's account was set to an Inactive status for this entire time, but then became active on the 25th of the month, then when billing runs on the 20th that means that billing didn't run on their account yet – therefore proration did not work as expected.

One solution for this would be to use a combination of a vacation status, scheduled events, and the Next Bill Date billing parameter for the account. Creating a vacation status for these customers and having them moved into that status, instead of just being moved into Inactive, helps to let you know that the customer is indeed returning and is not going to remain inactive. Then, using scheduled events, you would be able to set up 2 events to change the account status from Active to Vacation, and then from Vacation back to Active. Lastly, you would only need to change the Next Bill Date on the account's billing configuration. Doing this would make the disconnect process similar to the process below:

  1. Create a Vacation account status (if not already created)
  2. Create a Scheduled Event to change the customer's account status from Active to Vacation
  3. Create a Scheduled Event to change the customer's account status from Vacation to Active
  4. Change the Next Bill Date parameter to a future date beyond the date the customer is scheduled to be reactivated
For further information regarding creating a Vacation status, as well as an alternate method for placing customers into a vacation mode, check out the Accounts In Vacation Mode article.

How did we do?

Notes & Tasks: Best Practices & Use Cases

Serviceable Addresses: Overview and Usage

Contact