Manage Slack Channels
Create, update, archive, and change publicity of Slack channels
Create, update, archive, and change publicity of Slack Channels automatically
What it can do
The Manage Slack Channels tool allows the Risotto agent to create, update, archive, and change channel publicity on your behalf.
- Create channels The agent can spin up a new public or private Slack channel with a specified name and automatically invite the person requesting it. It can also invite additionally specified users
- Archive channels The agent can archive a Slack channel that's no longer needed. To restore an archived channel, use Unarchive Slack Channel.
- Update channels The agent can rename an existing channel or change it between public and private
Example use cases
- An employee asks "Can you create a #we-love-risotto channel for my team?" and Risotto will create the channel and add the specified Slack users
- A team lead requests a channel rename, and Risotto's agent will change the name without IT intervention
Authentication
This tool authenticates through the Slack Tools connector. Follow the Slack Tools Setup guide to configure it. Advanced capabilities (archiving private channels or converting channel privacy) require a Slack Enterprise Grid organization and an org-wide install of the connector (the Install across the entire Slack organization option, see Enterprise Grid).
Supported Operations
With Business+, this tool works automatically with the Slack Tools connector. No additional configuration is needed.
Supported Operations
- Create public and private channels
- Archive public channels (the bot joins the channel, then archives it)
- Rename channels
Limitations
- Cannot archive private channels (the bot cannot join channels it hasn't been invited to)
- Cannot convert a public channel to private, or vice versa
Enterprise Grid unlocks the full set of capabilities. Check Install across the entire Slack organization when setting up the Slack Tools connector.
Supported Operations
- Create public and private channels
- Archive public and private channels, including channels the bot has not joined
- Rename channels, including channels the bot has not joined
- Convert a public channel to private
- Convert a private channel to public
How rename and archive work
With an organization-wide install, the tool renames and archives channels through Slack's admin API first. The admin API does not need the bot in the channel. If Slack refuses the admin call (for example, the user who installed the app is no longer an Org Admin), the tool uses the bot. If the bot also fails, the error ends with "(the admin API also refused: <code>)".
| Capability | Business+ | Enterprise Grid |
|---|---|---|
| Create public channels | ✅ | ✅ |
| Create private channels | ✅ | ✅ |
| Archive public channels | ✅ | ✅ |
| Archive private channels | ❌ | ✅ |
| Rename channels | ✅ | ✅ |
| Change channel privacy | ❌ | ✅ |
Configuration
Set up the Slack Tools connector
Follow the Slack Tools Setup guide to connect your Slack workspace. If you need Enterprise Grid features, check Install across the entire Slack organization during setup.
Configure the tool
In the Risotto dashboard, navigate to Tools and select the Manage Slack Channels tool. Choose whether this tool requires admin approval to execute, then save.
Create your Runbook
Create a custom Runbook or use a Runbook Template from the Risotto Runbook Library to configure your Slack Manage Channels tool.
Troubleshooting
The agent says the tool lacks the scopes to change a channel's privacy
Cause: Converting a channel between public and private, or archiving a private channel, needs Slack's admin.conversations:read and admin.conversations:write scopes, which are only granted by an org-wide Enterprise Grid install.
Solutions:
- Reconnect the Slack Tools connector from the Tools app card on Settings → Integrations → Slack with Install across the entire Slack organization checked, and have an org owner complete the install. The box is not remembered between setup attempts.
- If this tool uses a per-tool token override, add both
admin.conversationsscopes to your own Slack app under OAuth & Permissions, reinstall it at the organization level, and update the token in the tool configuration. - On Slack Business+ these operations are not available; see the comparison table above.
Something wrong or missing? Report an issue · View as Markdown