Knowledge Base
Notification Groups Scheduling / On Call
Notification group - is the entity which has a unique name and contains a number of notification users. Notification groups can also contain a teams integration. These can be defined under Portal Settings -> Teams Channels.
Notification user - A user that can be manually added, imported from your PSA or from MSP Process users. If a schedule is assigned to the user, it will only send notifications to that user during the schedule assigned.
Scheduler - mathematic formula, which has start and end period (not more than one year length) and describes time and date of availabilaty. Has two options:
-
Get periods - returns an array of availability periods ([{from: 2024-01-01T12:00:00, to: 2024-01-01T13:00:00}] to display scheduler on the frontend
-
Is Active Now (receive date and time) - returns true or false
In case of assignment the notification group for notifications - only users which has active scheduler at the moment of event will receive a notification.
Create new notification group
Name your new group and press “Confirm” button. You could select MS Teams connection if needed. MS Teams notifications will be delivered independent on users’s schedulers rules.
Create notification user
After pressing “Edit” on the notification groups list, you will be available to edit group name, adjust MS Teams connection and operate with users
-
New group - Add new user
-
From CRM user - clone user information from PSA (integration connection required)
-
From MSP Process - clone user information from your tenant user
Notification user is independent entity. In case you clone from PSA or System user, after changin phone, email or name on PSA (system) side, notification user remains stable.
For user creation admin should select ways of notifications for this particular user. In case of several ways (phone and email) - user will receive both of them
After creation admin have to setup scheduler rules for this user. There could be several rules for a single user also with intersections. It does not affect on notification process
Create scheduler rules
To describe schedule ruse formula, admin should set name, color, rule range (start, end, but not more than 1 year), rest of configurations are optional. Admin could use “Test” button to see the result of configuration.
Examples
-
User is on call every working day from 9:00AM till 12:00AM
-
set range from and to
-
set working hours
-
unselect weekend days
-
User is on-call 1 day on/2 days off from 12:00PM till 12:00AM (one day oncall, 2 off)
-
set range from and to
-
set working hours
-
set repeat period with start (today, repeat every 3 days - 1works 2 off, period lenght 1 day - working day)
if Repear Every field is equal to 1 - no periods calculated and rule applies for each day
-
User is on call every second week from Monday till Friday from 9:00AM to 4:00PM
-
set range from and to
-
set working hours
-
set repeat period (weeks) with start (Monday of todays week, repeat every 2 weeks - 1works 1 off, period lenght 1 week - working day)
-
disable Sun and Sat
-
User works ewery working day from 9:00AM till 6:00PM with a lunch from 12:00PM till 1:00PM
-
create two different rules - one before lunch and one after
-
User works every third night from 9:00PM till 9:00AM and then have 2 days off
In this case admin has to create two rules (one before midnight and one after) with a repeat period 4 days and perion 1 day
because in fact user has a “gap” of 3 days between periods, but working hours will be 1 night at work - 2 at home.
Scheduling Setup Scheduling / On Call
Under Teams go to Notification Groups as shown below and click on Add New Group.
Give your on call group a name and click Create. Disregard teams integration for now, that will be available in a future update for more automated on call settings.
Click on the edit button next to the Schedule Group you just created.
Add in your users from your CRM/PSA by clicking From CRM users. You can also add users from MSP Process or add them manually using the new group button.
Search and select all users.
Click submit once you've added them all in.
Now go to Teams -> Scheduling and click on the team via the first drop down shown in blue below. Once it is selected click New Schedule.
Below is an example of an on call schedule creation with notes on the screen.
You can choose to repeat every (x) number of weeks or days. Weeks it he most common use. The starting day will be the day the schedule starts so if you want it to start on a monday, be sure to select the first monday date you would like the schedule to start.
Period Lengh I will update the doc on later with an explanation, please use 1 for now.
The rule range can only be set 1 year out for now but we will adjust this in the future.