Prerequisites
- A Slack workspace where you have admin permissions
Installation
- Go to app.nextks.com/signin
- Click Add to Slack
- Review the requested permissions in the Slack OAuth prompt and click Allow
- You’ll be signed in to the NextKS dashboard automatically as the organization admin
The installation process creates your NextKS organization and signs you in — no separate account creation needed.
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 |
Signing in (after installation)
Once the workspace is connected, team members sign in at app.nextks.com/login:- Click Sign in with Slack
- Authorize the sign-in in the Slack OAuth prompt
- You’re signed in to the NextKS dashboard
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 sign 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
Bot doesn't respond to messages
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
Notifications not delivered
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
Buttons not working
Buttons not working