Slack

Install the hlix Slack app into your Workspace and talk to the chat agent in a DM or by @mentioning it in a channel.

Connect Slack to work with your hlix agent in a direct message or channel. After installation, a DM to the bot or an @hlix mention reaches the same agent, projects, models and tools as the dashboard.

What it does

Send direct messages or @mention the bot in a channel.
Continue the conversation in a thread the agent has replied to.
Include up to ten recent messages as conversation context.
See tool activity and results as cards in Slack.

Every message is recorded in the audit log as integration.channel.dispatched, with the Slack user id and name.

Prerequisites

A hlix Workspace, and agency owner or admin — connecting and revoking an installation is Workspace administration
Permission to install an app in the Slack workspace
Install into a single Slack workspace, including one within Enterprise Grid

Connect it

Start the install from the dashboard under Integrations → Slack, or open:
```
https://server.hlix.ai/v1/api/integrations/slack/install
```
Sign in to Slack and select the workspace to connect.

Approve the scopes on Slack’s consent screen. hlix requests exactly:

app_mentions:read   assistant:write   channels:history   chat:write
groups:history      im:history        im:read            im:write
channels:read       groups:read       chat:write.public

channels:read and groups:read list channels for alerts, and chat:write.public allows alerts in public channels.

Confirm. Slack redirects back to the dashboard with ?installed=1, and the installation appears in the list:

curl https://server.hlix.ai/v1/api/integrations/slack \
  -H "X-Organization-Id: $HLIX_WORKSPACE_ID" \
  -H "Authorization: Bearer $HLIX_API_KEY"

Talk to it. DM the bot, or invite it to a channel and @mention it.

Alerts

Choose a channel for updates when a project starts, reaches preview, needs approval or finishes. Alerts also highlight decisions and delivery problems that need attention. Each message includes a title, short summary and link to Hlix. Lead messages, email contents and tool arguments stay private.

Open Integrations → Slack and, under Alerts, choose a channel. Public channels work without inviting the app. A private channel appears in the list only after you run /invite for the hlix app inside it — Slack shows an app no other private channels.
Turn alert kinds on or off. All of them are on by default.
Send test message to confirm hlix can post there.

If the dashboard asks for alert permissions, choose Reconnect Slack to grant the required scopes.

If alerts stop, the dashboard shows the channel’s status. Select another channel, reconnect Slack or send a successful test message to restore posting. Hlix automatically retries temporary timeouts and rate limits.

The same alert kinds go to every linked Telegram chat, with their own on/off toggles.

curl https://server.hlix.ai/v1/api/alerts \
  -H "X-Organization-Id: $HLIX_WORKSPACE_ID" \
  -H "Authorization: Bearer $HLIX_API_KEY"

Alert settings are owner/admin only, and every change is in the audit log as integration.alerts.updated, integration.alerts.removed or integration.alerts.test_sent.

Disconnect

curl -X POST https://server.hlix.ai/v1/api/integrations/slack/$INSTALL_ID/revoke \
  -H "X-Organization-Id: $HLIX_WORKSPACE_ID" \
  -H "Authorization: Bearer $HLIX_API_KEY"

Revoking ends access on the next message. The installation history is retained.

Who can act through Slack

Anyone who can reach the bot can use the connected Workspace’s agent tools, including creating tasks and running cycles. Access follows Slack conversation membership, including external members in shared channels. Choose channels whose members should have this access.

Security

Hlix verifies Slack requests and uses the connected Slack workspace to select your Hlix Workspace.

A Slack workspace can be connected to at most one hlix Workspace at a time.

If it does not respond

Authorization expired or failed: restart the connection from Integrations → Slack. Contact support if it continues.
Workspace already connected: disconnect it from the other Hlix Workspace before reconnecting here.
Permission error: use an account with the owner or admin role.
No bot reply: check the installation is active and invite the bot to the channel where you mention it.