Install the Slack App

Connect your Slack workspace to Inkeep so your team can interact with AI agents directly from Slack.

Prerequisites

Navigate to your Inkeep dashboard and select Work Apps from the sidebar. You'll see the Slack integration card.

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:

After authorizing, you're redirected back to the dashboard. The Slack card should now show your workspace as Installed with the workspace name.

You can verify the bot is active by typing /inkeep help in any Slack channel.

Each user needs to link their Slack account to their Inkeep account before using agents. This is a one-time setup.

In any Slack channel, type:

/inkeep link

The bot responds with a private link that expires in 10 minutes.

Click the link to open the Inkeep dashboard. If you're already signed in, the linking completes automatically. If not, sign in first.

Run /inkeep status to confirm your account is linked. You'll see your Inkeep account email and the active agent for the current channel.

Tip

Account linking uses a short-lived JWT token for security. If the link expires, run /inkeep link again to get a fresh one.

To remove the Slack app from your workspace:

This removes the bot from your workspace, deletes all user link mappings, and cleans up channel configurations.