Connecting Slack App to Metric Insights

This article details how to establish connectivity between a Slack App and a Metric Insights Server.

PREREQUISITE:

Build a Slack App.

1. Disable MS Teams Integration in MI Application

The Metric Insights installation by default has Microsoft ID of azure active directory set to "true". This will need to be disabled before you can connect to Slack.

Access Admin > Distribution > Microsoft Teams > Chatbot tab

Set Microsoft ID of azure active directory to "false".

2. Set Slack Integration in the MI Application

2.1. Access Admin > Distribution > Slack Integration

2.2. Access Slack Integration Editor > Info Tab

To establish connectivity between Slack and Metric Insights, enter the Slack App credentials in the Metric Insights.

Note: Refer to the Obtain Slack App Credentials section of this article to see where Slack App credentials are obtained.

Specify the following:

  1. App Credentials: available on the Slack App configuration page under Settings > Basic Information 
  2. Access Tokens: available on the Slack App configuration page under Features > OAuth & Permissions
  3. Slackbot Share Proxy URL: replace the hostname with your own and leave this part of the URL /slack/image?token=<token> as is
  4. Slack Event Subscription URL: is generated automatically
  5. [Save]
  6. [Sync Chatbot]

2.3. Obtain Slack App Credentials

To get Slack App credentials:

  1. Go to https://api.slack.com/apps
  2. Select the App
  3. Access Basic Information > App Credendials
    • Copy all of the App Credentials
  4. Access Features > OAuth & Permissions
    • Copy OAuth Tokens for Your Workspace

3. Configure Access to the MI Data

  • Channel syncing will display your Slack Workspace Channels in Metric Insights
  • MI User Groups must be linked to Slack Channels to allow data sharing
  • Users who are not members of the respective Groups will be restricted from sharing MI content in Slack Channels

NOTE: Private channels are not synced until the MI application is invited to the private channel on the Slack side.

To learn more about managing access for MI Groups, go to MI Slack App Security.

Access the Channels tab

In the Slack Integration Editor:

  1. Open the Channels tab
  2. Click [Synchronize Channels]
  3. Optionally, define a Default Access Group to make this group's tiles available for sharing across all the synchronized Slack channels
  4. Select a channel to open its Slack Channel Editor where you can view Channel Members and specify which MI Groups will have access to these Channels

4. What's Next?

Connecting MI Chatbot to Metric Insights