Slack
The Slack integration lets Helios agents search and call the entire Slack API to post messages, manage channels, work with files and canvases, and run automatically on new messages.
What your agents can do
Helios agents don't pick from a preset list of Slack actions. They semantically search Slack's entire API and call any method directly, with authentication injected server-side - so anything the Slack API exposes, an agent can do in your workspace.
- Post, update, and thread messages in channels and DMs
- Read channel history and search across the workspace
- Create, join, and manage channels
- Upload, read, and share files
- Create and update canvases
- Add reactions and read who reacted
Authentication
| Method | Type | Description |
|---|---|---|
| Helios Slack app (Recommended) | OAuth 2.0 | Install with a single redirect; Helios manages tokens |
| BYO Slack app | OAuth 2.0 | You supply your app's client ID, secret, and bot token |
See Integration authentication for how credentials are stored and injected.
Helios Slack app (Recommended)
The default and recommended path. When you create the integration, Helios redirects you to Slack to approve the workspace install, then stores and refreshes the tokens for you.
On top of the workspace install, each user completes a one-time per-user authorization so their agents act with the right Slack identity.
BYO Slack app
Bring your own Slack app when you need custom branding or your own scopes.
- Go to Slack App Management.
- Click Create New App → From scratch and configure OAuth scopes and event subscriptions.
- Install the app to your workspace.
- In Helios, provide the client ID, client secret, and a bot token (
xoxb-…).
Token rotation is not supported for BYO bot tokens - Helios uses the xoxb-… token you provide as-is.
Scopes
The Helios Slack app requests the scopes agents commonly need.
- Bot scopes:
app_mentions:read,channels:history,channels:join,channels:manage,channels:read,chat:write,chat:write.public,commands,files:read,files:write,groups:history,canvases:*,emoji:read - User scopes:
channels:read,channels:history,channels:write,chat:write,files:read,groups:history,groups:read,im:write,search:read
Triggers
Slack is one of only three integrations that emit event triggers into Helios, so a Workflow can run an agent automatically when a message is posted.
| Event | Description | Filters |
|---|---|---|
message.channel | A message posted in a public channel | channel (optional) |
message.group | A message posted in a private channel | channel (optional) |
Omitting the channel filter matches all channels the bot can see. See Triggers for how to attach these to a Workflow.
Last updated on
GitHub
The GitHub integration lets Helios agents search and call the entire GitHub REST API to manage repositories, automate pull requests and issues, drive GitHub Actions, and run automatically on repository events.
Plain
The Plain integration lets Helios agents query and mutate your Plain workspace through its GraphQL API, and run agents automatically when customer threads are created.