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:
- A channel ID, for example
C1234567890. This takes precedence over the channel name. - 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:
- The per-tool Bot Token override.
- The Slack Tools connector.
- 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.
Related
- Slack Tools Setup
- Send Slack DM - message a person instead of a channel
- Pin Slack Message - pin a message you posted
- Send Slack Form - collect a structured response from the requestor
Something wrong or missing? Report an issue · View as Markdown