> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nextks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Setup

> Install and configure NextKS for your Slack workspace.

## Prerequisites

* A Slack workspace where you have admin permissions

## Installation

1. Go to [app.nextks.com/signin](https://app.nextks.com/signin)
2. Click **Add to Slack**
3. Review the requested permissions in the Slack OAuth prompt and click **Allow**
4. You'll be signed in to the NextKS dashboard automatically as the organization admin

<Info>
  The installation process creates your NextKS organization and signs you in — no separate account creation needed.
</Info>

## What NextKS needs access to

| Permission                  | Purpose                                |
| --------------------------- | -------------------------------------- |
| Send messages as bot        | Deliver notifications and AI responses |
| Read messages in DMs        | Process user messages to the bot       |
| Manage interactive messages | Handle button clicks and responses     |

NextKS only reads messages sent directly to the bot — it does not access channel conversations.

## Logging in (after installation)

Once the workspace is connected, team members log in at [app.nextks.com/login](https://app.nextks.com/login):

1. Click **Log in with Slack**
2. Authorize the login in the Slack OAuth prompt
3. You're logged in to the NextKS dashboard

New users are created with the `member` role. The original installer is the `admin`.

## Using the bot

Team members can:

* **DM the NextKS bot** to interact with configured MCP servers
* **Receive notifications** sent via the API as DMs from the bot
* **Click response buttons** on interactive notifications

## Adding team members

Users are automatically registered when they first log in, message the bot, or receive a notification. No manual user provisioning is required.

## Reconnecting

If you need to update the bot token (e.g., after revoking permissions), an admin can reconnect from **Admin Settings** in the dashboard.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Bot doesn't respond to messages">
    * Verify the bot is installed: check **Apps** in your Slack sidebar
    * Ensure the workspace admin hasn't restricted bot access
    * Check the NextKS dashboard **Admin Settings** for connection status
  </Accordion>

  <Accordion title="Notifications not delivered">
    * Verify the recipient's email matches their Slack profile email
    * Check that the API key belongs to the correct organization
    * Review the API response for specific error messages
  </Accordion>

  <Accordion title="Buttons not working">
    * Interactive features require the Slack app to have the correct scopes
    * Try reconnecting the app from **Admin Settings** in the dashboard
  </Accordion>
</AccordionGroup>