# Connect Slack

This guide walks you through connecting Slack to your Genie environment so your team can interact with the AI assistant directly from Slack channels and direct messages.

***

## Prerequisites

* A Genie account with a running server
* A Slack workspace where you have permission to install apps

***

## Step 1: Open Slack Setup in Genie

Go to your Genie dashboard → **Settings** → **Channels** → **Slack** and click **Set up Slack**.

You will see a 5-step setup summary along with an app manifest. Click **Copy Manifest** to copy the JSON to your clipboard.

![Genie Slack setup page with instructions and manifest](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-9cf46a5a99a009c98ccf0c2050f12a5f06bcf4a3%2Fslack-setup-page.png?alt=media)

***

## Step 2: Create a Slack App from the Manifest

1. Go to [Slack App Settings](https://api.slack.com/apps) and click **Create New App**.

![Slack API Your Apps page](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-b9720d7384e1fe93eacd91f491045fe6dda77612%2Fslack-your-apps.png?alt=media)

2. Select **From an app manifest**.

![Create an app dialog — choose From a manifest](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-cd33bbc5456cbaae76fbfcb9f94d1415433fc413%2Fslack-create-app.png?alt=media)

3. Pick the workspace where you want to install the app and click **Next**.

![Pick a workspace to develop your app](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-05e0a012abab84ae443504394a77a99278fb27e8%2Fslack-pick-workspace.png?alt=media)

4. Paste the manifest JSON you copied from Genie and click **Next**.

![Paste the app manifest JSON](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-404d3512fb16cb2b096f41d5beec601d4e1a5d65%2Fslack-paste-manifest.png?alt=media)

5. Review the app summary — you will see the bot scopes, slash commands, and other settings pre-configured by the manifest. Click **Create**.

![Review summary and create your app](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-9a512f324f8511d77599aeb6645beff8d98750b9%2Fslack-review-create.png?alt=media)

Your app is now created. You will land on the **Basic Information** page.

![App created — Basic Information page](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-d1116caadf6ddd03fe5d69ff98154cfef6b2bef3%2Fslack-app-created.png?alt=media)

***

## Step 3: Verify Socket Mode

In the left sidebar, go to **Socket Mode** and verify that the toggle is **enabled** (green). The manifest should have already enabled this for you.

![Socket Mode enabled](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-65fcaa1de1336a63f8b267ae1f2e30ac29ca018a%2Fslack-socket-mode.png?alt=media)

***

## Step 4: Generate an App-Level Token

1. Go to **Basic Information** and scroll down to the **App-Level Tokens** section. Click **Generate Token and Scopes**.

![App-Level Tokens section](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-560639bc96d3f7e221816eb100ade6bd30d14c34%2Fslack-app-level-tokens.png?alt=media)

2. Name the token (e.g. "genie"), add the `connections:write` scope, and click **Generate**.

![Generate token dialog with connections:write scope](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-36177c994dfad7f92eac5a69fe87466d51a3bb9c%2Fslack-generate-token.png?alt=media)

3. Copy the **App Token** — it starts with `xapp-`. You will need this in a later step.

![Generated app-level token — copy the xapp- token](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-3461e32159129c4f7c6671dfc8573354bcacb949%2Fslack-token-generated.png?alt=media)

***

## Step 5: Install to Workspace and Copy Bot Token

1. In the left sidebar, go to **OAuth & Permissions**. Click **Install to Workspace**.

![OAuth & Permissions — Install to Workspace button](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-6c6526fd4673658e76b5243e42346ff3805925c5%2Fslack-oauth-install.png?alt=media)

2. Review the permissions and click **Allow**.

![Allow the Genie app to access Slack](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-4e9b153c57d39832b38ab172dc47b949321d42d2%2Fslack-allow-permissions.png?alt=media)

3. After installation, copy the **Bot User OAuth Token** — it starts with `xoxb-`.

![Bot User OAuth Token visible after installation](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-0b2e74f6c4adb2780d3930d37a7ac79b24d3a6f4%2Fslack-bot-token.png?alt=media)

***

## Step 6: Save Tokens in Genie

Go back to your Genie settings. Paste both tokens:

* **Bot Token** (`xoxb-...`) in the first field
* **App Token** (`xapp-...`) in the second field

Click **Save & Connect**.

![Tokens pasted in Genie settings](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-078bfacf0761f1d86ac9583e8582e79385bd5003%2Fslack-paste-tokens.png?alt=media)

The status should change to **Connected**.

![Slack connection status showing Connected](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-7aec45639c751ad1f7eb743595cc939edd36c45a%2Fslack-connected.png?alt=media)

***

## Step 7: Pair Your Slack Account

1. Open Slack and send a direct message to the Genie bot (e.g. "Hey!").
2. The bot will respond with a **pairing code** and your Slack user ID.

![Slack DM showing pairing code from Genie bot](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-aec9abd1c4094e9a03fabd4a04ad8d9dace9a690%2Fslack-pairing-code.png?alt=media)

3. Go back to Genie settings. Under **Pending Chat Requests**, you will see the pairing request. Click **Approve**.

![Pending chat request with Approve button in Genie settings](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-4a0857444612b0efe938a96c3be75e564c60dc1f%2Fslack-approve-request.png?alt=media)

***

## Step 8: Start Chatting

After approval, the bot confirms access in Slack. You can now interact with your AI assistant directly from Slack.

![Active conversation with Genie in Slack](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-d2a1c92fc3b2d1c6b022582d3f5f88609cea785d%2Fslack-conversation.png?alt=media)

***

## Configuration Options

Once connected, you can configure how the bot behaves from the Genie settings panel:

* **DM Policy** — `Pairing` requires an approval code before a user can chat via DM
* **Group Policy** — `Allowlist` restricts the bot to pre-approved channels
* **Allowed Channels** — specify which Slack channels the bot can respond in
* **Require Mention** — when enabled, the bot only responds when @mentioned in channels
* **User Allowlist** — restrict access to specific Slack user IDs

***

## Tips

* Each user who wants to chat with the bot must complete the pairing flow individually
* Use **Require Mention** in busy channels to keep noise down
* Set up **Allowed Channels** to control where the bot is active
* The bot uses your full server context — same files, tools, and configurations as the browser
* All interactions consume credits from the Genie account that connected the bot