# 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](https://www.tryrisotto.com/docs/integrations/tools/slack/unarchive_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](https://www.tryrisotto.com/docs/integrations/tools/slack/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](https://www.tryrisotto.com/docs/integrations/tools/slack/setup#enterprise-grid)).

## Supported Operations

### Slack Business+

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

### Slack Enterprise Grid

Enterprise Grid unlocks the full set of capabilities. Check **Install across the entire Slack organization** when setting up the [Slack Tools connector](https://www.tryrisotto.com/docs/integrations/tools/slack/setup#enterprise-grid).

#### 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>`)".

### Quick Comparison

| Capability               | Business+ | Enterprise Grid |
| ------------------------ | --------- | --------------- |
| Create public channels   | ✅         | ✅               |
| Create private channels  | ✅         | ✅               |
| Archive public channels  | ✅         | ✅               |
| Archive private channels | ❌         | ✅               |
| Rename channels          | ✅         | ✅               |
| Change channel privacy   | ❌         | ✅               |

## Configuration

1. **Set up the Slack Tools connector**

   Follow the [Slack Tools Setup](https://www.tryrisotto.com/docs/integrations/tools/slack/setup) guide to
   connect your Slack workspace. If you need Enterprise Grid features, check
   **Install across the entire Slack organization** during setup.

2. **Configure the tool**

   In the Risotto dashboard, navigate to
   [Tools](https://dashboard.tryrisotto.com/tools) and select the **Manage
   Slack Channels** tool. Choose whether this tool requires admin approval to
   execute, then save.

3. **Create your Runbook**

   Create a custom Runbook or use a Runbook Template from the Risotto Runbook
   Library to configure your Slack Manage Channels tool.

### Using a per-tool token override

If you need this tool to use different credentials than the connector — for example, to operate in a separate workspace — you can provide a custom token directly in the tool configuration:

- **Bot Token** — A User OAuth Token (`xoxp-`) with the required scopes
- **Team ID** — Your Slack workspace Team ID (starts with `T`)

Per-tool tokens take precedence over the connector. See [per-tool token override](https://www.tryrisotto.com/docs/integrations/tools/slack/setup#per-tool-token-override) for details.

## 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](https://www.tryrisotto.com/docs/integrations/tools/slack/setup#per-tool-token-override), add both `admin.conversations` scopes 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.

Source: https://www.tryrisotto.com/docs/integrations/tools/slack/manage-slack-channels
