---
title: "Slack"
url: "/help/buuk/slack"
updated: "2026-10-25T16:58:19.085Z"
---
# Slack

Slack is where support clarifications happen before they reach a desk, so Buuk works both on demand and on a schedule there.

## Mention Buuk to draft an article

Type a mention in any channel where the Buuk app is installed and describe what the docs should say. Buuk reads the message, files a draft suggestion with the channel and author recorded as the source, and posts an ephemeral confirmation to you that nothing was published.

The same works from the **More actions** menu: run the message shortcut on any channel message — a whole thread answer, a workaround someone wrote — and it becomes a draft suggestion too.

## Import channel threads

Besides mentions, the connection imports recent messages from your chosen channels into the same draft pipeline. After connecting, use **Manage** on the Slack card to pick the channels to import — leave every channel unchecked and Buuk imports from every channel it can reach.

## Step by step

Open **Integrations** and pick **Slack**, then press **Connect**. OAuth is the normal path:

1. **Make sure you can install apps in the workspace**
   Installing a Slack app needs the **Install Apps** permission. Workspace owners and admins have it by default; on some workspaces members have it too. Without it Slack routes your connect attempt as a request to the admins instead of connecting.
   
   Connect against the workspace where support conversations actually happen — check the workspace name shown at the top of the consent screen.

2. **Approve the consent screen**
   Slack lists what the app will get, grouped by permission: message history in channels it is a member of, the channel and member lists, `@buuk` mentions, and permission to reply to you. Press **Allow**.

3. **Invite the bot where threads happen (optional)**
   The app reads history only in channels it is a member of. For public channels open the channel details menu and run `/invite @Buuk`. Private channels work the same after an invite.

4. **Back in Buuk: choose import channels**
   Use **Manage** on the card and pick which channels to import — for example just
   
   and
   
   . Leave everything unchecked to import from every channel the app can reach.

## Then use it from Slack

- Mention **@Buuk** in an installed channel with what the article should say — Buuk files a draft suggestion and posts an ephemeral confirmation to you.
- Highlight a message, open **More actions**, and run the Buuk shortcut to turn a thread answer or workaround into a draft.

## Connecting with a token instead

**The card shows a bot-token field**

That happens when this deployment has no Slack app configured. Create one on api.slack.com:

1. Sign in to `api.slack.com`, open **Your apps → Create New App → From scratch**, name it Buuk, and pick the workspace to develop it against.
2. Open **OAuth & Permissions** and add these **Bot Token Scopes**: channels:history, groups:history, im:history, channels:read, users:read, groups:read, app_mentions:read and chat:write.
3. Press **Install to Workspace** at the top of the same page and approve it.
4. Copy the Bot User OAuth Token (starts with `xoxb-`, shown once) and paste it into the Buuk token field, then press Connect with token.

> [!NOTE]
> Starter holds two integration slots — GitHub plus one support source. Slack occupies a support slot; Growth connects the full catalog.

## Troubleshooting

**A mention does nothing**

The Buuk app must be subscribed to the `app_mention` event, and the mention has to happen in a Slack workspace actually linked to your Buuk workspace. Reinstall or recheck the event subscription if mentions worked before.

**Imported threads pour in from everywhere**

Open **Manage** on the Slack card and narrow the channel list to the ones support actually uses.

## Related

- Other conversational sources: [Community and social channels](./community-channels).
- Where mention drafts land: [Suggested updates](./suggested-updates).
- Desk-based sources: [More support desks](./support-desks).
- The full catalog: [Integrations overview](./connect-integrations).