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
- Post messages and replies
- 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.
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
Team members can start using @Inkeep and /inkeep immediately, and you can point them to the Using the Slack App usage guide.
The first time they interact with the bot, they'll be prompted to link their Slack account. They can also link proactively:
- Type
/inkeep linkin any Slack channel - Click the private link the bot sends (expires in 10 minutes)
- Sign in to Inkeep if not already signed in
- Verify with
/inkeep status
Next steps
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.