Slack integration

Overview

The Mode Slack app enables members of your organization to share reports via Slack directly from Mode.

Installation requirements

  • You must be an admin of your Mode organization.
  • You must have an existing Slack workspace of which you are a member.
  • You must be authorized to install apps in that workspace.

Note: Reports can only be shared from Mode to any public channel or any private channel where the organization admin who connected Mode with Slack is a member. We recommend ensuring the admin who adds Mode to Slack is a member of all private channels where you'd like users to be able to share reports from Mode. For example, if Jane connects Slack to your Mode organization, but Jane is not in the private #sales-only channel, then no member of your Mode organization can share reports from Mode to the #sales-only channel.

Setting up

  1. Navigate to the Mode home page and click on your name in the upper left corner of the window.
  2. Click

    Organization Settings

    .
  3. Under the Features section, click

    Slack Application

    .
  4. Click the

    Add to Slack

    button.
  5. The Mode Slack app requires various permissions in order to function. Review these permissions and then click

    Authorize

    to complete the integration.

Now all members of your organization can share reports to your Slack workspace directly from the Mode interface.

Required permissions

Mode's Slack app requires access to your team's Slack workspace in order to facilitate sharing to Slack by members of your Mode organization. When you attempt to authorize Mode's Slack app using your Slack account, Mode will request a number of permissions. Below is a list of these permissions, as well as some additional detail about what Mode's Slack app does with each permission:

Slack permissionoAuth scope(s)Why the Mode Slack App needs this scope
Confirm your identityidentity.basicVerify that the user installing the Mode Slack App is a member of the target Slack workspace.
Access information about your channelschannels:read groups:readGenerate a list of channels (all public channels and any private channels the Slack App installer is a member of) that reports can be shared to.
View and attach previews for some URLs in messageslinks:read links: writeGenerate the custom unfurl, including the preview image, in the message that is posted to Slack when someone shares a report.
Access information about your workspaceteam:readGet the name and id of the Slack workspace for display in the Mode UI and for authenticating API calls.
View email addresses of people in your workspaceidentity.emailVerify that the user installing the Mode Slack App is a member of the target Slack workspace.
Send messages as Modechat:write:botPost Slack messages to your workspace when someone shares a report via Slack in Mode.
Access your workspace's profile informationusers:readGet the name of the installer of the Slack App to display in the Mode UI.

More information about Slack's scopes can be found in Slack's API documentation.

Channel access

Users in your organization can share reports to the following Slack channels:

  • Public channels in your connected Slack workspace
  • Any private channels in your connected Slack workspace where the Slack admin who connected Mode with Slack is a member
  • With Slack Connect, any shared channel created in the Slack workspace connected with Mode

For organizations on Slack’s Enterprise Grid, public & private multi-workspace channels will work as above when made available to the workspace connected with Mode.

Tip

: Mode displays the name of the connected Slack workspace as well as the Slack username of the admin who enabled Slack sharing. Before trying to share a Mode report in a private channel, check that this admin is a member!

Was this article helpful?

decorative particle

Get our weekly data newsletter

Work-related distractions for every data enthusiast.