Slack integration

Learn how to setup the Slack integration to analyse customer feedback from Slack channels and to enable digests from Sauce AI –> Slack to automate real-time insights.

In this article:

Connecting to Slack and selecting channels

  1. Go to Settings

  2. Connect to Slack workspace via OAuth 2.0

  3. Once submitted, you should see a listing of slack channels within Sauce AI

  4. Select the channels you want feedback sent to Sauce AI

  5. You can select more than one channel and whether you'd like to import the last 40 messages

  6. Any channels you select will appear in the "Sources panel" within the sidebar (on the left of the screen) at the base.


Setup a private Slack channel 🔓

Follow these steps to have Sauce AI recognise a private Slack channel

  1. In Slack, go to the private channel

  2. Select "channel details" then "integrations"

  3. Select "Add an app"

  4. Search for "Sauce" and click "Add"


Connect a private Slack channel so that feedback is sent to Sauce AI

Please follow the above steps ☝️ to first have Sauce AI recognise a private slack channel.

  1. Go to Slack

  2. Go to the channel and type "/sauce channel"

  3. Within the modal, select "enable"

  4. Go back to Sauce AI and refresh the page

  5. You should now see this channel within the Sources panel in the sidebar

To do this directly from Sauce AI:

  1. Go to settings -> Integrations

  2. Slack -> Settings

  3. Search for the private channel

  4. Click add


Enable a digests on a private Slack channel

Please follow the above steps ☝️ to first have Sauce AI recognise a private slack channel.

  1. Go to Slack

  2. Go to the channel and type "/sauce digest"

    • You may be prompted with "You are about to configure a digest for channel "private-channel-name". Click continue to proceed.

  3. A modal will appear with a search to locate your saved view.

  4. Search for your saved view and click continue to proceed.

  5. Go back to Sauce AI –> to the view you just selected

  6. At the top of the page the Digests button should indicate that it is (On)

To do this directly from Sauce AI:

  1. Go to the saved view you would like a digest setup

  2. In the page header -> Click the Digests button (Which should indicate that it is Off)

  3. Search for the desired Slack channel

  4. Search for the private channel

  5. Click Save


Data management & Security

Sauce operates under the principle of least privilege for data collection.

Topic
Details

Information disclosed

[Optional] Messages from explicitly connected channels

  • Message

  • Time stamp

  • Reporter ID (annoymised)

Purpose of disclosure

To analyse customer feedback from Slack messages and deliver our service of automated, real-time insights

Access management

Sauce only has access to data from Slack channels the bot is invited to by a user. You can disable these at any time from Slack or Sauce.

If you wish to delete data that has been uploaded to Sauce, you can email security@sauce.app.

Authentication

OAuth 2.0

Data Scopes

Scope
Description

channels:history

Allows the app to access messages and events from a channel.

channels:read

Enables the app to view basic information about public channels in a workspace.

chat:write

Grants the ability to send messages as the app to channels.

chat:write.public

Allows the app to send messages to public channels the app is not a member of.

commands

Lets the app receive commands and trigger actions.

files:read

Provides access to files created by the app and files shared in channels the app is a member of.

groups:history

Allows the app to access messages and events from a private group.

groups:read

Enables the app to view basic information about private groups in a workspace.

im:read

Grants access to direct message conversations, allowing the app to read messages from these conversations.

im:write

Allows the app to send direct messages.

mpim:read

Similar to im:read but for multi-party direct message conversations.

users:read

Grants access to basic information about users in a workspace.

users:read.email

Allows the app to access the email addresses of people on the workspace.

For more information on Slack scopes, check out Slack's documentation here.

Last updated