- 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.
- Navigate to the Mode home page and click on your name in the upper left corner of the window.
- Under the Features section, click
- Click the
Add to Slackbutton.
- The Mode Slack app requires various permissions in order to function. Review these permissions and then click
Authorizeto complete the integration.
Now all members of your organization can share reports to your Slack workspace directly from the Mode interface.
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 permission||oAuth scope(s)||Why the Mode Slack App needs this scope|
|Confirm your identity||Verify that the user installing the Mode Slack App is a member of the target Slack workspace.|
|Access information about your channels||Generate 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 messages||Generate the custom unfurl, including the preview image, in the message that is posted to Slack when someone shares a report.|
|Access information about your workspace||Get 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 workspace||Verify that the user installing the Mode Slack App is a member of the target Slack workspace.|
|Send messages as Mode||Post Slack messages to your workspace when someone shares a report via Slack in Mode.|
|Access your workspace's profile information||Get 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.
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!