Any Risk map in ISMS.online can be connected to Microsoft Teams using the available workflow, the workflow can be enabled once per Risk map.

Risk Notification triggers:

  • When a new risk is created

  • When a risk score changes (with visual indication if the score increases or decreases)

  • When a risk review is due (including both the review date and any set reminders)

  • When the owner (assignee) of a risk changes



The Teams message includes a summary of the update and a link to view the item. This is valuable in scenarios where severe Risks are identified, as awareness and response time are key.

Examples of use cases for the integration are below:

  • Compliance Teams: Stay on top of new and changing risks without needing to constantly check the platform.

  • Risk Owners: Receive timely reminders for upcoming reviews or changes in risk score, enabling proactive management.

  • Managers: Quickly identify when ownership of a risk changes, ensuring accountability.


Key terms

Integration: An integration is the ability to connect to a service (e.g. Teams), within any one integration you can have multiple workflows enabled.

Workflow(s): These are the pre-built series of steps which sends or receives data between the integrated apps, an integration can have multiple workflows available to use.


Who can use the integration?

To configure any native integration in Risk maps, you must have:

  1. Permission to Administer the Risk map you want to integrate.

  2. A Teams user account & access to the Teams channel you want to connect to.

  3. Permission to add the Microsoft Workflows app to your Teams Channel.


Setting up the Teams integration


Step 1

Add the Workflows app to Microsoft teams.

  1. Click + Apps on the left menu.  

  2. Search for Workflows.

  3. Click Add on the Workflows app, you may need to request permission from your Teams admin.

  4. When Workflows is added, click Open on the Workflows app.



Create a new workflow from a template

  1. On the Home page of the Workflows app, click the Create tab.

  2. Search “Webhook” to find available templates, select Send Webhook alerts to a channel by Microsoft.

  3. Select the Team and Channel you wish to be notified in. Click Next.

  4. Click Copy webhook link , you will need to paste this into IO in a later step.



Step 2

Integrations are configured by work area administrators in the Risk Settings page. 


Step 3

The Integrations panel will show which integrations are available to set up with an Enable button. 


Step 4

Clicking Enable will display the configuration options for the Teams integration. Teams with IO is a webhook integration, no authentication step is required. 


Final Step

  1. Paste the Webhook URL that you copied from Teams in Step 1. 

  2. Customise your workflow by selecting which notifications you would like to send to Teams: 

    1. You can choose to be notified when Risks are created, Risks are updated, and when Risk review reminders become due.

    2. At least one of the 3 workflows must be enabled for the integration to work.

The ISMS.online Teams integration can send notifications to any channels that you have access and permission to see or post to, all you require is a webhook from Microsoft Teams. 



Once at least one workflow is enabled, the Teams integration will be ready to work.

Through following these steps we have set up an integration that will…

  • right arrow Post a message to a Teams Channel every time a new Risk has been raised

  • right arrow Post a message to a Teams Channel every time a Risks score or owner is updated

  • right arrow Post a message to a Teams Channel whenever a Risks review date or review reminder date is due

  • right arrow curving left Including useful information and a link back to the item.  

 

Create a new Risk from the Overview tab of the Risk map, or try updating the owner or score of an existing Risk to trigger the push notification to Teams!

 

Troubleshooting/FAQs


QuestionsAnswers
I set up this integration but I don’t see messages in my Teams channel?

Please ensure you followed all steps correctly, if you are still not seeing results double check the following:


  • The Teams Channel you are checking is the same one you chose when creating the Workflow in Teams.
  • The Webhook URL was pasted correctly.
  • At least one workflow in the Risk map integration for Teams is enabled.
  • An action was taken in ISMS.online that should trigger the notification (e.g. Risk created or assignee updated).

How do I add the Microsoft Workflows app to my Teams channel?See this Teams guide for adding apps to workspaces.
I lost my webhook URL, can I copy it again?

See this Teams guide for adding apps to workspaces for general information.


To copy the webhook URL again:


  1. Go to Workflows in Teams
  2. Click the dot menu on the right of your flow to see Details
  3. In the Details view, you can copy the webhook link again