Slack
Team & CommunityAdding your agent to Slack is like giving your team a new helpful coworker they can message in a channel. People post a question, and your agent answers right there in the conversation. This page shows you how to create a Slack app and connect it to your Nirvai agent.
Image: Slack channel export showing a connected workspace
Before you start
- A saved agent in the Agent Control Panel (at least the Profile step completed).
- A Slack workspace — your team's Slack account, the space where your channels and people live.
- Permission to add an app to that workspace (usually an admin).
- A bot token — a secure access pass from your Slack app that lets Nirvai send and receive messages on its behalf. You'll create this in the next step.
Step-by-step
1. Create a Slack app
- Sign in to Slack on the web and go to the Slack app directory for developers.
- Click Create New App and choose From scratch.
- Give the app a name (for example, "My Support Agent") and pick the workspace where it should live.
- Open the OAuth & Permissions section of the app settings.
- Under Bot Token Scopes, add the basic message scopes (read messages in channels the bot is invited to, post messages, and read files).
- Click Install to Workspace at the top of the same page and approve the app.
- Slack shows you a Bot User OAuth Token — your bot token. Copy it. It starts with
xoxb-.
Image: Slack app settings showing the bot token
warning
Keep your bot token private. Anyone who has it can read and post messages as your app — treat it like a password.
2. Connect the app to Nirvai
- Open your agent in the Agent Control Panel.
- Click the Channels node.
- Select Slack from the Team & Community section.
- Paste your bot token into the field.
- Pick the channel where the agent should reply.
- Click Connect.
Image: Pasting the Slack bot token in Nirvai
3. Invite the agent into the channel
In Slack, open the channel you picked and type:
/invite @YourAppName
That's it — your agent now lives in that channel.
What happens after you connect
- When someone posts in the connected channel, Slack hands the message to Nirvai, your agent reads it, and the reply appears in the same channel.
- Your agent only replies in the channel you connected. Other channels in the workspace are not affected.
- The agent finishes its current reply before starting the next one — extra messages line up and are answered in order.
- If a teammate attaches a screenshot or a document, the agent just answers — no extra "uploaded" confirmation.
What your agent can do on Slack
| Capability | Supported |
|---|---|
| Reply to channel messages | ✓ |
| Send text messages | ✓ |
| Send images | ✓ |
| Send files | ✓ |
Managing your connection
- Remove disconnects Slack from your agent. The Slack app stays in your workspace but stops replying until you reconnect.
- To use a different channel, remove the connection and add it again with the new channel selected.
Troubleshooting
| Problem | Fix |
|---|---|
| The agent doesn't reply in the channel | Make sure the Slack app has been invited to that channel. In Slack, type /invite @YourAppName. |
| "Invalid token" while connecting | Double-check that the token starts with xoxb- and was copied without extra spaces. Reinstall the app to your workspace if needed. |
| "Permission denied" while creating the app | You need admin permission on the workspace to install apps. Ask a workspace admin to do this step. |
| You want more than one agent in the same workspace | Each agent uses its own Slack app and channel. Put each one in a different channel. |
| The agent replies but skips messages | A long reply may still be in progress — the next message will be picked up as soon as the agent finishes. |
What's next
- See every place your agent can show up in the Channels overview.
- Set up a public bot in Telegram or a community bot in Discord.