FAQ
Can I rename the bot?
Yes, to rename the @kapa.ai Slack Bot to something else:
- Open the kapa.ai app on Slack marketplace.
- Open the Configuration tab.
- Scroll down to the section called Bot User and click Edit
- Edit your custom name and save your changes.
Note that it is not possible to change the logo or description of the app, only the name/handle.
Can I control which Kapa project I DM directly?
No, if you have multiple projects, Kapa can only be directly messaged with a global workspace installation. If you have multiple Kapa bots installed in your workspace, you won't be able to choose which one to DM - it will always be the global workspace bot. To request this feature, please reach out to the Kapa team.
Do I ever need to update my Slack Bot installation?
When we release new features that require additional permissions, you need to reinstall the bot to grant the new permissions. These updates are always backwards compatible. Your existing setup continues to work, but the new features won't be available until you reinstall. The Kapa team will inform you whenever such a change is released.
To reinstall, simply follow the installation link from the quickstart. Your existing configuration and enabled channels are preserved. You do not need to re-enable the bot, add it to channels again, or reconfigure anything.
I can't use the /kapa-enable-channel or /kapa-enable-workspace commands
If the bot commands aren't visible in your workspace, you may need to update the bot. Reinstall the bot by following the installation link from the quickstart.
If the commands appear but don't function, it's likely that you don't have the necessary permissions. To enable the Slack Bot, you must be a Workspace Owner or Workspace Admin.
How do I remove the Slack Bot from a channel?
To remove the bot from a channel:
- Open the Slack channel you want to remove the bot from.
- Type
/kick @kapa.aiand hit send. - In the confirmation prompt, click Remove.
If the bot was created as a Single Channel integration, also delete the integration in the Kapa platform:
- Go to the Kapa platform and open the Integrations tab.
- Locate the Slack integration you want to remove in the list.
- Open the action menu and select Delete.
The Slack Bot isn't responding to direct messages
If you recently migrated to a Slack Enterprise+ plan, you'll need to update
your integration settings. Enterprise Grid organizations use org IDs instead of
workspace IDs. Update your Kapa integration with your org ID (starts with E
instead of T) - you can find it the same way as the workspace ID in your
browser URL after /client/.
What permissions does the Slack Bot require?
The Slack Bot requires the following OAuth scopes during the installation process. These permissions are necessary for the bot to function correctly in your workspace.
| Permission | Description | Used For |
|---|---|---|
| app_mentions:read | Read @mentions of the bot | Detecting when users mention the bot to ask questions |
| assistant:write | Allows app to act as an App Agent | Displaying AI assistant animations for improved UX |
| users:read | Read basic user information | Identifying users who interact with the bot |
| users:read.email | Read user email addresses | User tracking across multiple integrations (when enabled) |
| chat:write | Send messages and ephemeral responses | Posting answers, acknowledgments, and feedback prompts |
| channels:history | Read message history in public channels | Reading conversation context to provide relevant answers |
| channels:join | Join public channels | Allowing the bot to be added to channels |
| channels:read | Read public channel information | Listing and reading channel metadata |
| groups:history | Read message history in private channels | Reading conversation context in private channels |
| im:history | Read direct message history | Supporting 1-on-1 conversations with the bot |
| mpim:history | Read multi-person DM history | Reading context in group DM conversations |
| commands | Register slash commands | Enabling /kapa-enable-channel and /kapa-enable-workspace commands |
| files:read | Download and read file contents | Processing files uploaded by users in their questions |
| reactions:read | Read emoji reactions | Tracking user feedback (upvotes/downvotes) on bot responses |
| reactions:write | Add emoji reactions | Rendering loading animations while the bot processes questions |
It is not possible to modify the permissions that the Slack Bot requires. All listed permissions are necessary for the bot to provide its full functionality.