--- title: "Slack" slug: "slack" updated: 2025-10-01T19:53:23Z published: 2025-10-01T19:53:23Z --- > ## Documentation Index > Fetch the complete documentation index at: https://help.unleash.so/llms.txt > Use this file to discover all available pages before exploring further. # Slack ## Connection A connection to Slack can be established by an **Unleash Admin** using a Personal OAuth token. Slack supports [permission-based](/v1/docs/shared-links#permissionbased) links. Channel members can only see the resources of the channels they are members of when Slack is set as a data source for the [assistant](/v1/docs/slack-channel-assistant). **There are two ways to connect using a personal OAuth token:** - **Channel Sync (via personal token)**: You can sync channels you have access to (not only channels you are a member of, but also public channels you have access to). This option is available in Discovery and Permission based. However, due to recent changes in the Slack rate limit, syncing may take longer than usual. - **Bot Permissions:** You can sync channels where the Unleash bot is a member. This option is only available in Permissions-based connections. > [!NOTE] > **When configuring channel sync:** > > **By Prefix:** All channels matching the prefix will automatically sync each time the bot is invited. > > **By Channel ID:** Each new channel will require a manually created Slack source to sync. > > **Auto-Sync Permissions:** If you enable auto-sync for public channels, private channels, or both, every channel the bot is invited to (now or in the future) will sync automatically, removing the need to manually connect sources. ## Integrating Slack - Select the [**Discovery**](/v1/docs/shared-links#discovery) or [**Permission-Based**](/v1/docs/shared-links#permissionbased) option. Note: Due to recent changes in the Slack rate limit, syncing may take longer than usual when choosing the Discovery option. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-12 at 17.22.41.png) ### Discovery - Select who has access to the source you are connecting to. - Click**Next**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.14.24.png) - On the connection screen that opens, click **Allow**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screen Shot 2024-08-20 at 13.53.33(1).png) - Select which channels to sync and click **Next**. - **Note:**For example, entering the prefix **'feature'** will match all channels that start with **'feature'**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-12 at 17.23.39.png) ****To locate the Slack Channel ID**** Open the channel, click the channel name, scroll to the bottom of the modal, and click the copy icon next to the channel ID - Review your selection and click**Next**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1755424978053.png) - Select what services to sync and click **Next**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.54.38.png) - Add a time filter and click**Done** or add one later and click **Skip for now**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.55.00.png) ### Permission based - Select who has access to the source you are connecting to. - Click**Next**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.14.24.png) - Select from [**User Permissions**](/v1/docs/slack#user-permissions) or [**Bot Permissions**](/v1/docs/slack#bot-permissions). **Note:**Due to recent changes in the Slack rate limit, syncing may take longer than usual when choosing the User permissions option. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.21.32.png) #### User Permissions - On the connection screen that opens, click **Allow**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screen Shot 2024-08-20 at 13.53.33(1).png) - Select which channels to sync and click **Next**. - **Note:**For example, entering the prefix **'feature'** will match all channels that start with **'feature'**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-12 at 17.23.39.png) ****To locate the Slack Channel ID**** Open the channel, click the channel name, scroll to the bottom of the modal, and click the copy icon next to the channel ID - Select what services to sync and click **Next**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.54.38.png) - Add a time filter and click**Done** or add one later and click **Skip for now**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.55.00.png) #### Bot Permissions - Select the Slack workspace with the Unleash App installed. If there is only one workspace, you will be redirected to the next step. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.26.25.png) - Click **Next**. - Select which channels to sync and click **Next**. - **Note:**For example, entering the prefix **'feature'** will match all channels that start with **'feature'**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.27.20.png) ****To locate the Slack Channel ID**** Open the channel, click the channel name, scroll to the bottom of the modal, and click the copy icon next to the channel ID - Select what services to sync and click **Next**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.54.38.png) - Add a time filter and click**Done** or add one later and click **Skip for now**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-17 at 12.55.00.png) ## Scopes The integration requires the following bot scopes: ```plaintext users:read team:read im:read mpim:read channels:read groups:read ``` The integration requires the following user scopes: ```plaintext files:read users:read.email users.profile:read users:read team:read usergroups:read channels:read groups:read im:read mpim:read channels:history groups:history im:history mpim:history emoji:read ``` ## Supported Resources The integration currently supports the following resources: - Files from colleagues and friends. - Messages from selected channels. ## Filtering and Selection Users can refine the indexing scope of the connected token with options to enable or disable indexing for: - Private Channels - Public Channels - Connections - Channels containing the Unleash Slack Bot - Direct Messages - Multi Direct Messages ****Can archived Slack channels be indexed?**** Yes, you can sync archived channels by entering the channel ID. ## Sync Sync is incremental every 15 minutes for messages and files, other resources every 6 hours. ****Example Questions**** - Where can I fill expense reporting? - What is our escalation policy? - Where can I find our latest product roadmap deck? - What is our security policy? - What are the latest GDPR compliance requirements?