Any Track in ISMS.online can be connected to Slack using the available workflow, the workflow can be enabled once per Track.
The Slack integration is capable of sending notifications of newly created Track Items straight to a Slack Channel.
The Slack message includes hyperlinks to both the Track Item, and Track itself. This is valuable in scenarios where critical incidents or vulnerabilities are reported, as awareness and response time are key.
Examples of use cases for the integration are below:
Incident Management/Vulnerabilities/Corrective actions: Send a notification of a new Incident/Vulnerability/Corrective action to a Slack Channel when it is created.
Custom Tracks: Lots of organisations make a custom track for other types of work, if it sounds like a process where notifications of new items is important, then this integration may be appropriate.
Key terms
Integration: An integration is the ability to connect to a service (e.g. Slack), within any one integration you can have multiple workflows enabled.
Workflow(s): These are the 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 Tracks, you must have:
Permission to Administer the Track you want to integrate.
A Slack user account & access to the Slack channel you want to connect to.
API Key access enabled for the user configuring the integration. This is because the integration needs to create an API key. (Organisation admins can grant this permission by going to the users profile > user settings > grant API )
Setting up the Slack integration
Step 1
Integrations are configured by work area administrators in the Track Settings page.
Step 2
The Integrations panel will show which integrations are available to set up with a Connect button. It also displays which integrations are enabled in this Track and can be edited.
Step 3
Clicking to Connect with Slack will open the first step, which is authenticating your Slack account.
Final Step
Once authenticated and you have the bot in your selected channel, choose which Slack channel to send notifications of new items to. Then close the pop-up.
The ISMS.online Slack integration can send notifications to any public channels that you have access to. To send notifications to a Private Channel, type “/invite @ISMS.online” in the channel.
Close the integration popup, and the Slack integration will be ready to work.
Through following these steps we have set up an integration that will…
Post a message to a Slack Channel every time a new item is added to the Track
Including hyperlinks back to the Track Item and Track itself.
Create a new Item from the Overview tab of the integrated Track to trigger the push notification to Slack!
Troubleshooting/FAQs
| Questions | Answers |
I enabled the Slack integration in ISMS.online but it’s not working? | Please ensure you have followed step 1 of this guide, by adding the ISMS Bot app to your Slack workspace and channel. You can also ensure the bot is in by clicking the Add apps button:   Then clicking Open App |
| How do I add the Slack Bot to my workspace? | See this Slack guide for adding apps to workspaces. |
| I can't see the message in my slack Channel | You can manually invite the ISMS.online bot to your channel. Navigate to the channel you want to have your notifications in (either public or Private ones) and type @isms, to search for the bot and click on it to bring it into the channel:
|
