Install and Set Up the Slack App
Copy page
Admin guide — install the Inkeep Slack app, configure agents, and onboard your team.
This guide is for workspace administrators. It walks you through installing the Inkeep Slack app, configuring which agents respond, and getting your team onboarded.
The Slack integration is only available for Inkeep Enterprise.
Prerequisites
- An Inkeep Enterprise account with at least one project and agent configured
- Slack workspace admin access (required to install apps)
Install the app
Open the Work Apps dashboard
Navigate to your Inkeep dashboard and select Work Apps from the sidebar. You'll see the Slack integration card.
Install to Slack
Click Install on the Slack card. This redirects you to Slack's OAuth consent screen where you authorize the Inkeep bot to join your workspace.
The bot requests the following permissions:
- Read messages in channels where it's mentioned
- Join public channels
- Post messages and replies
- Read and write direct messages
- Read and write group direct messages
- Read files shared in conversations
- Access channel and user information
- Register slash commands
Verify the installation
After authorizing, you're redirected back to the dashboard. The Slack card now shows your workspace as Installed with the workspace name.
Verify the bot is active by typing /inkeep help in any Slack channel.
Only one Slack workspace can be connected to your Inkeep tenant. To switch workspaces, uninstall the existing one first.
Configure agents
After installing, set up which agent responds to your team's requests. See the full Configuration guide for details.
- Go to Work Apps → Slack in the dashboard
- Set default agents for your workspace and channels
Channel defaults take priority over the workspace default. If you remove a channel default, that channel falls back to the workspace default agent.
Onboard your team
Account linking happens automatically — when an unlinked user first interacts with the bot (via @Inkeep or /inkeep), they receive a prompt with a Link Account button. After clicking it and signing in to Inkeep, their original question is automatically answered. This only needs to happen once per user.
Alternatively, users can link proactively by running /inkeep link in any channel.
The link button uses a short-lived JWT token (10 minutes) for security. If it expires, the user can simply ask their question again to get a new prompt, or run /inkeep link manually.
Configuration
Set up workspace defaults, channel defaults, and manage users
Using the Slack App
Share this with your team — full command and usage reference
Uninstalling
To remove the Slack app from your workspace:
- Go to Work Apps → Slack in the dashboard
- Click the workspace options menu
- Select Uninstall
This removes the bot from your workspace, deletes all user link mappings, and cleans up channel configurations.