The CloudRadial AutomationAI Slack extension lets a workflow or agent post notifications and alerts to Slack, look up users and channels, read channel history, and manage messages and channels. This article covers what the extension can do, the bot token and scopes it needs, which tools require approval, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Getting the Bot Token
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- Skills
- Tips for Working With Slack
What the Extension Covers
The extension calls the Slack Web API and provides 12 tools across three areas:
| Area | What you can automate |
| Users (3 tools) | Find a user from an email address, read a user's profile, and list the members of the Slack workspace |
| Channels (3 tools) | List channels and conversations, create a public or private channel, and invite users to a channel |
| Messages (6 tools) | Post a message to a channel, private channel, or direct message; post a message only one user can see; read a channel's message history; edit or delete a message; and add an emoji reaction |
The extension does not upload files. Install it from Extensions like any other catalog extension. It appears in the catalog as Slack. See Browsing and installing extensions for the general install flow.
Getting the Bot Token
The extension authenticates as a Slack app's bot user, with a bot token that starts with xoxb-. To create the app and get its token:
- Go to
https://api.slack.com/apps, select Create New App, name the app, and choose the Slack workspace to install it in - In the app's settings, open OAuth & Permissions. Under Bot Token Scopes, select Add an OAuth Scope and add the scopes for the tools you plan to use, from the table below.
- At the top of the OAuth & Permissions page, select Install to Workspace, then select Allow
- Copy the bot token, which begins with
xoxb-, from the OAuth & Permissions page
For more detail, see Slack's Creating an app from app settings guide.
| To let the extension | Grant these bot scopes |
| Find a user by email |
users:read and users:read.email
|
| Read a user's profile or list members | users:read |
| List channels |
channels:read or groups:read
|
| Read channel history |
channels:history or groups:history
|
| Post, edit, or delete messages | chat:write |
| Add reactions | reactions:write |
| Create channels or invite users |
channels:manage or groups:write
|
Providing the Credentials to Your Runner
Store two secrets in your runner's Key Vault with these exact names:
| Secret | Value |
Slack-BotToken |
The bot user OAuth token, starting with xoxb-
|
Slack-ApiUrl |
The Slack Web API base URL, https://slack.com/api
|
Store the token exactly as Slack shows it; the extension sends it as a Bearer token for you. For how to add secrets, see Accessing and updating your runner's Key Vault.
The agent reads the credentials from the runner and never asks you for them. Once the secrets are in place, ask the AI Playground to list your Slack channels to confirm the connection works.
Reads and Approval-Gated Changes
Posting notifications is the extension's main job, so outbound messages run without approval. Three tools that delete content, create a workspace resource, or change who has access to a channel are approval-gated: the run pauses and the request appears as an Action Required item in the Inbox until someone approves it. See Handling Action Required items in the Inbox.
| Tool behavior | Tools |
| Approval-gated | Delete a message; create a channel; invite users to a channel |
| Runs without approval, and posts to Slack | Post a message; post a message only one user can see; edit a message; add a reaction |
| Read-only | Find a user by email; read a user's profile; list members; list channels; read channel history |
Deleting a message can't be undone, so check the channel and message before you approve. Because posts and edits don't pause for approval, test a workflow that posts to Slack against a test channel first.
Skills
The extension ships four skills that guide an agent through common Slack tasks:
| Skill | Use it to |
| Post a Slack Message | Send a notification, alert, or message to a channel, private channel, or direct message. If you give only an email address, the agent finds the user first. |
| Look Up Users and Channels | Find a user id from an email, read a user's profile, or find a channel id, typically before posting or inviting. Read-only. |
| Read Channel History | Read recent messages in a channel to summarize them, find a message, or check activity. Read-only. |
| Manage Messages (Update, Delete, React) and Channels | Edit or delete a message, add a reaction, invite users to a channel, or create a channel. Deleting, creating, and inviting wait for approval. |
Tips for Working With Slack
- The bot must be a member of a channel to read its history. Otherwise Slack returns a
not_in_channelerror. - A message only one user can see goes to someone who is already in the channel
- To send a direct message, give the agent the person's email address. It finds their Slack user id and posts to them directly.
- Editing, deleting, or reacting to a message needs the message's timestamp, which Slack returns when the message is posted. In a workflow, pass that value from the post step to the later step.
- Channel names must be lowercase, use only letters, numbers, hyphens, and underscores, and be 80 characters or fewer
- Slack reports some failures inside a successful response. The agent checks for them and reports the error code, such as
channel_not_found,users_not_found,not_in_channel, ormissing_scope. Amissing_scopeerror means the app needs another bot scope from the table above. - Listing members, listing channels, and reading history return the complete result in one call. For long channels, give a time range to keep the history focused.
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.