- 27 Sep 2024
- 13 Minutes to read
- Print
Creating An Automated Notification
- Updated on 27 Sep 2024
- 13 Minutes to read
- Print
Automated notifications are a way to notify students, instructors and staff when something changes in the Skillable TMS. Most notifications are triggered based on an action taken in the platform, but we also have time triggers for Enrollments, classes and Course Assignments. Using notifications can save you a significant amount of time because you will not need to email people with updates.
Please keep in mind, all Users have the right to opt out of notifications. Even though a notification is sent out by the platform it does not mean that the email will be received by the user.
Preparation for Creating a Notification
Take some time to answer the following questions for each notification you want to create.
What action triggers a notification?
Who is the user completing the action triggering the notification?
Who are the user(s) receiving the notification?
A valid email address to display in the “From” line of the notification
Subject for the email notification
Text for the email you are sending through the notification
Select a Trigger Event
The Trigger Event is an action in the platform causing a notification to be sent out. In most cases this is an action that is taken in the platform, like changing an enrollment status from Enrolled to Cancelled, then when the enrollment is saved it triggers the notification to be sent. A Time Trigger is also available based on when a class begins and ends or when a course assignment is set to expire.
One or more trigger events may be used. When multiple triggers are in place a notification is sent when any of the event triggers are met. After choosing the first trigger the selection list is limited to similar types of notifications based on filters and replacement text options used.
Add a Trigger Event
Select trigger(s) for your automated notification.
Beside Trigger Event select the Add event link, this opens a pick list of triggers.
Select a trigger and select Add to enable the trigger for your notification, it is added in the Trigger Event field.
Select Add event again to add more triggers.
Trigger Filters
After adding a trigger event, different filters can be applied to further define when a notification is sent. Along with the Trigger Event you can add criteria to limit it to specific circumstances. This will also allow you to send different notifications for the same type of trigger event with different criteria enabled.
Trigger filters must be applied with a time trigger, but they are optional for all other trigger types. A time trigger must have the number of hours and the class start or class end options added.
Add Trigger Filters
Select filters you wish to add.
Enable check boxes and choose from pick lists if you wish to change the default filter settings.
Select the User Triggering the Notification and Users Receiving the Notification
The Triggered by and Send to selections are based on the user’s Roles. Trigger by allows you to choose the person completing the action triggering the notification, while Send to indicates who the recipients of the notifications will be. For example, if you would like to have a notification sent when a staff member enrolls a student into a class, then you will choose Triggered by Administrator and Send to User.
Triggered by
For most notifications, two user types are available to select from as the one triggering the action to send the notification, User or Administrator.
For Triggered by:
User refers to a student taking an action in the platform.
Administrator means a user with a role with administrative rights acting in the platform.
One or both can be selected as the one triggering the notification. For example, both a student and an administrator can cancel a student’s enrollment, you may want to set up a notification where it is sent when either have initiated the cancellation.
No user is selected for time-based triggers, they are triggered based on the time selected in the trigger filters.
Add a Triggered by User
Select the user taking the action in the platform that triggers the notification.
Check the box beside User or Administrator based on the criteria above.
Select Users Receiving the Notification
Notification recipients are set by role. For some choices the user role chosen is limited based on their connection to the trigger event. In other cases, everyone in your Organization with the chosen role will receive the notification.
Send to Options:
Explanations of the users available when setting up notifications are listed below.
User
When the user is the recipient, user is not defined by role but is a user that the trigger event and filters apply to. For example, for the Class Enrollment enrolled trigger, all users enrolled in the class receive a notification.
Account Executive
Adding the Account Executive as a recipient will send a notification to a user’s Account Executive when the trigger event and filters applies to that user. The Account Executive is set on the User Profile.
Instructor
Adding Instructor as a recipient sends a notification to the assigned instructor(s) on a class.
Creator
Enabling Creator as a recipient sends a notification to the user who created an item, like a Class, an enrollment, a course assignment, etc.
Editing Delegates
Editing delegates is for Organizations using roles that limit editing of a class to the class creator. Adding Editing delegates on a class allows the creator to assign other users to be able to edit their class. Adding an editing delegate as a recipient on notifications will send a notification to any editing delegate that is added to a class.
Class Custom Users
Class custom users is a custom field option that can be added to a class allowing specific users to be selected based on their role. Enabling Class custom users on your notification allows you to select from Custom Fields that are enabled to use Class custom users. Select the custom fields you want added and notifications are sent to the users added to a class through that field.
Organization Managers
Adding Organization managers allows you to choose roles, like Operations Manager or Automated Notification Recipient 1*, once added all users with that role are sent a notification.
Company Managers
A company manager has access to users based on the Company added on their User profile, management of users in a company is added on the User profile’s Company Management tab. Adding Company managers to your notification allows you to choose roles, like Company Training Manager, once added all users with that role are sent a notification.
*Please note: We have created roles called "Automated Notifications Recipient" and they are numbered 1-5. These roles do not have permissions, they are in place to give you flexibility to assign a user the role to have them receive a notification.
Add Recipients of the Notification
One or multiple recipients can be set for a notification. Follow the instructions below to add recipients in the To field.
Place check marks beside all recipients for the notification.
For Class Custom Users, once checked a section opens below, select the Add Class Custom User Field link opening the Choose Custom Field dialog. Search for and select one or more custom field and click OK to add your selections.
For Organization Managers, once checked a section opens below, Include parent Organizations is selected by default, uncheck this if you do not want users in your parent organizations to receive notifications. Select the Add Organization manager user role link opening the Choose User Role dialog. Search for and select one or more user role and select OK to add your selections.
For Company Managers, once checked a section opens below, select the Add company manager user role link opening the Choose User Role dialog. Search for and select one or more *user role ** and select OK to add your selections.
Email Header Information and Calendar Appointments
Each notification sends an email showing a Subject line and From line. You can also add a CC’d email to receive the notification.
Notification From Line
You need to provide a valid email address to display in the From address, an invalid email address may be read as spam and be rejected by a recipient’s email server. The email will be sent by our servers, but this is the address which is shown to recipients.
Notification CC Line
A carbon copy (CC) email address can be added. When in place a copy of each notification is sent to the recipient.
Notification subject Line
Input a Subject for the email notification. Replacement text fields can be added to the subject.
Calendar Integration
You can add an appointment to registration notifications. The appointment can be sent in two ways, as an appointment or an appointment with an attachment. The email address in the From field acts as the organizer and receives any accept/decline responses for the appointment.
Appointment - an email is sent which once accepted only appears on the recipient’s calendar and the email is removed from their inbox.
Appointment with an attachment - an email with an appointment attachment is sent, the recipient can open the attachment to add the appointment to their calendar and the email remains in their inbox until they choose to remove it.
Add Email Header Information
Follow the instructions to add information in the From, CC, To, Subject fields, and add a calendar appointment.
In the From field input a valid email address.
If needed, add an email address in the CC field to be copied on each notification sent.
Input a title in the Subject field to let the recipient know what the email is about.
If desired, select an option from the Calendar Integration pick list.
Uncheck Enabled until you are ready to test the notification.
Email Content
The Notification text tab is where you input the message you want to send out to recipients.
You can use HTML code to format the email, add links, and images, like a logo. Replacement text fields are located below the text field, these are used to pull data from the platform to add information specific to the recipient. For example, using the replacement text field [StudentFirstName] inputs the recipients first name, as shown in their user profile.
Add Email Content
Follow the steps below to add the text to your notification email.
Open the Notification Text tab.
Input plain text by clicking in the top left corner of the text field.
Use the formatting bars to enhance the text.
Use the Source Code button, < >, to enter HTML code directly.
Be certain to use Replacement text for anything that can change by person or event, like the student’s name, class name, class date and time, etc.
Organization Availability
Organization availability determines which organizations the notification is enable for.
Organization management, set on the user profile, determines which organizations an administrative user can view and manage. If you only have one organization, then check the organization to enable your notification for it. If you manage multiple organizations, check the box beside the organizations that will use the notification.
The organization show in their hierarchies, if a down arrow, v, shows beside an organization name, then the arrow can be clicked to show its child organizations. Checking the box beside a parent organization automatically selects all its child organizations, however, child organizations can be selected individually if the parent organization is unchecked.
Add Organization Availability
Follow the instructions below to enable your notification in your chosen organizations.
Open the Organizations tab, you will see a listing of organizations you manage.
Check the box beside the organization(s) that will use the notification.
Specify Which Courses are Required for the Notification to be Sent
Your notification can be set to apply to all courses or to only apply to specific course(s). It defaults to being used with all courses and that is what is needed in most cases. When you have unique instructions for a course that do not apply to other courses, it can be helpful to be able to send instructions about that Course or courses. You can set up the notification against individual courses or use course groups. Course groups are given a title and a group of courses is added, this feature is for convenience of finding a set of courses in the platform.
It is best to not set a Program. Most organizations only use the Training program. Programs align with permissions and entities, if you set a program that doesn’t apply to your users, courses, subscriptions, or classes, then the notification will not work.
Add Courses to Trigger Notifications
Do the following to add courses as triggers for notifications. Using courses as a trigger limits the notification to only be sent for the selected courses.
Individual courses
Open the Courses tab, Applies to all courses is selected by default, click the radio button beside Specify courses.
Under Individual courses, select the Add Course link, this opens the Choose Course dialog.
Input part of the course name, select Search, and select the desired course.
Continue to search and select all the courses needed, then select OK. The selections are added under the Individual courses heading.
Course Groups
Open the Courses tab, Applies to all courses is selected by default, click the radio button beside Specify courses.
Under Course Groups, click the Add Course Group link, this opens the Choose Course Group dialog.
Input part of the course group name, click Search, and select the desired course group.
Continue to search and select all the course groups needed, then select OK. The selections are added under the Course Groups heading.
Notifications related to a class must have Enable Notifications checked to have them sent. This can be done on a class, in the Basic Information section select Show Advanced Settings and check the box for Enable Notifications. You can also add this as a default setting so that each class created has notifications enabled. To do this, edit to your Organization profile, open the Preferences tab and under Class Settings, check Enable Class Notifications.