Docs

Integrations / Chat / Slack

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.

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

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.

Configuration Options

  • Bot Token (Optional override) - Per-tool bot token. Takes precedence over the Slack Tools connector. See 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, 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 guide.

Something wrong or missing? Report an issue · View as Markdown