Slack Connector
The Slack connector imports selected channel history, threads, and supported shared files into a Store. It keeps selected channels current as messages are posted, edited, or deleted.
Once Slack content is imported, workspace members can ask questions by
mentioning the Mixedbread app, sending it a direct message, or running
/mixedbread ask <question>. Answers include links to relevant Slack messages.
Before you beginLink to section
You need:
- a Mixedbread organization with access to Data sources;
- permission to install apps in the Slack workspace; and
- access to the channels you want to import.
OAuth is the recommended installation method. Use manual setup when your organization requires a customer-managed Slack app.
Connect with OAuthLink to section
In the Mixedbread Platform, open Data sources, select Create, and choose Slack.
Enter an optional Store name and review the Store configuration. Leave the
name blank to use slack-{your - workspace}.
Select Connect Slack, choose the workspace, review the requested permissions, and approve the installation.
Back in Mixedbread, select the channels to synchronize. The Slack bot joins selected public channels so it can read new messages.
Saving the selection queues a historical import and enables updates for new messages. Use Sync now to re-check every selected channel.
Connect with a customer-managed Slack appLink to section
Choose Slack, then select Manual setup. Mixedbread generates a deployment-specific Slack app manifest in JSON and YAML.
Open Slack's app creation page, choose From an app manifest, select the workspace, and paste the manifest from Mixedbread.
In the Slack app settings, open Basic Information. Under App Credentials, copy the Signing Secret into Mixedbread.
Open OAuth & Permissions, select Install to Workspace, and approve the installation.
Copy the Bot User OAuth Token, which begins with xoxb-, into
Mixedbread.
Choose an optional Store name and configuration, then select Connect Slack.
Choose the channels to import. Saving the selection starts the historical import.
Keep the generated manifest unchanged. Its event URLs and permissions are configured for the current Mixedbread deployment.
Ask questions in SlackLink to section
After at least one selected channel has finished importing, workspace members can use any of these entry points:
- mention
@Mixedbreadfollowed by a question; - send the Mixedbread app a direct message; or
- run
/mixedbread ask <question>in a channel.
Mixedbread searches the Slack Store, returns a generated answer, and links back to source messages when available. Answers are filtered using the requester's workspace identity and the source content's access controls.
Mixedbread uses generative AI to create answers. Responses may be inaccurate or incomplete. Verify important information using the linked Slack sources.
Manage the connectorLink to section
Open the Slack data source to:
- search, filter, and sort available channels;
- synchronize or exclude channels;
- refresh the channel catalog;
- run a manual sync;
- retry channel or item-level failures; or
- disconnect the workspace.
Excluding a channel stops future imports. Disconnecting removes the saved Slack credentials and stops event delivery. Previously imported Store files remain available until you delete them.
TroubleshootingLink to section
A channel is missingLink to section
Select Refresh channels. If the channel still does not appear, verify that the connected app can access it and that the channel is not archived.
A channel is not receiving updatesLink to section
Confirm that it is marked Syncing and that the Mixedbread app is a channel member. Run Sync now to re-check the channel.
An import completed with warningsLink to section
Open the warning details to view the affected Slack items. Use Retry for recoverable failures.