# Send Slack Channel Message

Send a message to a Slack channel from a runbook

Sends a message to a Slack channel from within a runbook. Use it to post an update, an announcement, or a runbook result where a team can see it. To message one person instead, use [Send Slack DM](https://www.tryrisotto.com/docs/integrations/tools/slack/send_dm).

## How It Works

The agent gives the tool a message and a channel. The agent can name the channel in one of two ways:

1. **A channel ID**, for example `C1234567890`. This takes precedence over the channel name.
2. **A channel name**, for example `it-help`. The leading `#` is optional, and the tool ignores capital letters.

The agent can also give the timestamp of a message in the channel, for example `1616880476.005500`. The tool then posts the message as a reply in that thread. Without a timestamp, the tool posts a top-level message. Slack message links drop the dot from the timestamp. The tool accepts that form too.

The message supports Slack formatting such as `*bold*`, `_italic_`, and `` `code` ``.

Risotto joins the channel first when it is public. Then it posts the message. If the channel is private, the bot must already be a member.

## 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.

The connector's bot token needs the `channels:join`, `channels:read`, `chat:write`, and `groups:read` scopes. The message appears in Slack from your connector app, with its name and icon. All messages from the connector use the same name and icon. To post one tool's messages as a different Slack app, use a [per-tool token override](https://www.tryrisotto.com/docs/integrations/tools/slack/setup#per-tool-token-override).

The tool uses the first token it finds in this order:

1. The per-tool **Bot Token** override.
2. The Slack Tools connector.
3. The Slack app that handles your ticket conversations.

> **Tip:** For high-volume automation, use the Slack Tools connector with a dedicated
> custom app. A dedicated app avoids rate limiting that the default Risotto chat
> app can hit when it also handles ticket conversations.

> **Warning:** **Check for the missing-scopes banner before you rely on this tool.** If your
> connector predates a scope this tool needs, the tool's page in the dashboard
> shows a **Missing scopes** banner: *"The Slack tools app is missing required
> scopes. Reconnect it on the Slack page."* Click the link in the banner, or go
> to **Settings → Integrations → Slack**, then click **Connected** on the
> **Tools app** card and choose **Reconnect...**. Follow the [Slack Tools
> Setup](https://www.tryrisotto.com/docs/integrations/tools/slack/setup#reconnecting-the-connector) guide
> to add the scopes.

## Configuration Options

- **Bot Token** *(Optional override)* - Per-tool bot token. Takes precedence over the Slack Tools connector. See [per-tool token override](https://www.tryrisotto.com/docs/integrations/tools/slack/setup#per-tool-token-override).
- **Team ID** *(Optional)* - Required only when you use a per-tool bot token override.

## Example Runbook Uses

- Post a summary to a team channel when a runbook finishes, for example when it provisions a new hire.
- Notify an alerts channel when an automation detects a problem.
- Reply in an existing thread with a status update instead of starting a new conversation.

## Limitations

- The tool sends plain text only. It does not send buttons, forms, or files.
- The message is one-way. Replies in the channel do not flow back into the ticket or resume the runbook.
- The bot cannot join private channels by itself. Invite the bot to a private channel before the runbook runs.
- The tool finds channels by exact name. It cannot find archived channels, or private channels the bot has not joined, by name.
- Slack rate limits apply. If Slack asks the tool to wait, the tool waits and retries for up to five minutes, then fails with a rate limit message.

## Troubleshooting

### The bot is not a member of this channel

Risotto joins public channels by itself. For a private channel, invite the
connector's bot user to the channel and run the runbook again.

### Channel not found

The channel ID or name is wrong, or the channel is private and the bot is not
a member. Check the spelling, or pass the channel ID. Then invite the bot if
the channel is private.

### The channel is archived

Slack does not allow posts to an archived channel. Restore it with [Unarchive
Slack Channel](https://www.tryrisotto.com/docs/integrations/tools/slack/unarchive_channel), or post to
another channel.

### This channel only allows thread replies, or does not allow thread replies

Some channels restrict who can post or reply. For a thread-only channel, give
the tool the timestamp of the message to reply to. For a channel that blocks
replies, post a top-level message instead. Slack also blocks replies to locked
threads.

### Slack prevents the bot from posting

A workspace preference, a read-only channel, or a Slack admin setting blocks
the bot. Ask a Slack admin to allow the bot to post in this channel.

### Missing-scopes banner on the tool page

Your connector app does not grant a scope this tool needs. Click the link in the banner, or go to **Settings → Integrations → Slack**, then click **Connected** on the **Tools app** card and choose **Reconnect...**. Follow the [Slack Tools
Setup](https://www.tryrisotto.com/docs/integrations/tools/slack/setup#reconnecting-the-connector) guide.

## Related

- [Slack Tools Setup](https://www.tryrisotto.com/docs/integrations/tools/slack/setup)
- [Send Slack DM](https://www.tryrisotto.com/docs/integrations/tools/slack/send_dm) - message a person instead of a channel
- [Pin Slack Message](https://www.tryrisotto.com/docs/integrations/tools/slack/pin_message) - pin a message you posted
- [Send Slack Form](https://www.tryrisotto.com/docs/integrations/tools/slack/send_form) - collect a structured response from the requestor

Source: https://www.tryrisotto.com/docs/integrations/tools/slack/send_channel_message
