Setting Up Automated Data Notifications

Would you like to be notified when specific actions or triggers happen in your system? With the Thought Industries Notifications feature, you can easily configure when and how you receive automated data notifications that come out of your platform.


Use Case Information

The Thought Industries Notifications feature is actually an Admin Notification feature, used to notify Admins when something happens in the platform, but this feature is so much more than that. You can choose which events you'd like to be notified about, as well as how you'd like the notification to be sent (e.g. email, SFTP, or webhook). Provided for you in this area of the platform, is a large list of triggers that you can use to not only notify your Admins, but to use automated options to send information to various third party systems you may be already using.

Reporting on email activity for these manager notifications is not available.

Notification Triggers

When configured, Admins can be notified about the following triggers happening in their system:

  • Instructor is messaged
  • Comment is created
  • Comment is created in a discussion widget
  • Subscription is canceled (email is not an option for this notification)
  • Learner enrolls in a course
  • Learner enrolls, changes status, earns a certificate, or has their access revoked in a learning path. (email is not an option for this notification)
  • Learner enrolls in a learning path (email is not an option for this notification)
  • Learner enrolls, changes status, earns a certificate, or has their access revoked in a learning path (email is not an option for this notification)
  • Course is purchased
  • Course view report is prepared (email nor Webhook are options for this notification)
  • Product is purchased (email is not an option for this notification)
  • Subscription is purchased or auto-renewed (email is not an option for this notification)
  • Course collection is purchased (email is not an option for this notification)
  • a la carte collection is purchased (email is not an option for this notification)
  • Email is entered by a learner on a course paywall or waitlist
  • Newsletter is signed-up by a learner during checkout (email is not an option for this notification)
  • Course is completed by a learner
  • Assignment is submitted by a learner
  • Learner logs in (email is not an option for this notification)
  • Logged-in learner visits the school (email is not an option for this notification)
  • Learner registers as part of free registration (email is not an option for this notification)
  • Subscription is reactivated (email is not an option for this notification)
  • Course certificate should be issued (email is not an option for this notification)
  • Quiz is taken (email is not an option for this notification)
    • Includes all assessment types, including surveys and reflections.
  • Onboarding survey is submitted (email is not an option for this notification)
  • Redemption or registration code is redeemed
  • Award or credit is granted
  • Learner is inactive for 7 consecutive days (email is not an option for this notification)
  • Learner is inactive for 14 consecutive days (email is not an option for this notification)
  • Learner is inactive for 31 consecutive days (email is not an option for this notification)
  • SCORM attempt record is updated
  • Meeting attendance is updated

Now that you see the actions that can trigger an Admin notification, let's review the ways in which Admins can receive those notifications.

Email Notification

Email notifications are available for certain events only, based on event occurrence.

  1. From your Admin homepage, select Users > Notifications.
  2. In the left menu, select Manager Notifications.
  3. Click the plus icon (+) in the top right corner of the page.
  4. Choose the trigger to be notified about. In the Trigger step, click Search events to find it. The Details panel shows when the trigger fires and which channels it supports. Click Next.
  5. Once your selection is made, you will be prompted to select your preferred format. If email is an option, click Email, then click Next.
  6. Provide valid working email address in the Destination field.
  7. You can also choose to be notified about a specific course, but the default setting applies to all courses within your learning site. To do this, select a course in the Scope field under Advanced options.
  8. Click Send a test.
  9. Once you've received your sample, click Create notification.

As you build the notification, the preview panel on the right shows the selected trigger, a sample of the email, and the merge fields available.

Manager Notifications_Email Option1_AdminView 1.png

 

Manager Notifications_Email Option2_AdminView 1.png
 

SFTP Notification

SFTP is a secure file transfer protocol that uses secure shell encryption to provide a high level of security for sending sensitive data across the web. Once set up, you will begin receiving nightly posts of particular events to a secure client FTP, in either CSV or JSON format. You can then pull data from the SFTP to easily integrate with third party programs.

  1. From your Admin homepage, select Users > Notifications.
  2. In the left menu, select Manager Notifications.
  3. Click the plus icon (+) in the top right corner of the page.
  4. Choose the trigger to be notified about. In the Trigger step, click Search events to find it. The Details panel shows when the trigger fires and which channels it supports. Click Next.
  5. Once your selection is made, you will be prompted to select your preferred format. Click SFTP, then click Next.
  6. Enter the appropriate SFTP address in the Destination field and select a notification format (CSV or JSON) under File Format.
  7. You can also choose to be notified about a specific course, but the default setting applies to all courses within your learning site. To do this, select a course in the Scope field under Advanced options.
  8. Click Send a test.
  9. Once you've received your sample, click Create notification.

As you build the notification, the preview panel on the right shows the selected trigger, a sample of the file that is dropped on your SFTP server, and the merge fields available.

Manager Notifications_SFTP_AdminView.png

 

Tip

For more guidance, check out the SFTP article.

Webhook Notification

Webhooks automatically send data in response to a specific event AND in real time! Whenever that trigger event occurs in the source site, the webhook sees the event, collects the data, and sends it to the URL specified by you in the form of an HTTP request. You can then pull this data using a web service and transform the webhook into a format consumable by various third party systems.

  1. From your Admin homepage, select Users > Notifications.
  2. In the left menu, select Manager Notifications.
  3. Click the plus icon (+) in the top right corner of the page.
  4. Choose the trigger to be notified about - all include the Webhook option. In the Trigger step, click Search events to find it. The Details panel shows when the trigger fires and which channels it supports. Click Next.
  5. Once your selection is made, you will be prompted to select your preferred format. Click Webhook, then click Next.
  6. Enter the appropriate webhook server URL in the Destination field. This is the server that will receive the webhook.
  7. You can also choose to be notified about a specific course but the default setting applies to all courses within your learning site. To do this, select a course in the Scope field under Advanced options.
  8. Click Send a test.
  9. Once you've received your sample, click Create notification.

As you build the notification, the preview panel on the right shows the selected trigger, a sample of the JSON payload sent to your endpoint, and the merge fields available.

Manager Notifications_Webhook Option_AdminView.png

 

Tip

For additional information and tips, check out the article about Webhooks.

Managing Manager Notifications

The Manager Notifications page lists every notification in your instance, grouped by channel (Email, SFTP, and Webhook). Each row shows the trigger name, the scope, and the destination. To find a notification quickly, enter a trigger name in Search by Trigger at the top of the page.

Editing a Notification

  1. From your Admin homepage, select Users > Notifications.
  2. In the left menu, select Manager Notifications.
  3. Click the trigger name of the notification you want to change. The Edit notification page opens.
  4. Make your changes and click Save.

Deleting a Notification

  1. From the Manager Notifications page, click the trigger name of the notification you want to remove.
  2. Click Delete in the bottom left corner.
  3. In the confirmation window, click Delete.
Manager Notification_New Ui Tour_Delete Notification_GIF.gif

Warning

A deleted notification stops being delivered right away, and the deletion cannot be undone.

Was this article helpful?
0 out of 1 found this helpful

More resources

  • Academy

    Go from beginner to expert with hands-on training

  • Community

    Ask questions, swap ideas, and learn from people like you

  • Developer Docs

    Reference guides and code samples for developers