Enabling KanBo Email Notifications (Azure)

Table of Contents

Only unread notifications are sent via email. Each user can turn them on or off individually and specify the sending interval. Read more about notification settings.

The Email Notifications job requires a Microsoft 365 account with a mailbox.

1. Preparing the email notifications package

Unzip the KanBo.JobHost to the desired location. This location can be a folder named "Email Notifications", for example.

2. Updating the appsettings.json file with your parameters

Copy the connection string from the KanBo appsettings.json file and paste it into the Email Notifications' appsettings.json.

{
      "ConnectionStrings": {
        "KanBo": "Connection String"
      },

Paste the code snippet below after the "load-packages" line and fill in the information in brackets.

{
        "type": "package",
        "name": "auth-aad",
        "client-id": "{Client ID from the Azure Active Directory App Registration}",
        "tenant": "{Tenant ID from the Azure Active Directory App Registration}",
        "thumbprint": "{KanBo Certificate thumprint}"
       },
       {
        "type": "email.graph",
        "upn": "{Email address of the account that will send the notification emails}"
       },
       {
        "type": "job.email-notifications",
        "from": "{Email address of the account that will send the notification emails}",
        "name": "email-notifications",
        "link": "{Your KanBo URL with https://}",
        "title": "KanBo Notifications",
        "template": "template.html",
        "limit": 100
       }
      ]
     },

3. Creating a WebJob on Azure

After updating the config, create a .zip package containing all the files inside the folder. This package will be used to create an Azure WebJob.
To create a WebJob, follow the steps from this article.
Name the job "KanBoEmailNotifications".
Set the cron expressions to: "0 */15 * * * * ".

4. Enabling email notifications on your KanBo account

Open KanBo.
Make sure your email address is entered in your user profile.
On the Sidebar, select your avatar > My Settings > Notifications.
Here, you can set up email notifications. You can choose to disable them or configure them to appear every 15 minutes, 60 minutes, or 24 hours.

Once this option is enabled, you will receive a summary email of all your unread notifications in KanBo (if you receive a new notification but don’t read it in the app). See the example below of an email generated by KanBo.

Recommendation: Set an Outlook retention policy to remove old messages

To avoid clogging up your email notifications mailbox, set a simple rule to clean out messages older than a week.

As an Exchange administrator, go to the Exchange Admin Center > Compliance Management > Retention Tags.
Create a new rule that is applied automatically to a default folder.