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

---

Step 2: Create a Slack App from the Manifest

1. Go to Slack App Settings and click Create New App.

Slack API Your Apps page

1. Select From an app manifest.

Create an app dialog — choose From a manifest

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

Pick a workspace to develop your app

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

Paste the app manifest JSON

1. 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

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

App created — Basic Information page

---

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

---

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

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

Generate token dialog with connections:write scope

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

Generated app-level token — copy the xapp- token

---

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

1. Review the permissions and click Allow.

Allow the Genie app to access Slack

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

Bot User OAuth Token visible after installation

---

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

The status should change to Connected.

Slack connection status showing Connected

---

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

1. 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

---

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

---

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