> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qontext.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Slack
> Connect Slack with Qontext
## Overview
The Slack connection allows Qontext to read messages and threads from channels in a connected Slack workspace and ingest their text content into your context repository.
Only channels and content that the connected Slack app can access will be ingested into your context repository.
**Supported data types:**
| Object | Description |
| ------------------ | ----------------------------------------------------------- |
| `Channel messages` | Messages posted in channels the app is invited to |
| `Threads` | Replies and thread conversations linked to channel messages |
***
## Setting up the connection
You can connect Slack from your Qontext workspace, authorize access in Slack, then choose how often to sync. The steps below walk you through the full flow.
You can also manage all your credentials, including Slack, from the **Sources** page.
In the [Qontext app](https://app.qontext.ai), open your workspace and go to the **Sources** tab, then click **+ Connect data source**.
Choose **Slack** from the list of available data sources. This starts the Slack connection flow.
You can **reuse existing credentials** (if you've already connected this Slack workspace to Qontext) or **create a new connection**.
If you create a new credential, sign in to Slack when prompted and select the workspace you want to connect. On the Slack consent screen, review the requested permissions and click **Allow**. At this step the Qontext app is added to your Slack workspace so it can read the channels you authorize in the next step.
Select the channels you want Qontext to ingest. Only channels in which the Qontext app is a member can be ingested.
**Public channels** are automatically joined by the Qontext app when you select them.
For **private channels**, the Qontext app must be added as a member first. In Slack, open the channel and type `/invite @Qontext`.
You can add a **time filter** to limit how far back messages are synced. The time filter is only available after a channel has been selected: click **All** at the top next to the selected channel to open the date range option.
Choose how often Qontext should refresh data from Slack (e.g. daily, weekly, monthly). More frequent syncs keep the context repository up to date but use more resources.
Review your choices (workspace, channels, time filter, frequency), then confirm to create the connection. Qontext will start the initial sync shortly after.
***
## Managing permissions
### Slack OAuth scopes
When you connect Slack, you’ll see a consent screen titled **Allow the 'Qontext' app to access Slack**. It lists the permissions (scopes) Qontext needs; they are read-only. You’ll see categories such as:
```text theme={null}
- Content and info about channels & conversations — Messages, files, and other content in public and private channels, direct messages, and group conversations.
- Content and info about your workspace — User lists, channel lists, workspace settings, and other workspace-level metadata.
```
Granting these scopes is required for the connection to work. Qontext only reads data from Slack to ingest it into your context repository; it does not post messages or change anything in your workspace.
***
## Sync latency
The initial sync time depends on how many channels and messages are in scope. Large workspaces with many active channels can take **up to 12 hours** to fully index.
Subsequent syncs process **incremental changes** and typically complete much faster than the initial sync.
***
## FAQ
Any Slack workspace **Admin** or member with permission to install apps can set up the Slack connection. Ensure the account can invite the Qontext app to the channels you want to ingest.
Yes. You can connect multiple Slack workspaces from the **Sources** tab in your Qontext workspace. Add each workspace as a separate data source.
Manual refresh for Slack connections is available via the **Sources** tab. Navigate to the respective Slack connection and open the **Syncs** tab. In the Sync settings, you can select **Resync all data**.
Disconnecting stops further syncs. Content already ingested from Slack remains in your context repository. For data removal, contact [support@qontext.ai](mailto:support@qontext.ai).
Initial sync time varies: small or lightly used workspaces may finish in under an hour; very active workspaces with many channels and messages can take up to 12 hours. Subsequent syncs are incremental and faster.
Reconnect the integration and validate that the Qontext app is still invited to the relevant channels and has the required scopes. If the issue persists, contact [support@qontext.ai](mailto:support@qontext.ai).
Yes. All data is encrypted in transit (TLS) and at rest. Qontext only accesses channels and messages you explicitly authorize via the Slack OAuth flow.
For **private channels**, the Qontext app must be added as a member first. In Slack, open the channel and type `/invite @Qontext`.