> For the complete documentation index, see [llms.txt](https://docs.deva.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.deva.me/guides/connect-slack.md).

# 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](/files/mkGor7Twq9z74I5tPubY)

***

## 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](/files/9M5heNEW1n2VdfXvNnMk)

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

![Create an app dialog — choose From a manifest](/files/u8OC3RgETUHWcQiPrpFP)

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

![Pick a workspace to develop your app](/files/sC82Hp9n9sQXA9rZEmj9)

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

![Paste the app manifest JSON](/files/NdBnG6PvvJmvY4Rt9MlN)

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](/files/dCe7hmjGKAFGpQRkdjfi)

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

![App created — Basic Information page](/files/oseUJiQxiSgFHKKQrMgV)

***

## 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](/files/A3ogAJJDC7WSXLPr5e64)

***

## 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](/files/VZ7cKOTXuN0mtlDwBkIE)

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

![Generate token dialog with connections:write scope](/files/xdX0hjjK4U1UUVRI8NlN)

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](/files/RuXFFYmYSYK3icylUkN0)

***

## 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](/files/yI9t0q3M8hJ7nPosIDIj)

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

![Allow the Genie app to access Slack](/files/y7G4Z98ne0eHDXb6mMqm)

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

![Bot User OAuth Token visible after installation](/files/o2jEpg6IVjnmbRWmRVBB)

***

## 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](/files/1UxShBcjGVsZ1mzWqU0N)

The status should change to **Connected**.

![Slack connection status showing Connected](/files/dKNdjCwghPWlsT5pf5m8)

***

## 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](/files/aLHr7gGCzW7zeP2Dr5Ul)

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](/files/ZqbzVBeBa2kyavsZtK8Q)

***

## 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](/files/rOftMOBQV8cTzdsNokq4)

***

## 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