Install and Set Up the Slack App
Copy page
Admin guide — install the Inkeep Slack app, configure agents, and onboard your team.
Install and Set Up the Slack App
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 AI Assistant for Slack is a cloud-only feature. On Inkeep Cloud, all required Slack environment variables are pre-configured — you don't need to set anything up on the infrastructure side.
Prerequisites
- An Inkeep Cloud 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.
Quick start:
- Go to Work Apps → Slack in the dashboard
- Set a Workspace default agent — this is the agent that responds in all channels by default
- Optionally set Channel defaults for channels that need a different agent (e.g. a support agent for
#support)
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
Each team member needs to link their Slack account to Inkeep before using agents. Share these instructions with your team:
- 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 — the linking completes automatically
- Verify with
/inkeep status
Account linking uses a short-lived JWT token for security. If the link expires, run /inkeep link again.
Once linked, team members can start using @Inkeep and /inkeep immediately. Point them to the Using the Slack App guide for a full command 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.