Slack
By connecting Super with your Slack workspace, you can seamlessly sync important conversations and threads, and even ask questions and get answers without ever leaving Slack.
This guide will walk you through the key aspects of the Super and Slack integration, including how to sync your data and how to use the powerful
@Super bot to get the most out of your connected knowledge.
Connecting Slack & Super
This is the first step to get started. This section covers how to set up the connection between your Super and Slack accounts and handle historical data syncing.
Initial Slack Connection
To begin, you need to connect your Slack workspace with your Super account.
In Super, navigate to the Data Sources page.
Find the Slack option and click Connect your Slack account.
A new window will open. Super is requesting permission to access your Slack workspace. Review the permissions and click Allow.
After clicking Allow, you can close the window and go back to Super. You may need to refresh the page to see your channels appear as available data sources.
When you add new channels in Slack, they will automatically appear in Super under 'Available Sources,' ready for you to select and sync.
How Super Indexes Your Slack Channels
What We Sync
Super only syncs the text messages from the public and private channels you have explicitly selected. We don't sync direct messages, messages from other bots (like Slack workflows), or external files. This ensures your private conversations remain secure while focusing on human-generated content.
Refresh Rate
New messages appear in Super within a few seconds after they are posted in Slack.
How We Handle Threads
Super indexes conversations at the thread level. When a new message is sent in a channel, it starts a new conversation thread which is treated as its own sync in the background. Any replies within that same thread are then added to the original sync.
To optimize the data for searching, our system combines all of a channel’s daily threads and activity into a single, continuously updating sync. This is why you will only see one item of 'content' syncing for each channel per day, even if it contains many different conversations.
Example Scenario
Imagine your team's
#marketing channel on a Tuesday.9:00 AM: You post a message asking for feedback on a new ad campaign. A few teammates reply in a thread.
1:00 PM: Another teammate starts a new, separate conversation about an upcoming webinar.
3:30 PM: A quick question is asked in the channel, and a new thread begins to address it.
Even though three different conversations happened in the channel, Super will show only one item of 'content' syncing for
#marketing on that Tuesday. This single sync is continuously updated in the background as all of those conversations progress. By the end of the day, that one item of 'content' will contain all three conversations, ready for you to search.Metadata
To make your search results more useful, Super automatically pulls and indexes key information from your conversations. This includes:
- The channel name
- The authors of the messages
- The date of the conversation
This information allows you to quickly filter and find the exact conversation you're looking for.
Syncing Historical Data
A Note on Recent Slack API Changes
On May 29, 2025, Slack implemented significant API changes that affect third-party applications, including Super's Slack integration. These changes introduced new and more restrictive rate limits on the
conversations.history and conversations.replies API methods.Impact on Super:
New Installations (after May 29, 2025): The new rate limits immediately apply. This makes it challenging to fully index historical conversations and threads when you first connect.
Existing Installations (before September 2, 2025): Your current connection will continue to work normally until September 2, 2025. On this date, all existing non-Marketplace apps will also be subject to the new, stricter rate limits.
Because Super is not currently listed on the Slack Marketplace, these changes impact our ability to sync a channel's full history. We are actively working on a long-term solution to meet Slack's new requirements and will keep you informed of our progress.
Due to these changes, while your connection will continue to sync new messages as they appear, it may not be able to fully index older, historical conversations. To ensure all your historical data is indexed, you can manually export data from Slack and import it into Super.
Every time you add a new channel to sync in Super, you'll need to follow this same export-and-import process to ensure its full history is indexed. Super's automatic syncing will handle all new messages from that point forward.
Step 1: Export Your Data from Slack
The first step is to export your data from your Slack workspace. You will need to be on a Slack plan that allows for data exports.
Follow the instructions provided by Slack to download a zip file of your workspace's conversations and files.
Step 2: Import Your Exported Data into Super
Once you have your Slack export file, you can import it into Super.
In Super, navigate to the Data Sources page.
Find the Slack connection and click on Settings.
You will see a button to Import past messages. Click on this.
Drag and drop the zip file you downloaded from Slack and follow the prompts to begin the import.
Once your zip file is successfully uploaded, you’ll see a confirmation message on screen.
Super will now begin indexing the historical conversations and threads from your file. This process may take some time depending on the size of your data. Once complete, your historical Slack content will be fully searchable within Super.
Remember: Every time you add a new channel to sync in Super, you'll need to follow this same export-and-import process to ensure its full history is indexed. Super's automatic syncing will handle all new messages from that point forward.
Using the @Super Bot in Slack
Once your Slack workspace is connected to Super, you can bring Super's powerful search and Q&A features directly into your daily workflow using the
@Super bot.The
@Super bot allows you to ask questions and get instant answers without leaving Slack, drawing from all the data you have synced with Super.
Where to Find the Super App
Because the Super app is not listed on the Slack Marketplace, it will appear under your Slack workspace's Installed Apps list once you've connected it from the Super interface. You can access this list from your workspace settings or under the "Apps" section in the Slack native interface.
How to Use the Bot
DM @Super to chat
You can have a private conversation with the
@Super bot by sending it a direct message. It will use all the data sources you have synced in Super to answer your questions.In a DM, you don't even need to tag
@Super after the first message; you can simply continue the conversation like you're chatting to a teammate.
Invite @Super to channels
You can invite the
@Super bot to any public or private channel. You can either type /invite @Super in the channel, or if you tag the bot without it being in the channel, you'll be prompted to "Add them".To ask a question, you must tag
@Super and then ask anything. The bot can answer questions based on the conversations within that specific channel or pull from any of the general data sources you have synced with Super. The answer will appear as a thread reply. To follow up with the bot, you'll need to tag @Super again in the thread each time.
Managing Your Questions and Sources
- You can open any question you ask in the Super app to continue your work there.
- You can also delete your question from the Slack thread.
- In both DMs and channels,
@Superwill always provide citations to its sources, including links to open them, regardless of the tool they came from (e.g., Google Drive, Confluence, etc.).
Removing the Bot from a Channel
To remove the
@Super bot from a channel, simply type the slash command /remove @Super in the message box and press Enter.
Account Linking and Permissions
The Super app for Slack is designed to respect individual user permissions. This means that when you ask a question, the bot will only generate an answer based on the content that you have access to.
Automatic Account Linking
When your Super account is first connected to Slack by an administrator, we match all Super users by their email addresses with the corresponding email addresses in the Slack workspace.
- If a user's email matches, they are automatically "linked" to the Super app and can start using the
@Superbot right away without any additional setup. - If a user's email addresses are different, they will be prompted to authenticate when they first try to use the bot.
Re-linking Your Account
If a user unlinks their account from the Super app directly within the Slack native interface, they can easily re-link by following a simple process:
Send a message to
@Super in the "Messages" section.Alternatively, start a new DM with
@Super or tag @Super in a channel.The bot will then ask them to authenticate, guiding them through the re-linking process.
Access for Non-Super Users
Since the Super app is an installed app on the Slack workspace, anyone in the workspace can try to interact with it. However, if a user tags
@Super and they do not have a corresponding Super account, they will be directed to log in or create an account before they can proceed.