Slack Integration

InsightFinder follows a holistic view of incident prediction and management. This needs InsightFinder to enable teams to start or continue a conversation for an incident from the InsightFinder app itself. To make it easy, InsightFinder has integrated Slack into the UI for IT teams to have conversations. This documentation is a walk through of how to configure Slack in InsightFinder.

Prerequisites

You need to have Slack for your team or company.
You need to have a channel where you want to send the notifications.

Setup

Global Slack setting in IF
(No need if using InsightFinder SaaS solution)

1. Login to InsightFinder as “admin”.
2. Go to “Settings”->“Global system settings”. Click on “Slack”.
3. A pop up will open where you can click on “Add”.
4. Another popup will open where you need to provide the following information
  1. Service Provider Name – You can choose any name
  2. Client ID – As described in the steps for Slack setup later in this document
  3. Client Secret – As described in the steps for Slack setup later in this document
    (See Figure 1)
  4. Click on “Verify”. Once verification is successfol, you shoold be good to move to the next step to set up Slack for your application.

Set up Slack for your application in IF
1. You shoold login with your user id for this setup.
2. Go to “Settings”->“External service settings”. Click on “Slack”.
3. A pop with all the available system names will be displayed.
  (See Figure 2)
4. Click on “Go to Slack” against the system name that you want to configure with Slack. It will take you to slack web where you need to login and allow permissions.
  (See Figure 3)
5. Once a permissions request is accepted, you will be redirected to the InsightFinder app home page and you shoold be ready to use it.

Using Slack Channel in IF

1. Once Slack integration is done, you can go to any incident in IF, and in the actions, select “Go to Slack channel”.
  (See Figure 4)
2. A pop up will open where you can select an existing channel or start a new channel.
  (See Figure 5)
3. Once you select and click “Ok”, you will be taken to Slack and you can start conversations.

Please note: The user in the Slack channel will be based on the user who has access to the system in InsightFinder which you can set up by going to “Settings”->”System settings”->”General” tab of specific system and adding user.

(See Figure 6)

InsightFinder will try to map either the email address or the first and last name of the user from InsightFinder to add them to the channel by default.

Set up Slack for automatic notifications from IF:

1. In Slack, go to Apps and search for “Incoming Webhooks”, then click on “Add”, then “Add to Slack” to create a webhook in Slack.
  (See Figure 7)
2. On the next page, select a channel where you want to send automatic notifications and click on “Add Incoming Webhook integration”.
  (See Figure 8 and 9)
3. In IF, go to “External service settings” in your user account. Click on “Slack”. Switch to the “Webhook” tab. Click on “Add”. A popup will open up like in the image below.
  (See Figure 10)
  • System name – Select system name for which you want to send automatic notifications to Slack channel.
  • Webhook – Use the url generated in the previous step.
  • Channel name – Type the channel name same as select during webhook generation.
  • Options – Select the type of incidents you want to be notified for.
4. You are all set to receive notification from IF to your slack channel.

Setup Slack for IF integration:

1. Go to https://api.slack.com/apps and click “Create New App” then choose “From scratch.” Give the app a name and choose the workspace you want to use, then hit “Create App”
  (See Figure 11)
2. Under “Add features and functionality” click “Permissions”
  (See Figure 12)
3. Add the following redirect URL: https://your-domain/api/v1/configure-slack (note: must be https), then click “Save URLs”
  (See Figure 13)
4. Add the following Bot Token Scopes: channels:history, channels:manage, channels:read, chat:write, groups:history, groups:read, groups:write, users.profile:read, users:read, users:read.email
  (See Figure 14)
5. Go to the top and click “Install to Workspace”, then click “Allow”
  (See Figure 15)
6. On the left under “Settings,” click “Basic Information”; the client ID and client secret shoold be available under “App Credentials” (may need to scroll down)
  (See Figure 16)

Figures

Click on an image to expand.

Slack Integration