Skip to main content
Connect Slack to get agent updates in threads and to start or steer chats without leaving Slack. Agents in autonomous mode, which run for hours without asking for approval, use Slack to report progress and findings. Slack works the same in the desktop app and in Qualia Cloud. You connect once from settings, then invite the bot to the channels you want it in.

Connect Slack

1

Open Slack settings

Go to Settings > Integrations > Slack.
2

Authorize Qualia

Click Connect to Slack and approve the request in the Slack window that opens.
3

Invite the bot

When the status shows Connected, invite @Qualia to each channel you want it to join.
In Qualia Cloud, the connection belongs to the workspace where you started it. New DMs and @-mentions create chats in that workspace. If you reconnect from another Qualia workspace, new conversations go there instead. Existing threads keep routing to their original workspaces.

One Qualia account per Slack account

You can connect a Slack account to only one Qualia account at a time. If you authorize the same Slack account from a second Qualia account, the connection moves there. Reconnecting from the first account moves it back. While the connection is elsewhere, Qualia can’t answer chats the first account started in Slack. If someone replies in one of those threads, Qualia answers that the account moved.

Choose where Slack messages run

Under Where Qualia runs, choose where messages from Slack execute. The default, Qualia Cloud, answers whether or not your computer is on. Choose This machine when a Slack request needs data or compute that only exists on your computer. Qualia then answers only while it is running on that machine:
  • If Qualia isn’t running, Slack replies with a note asking you to start it. Qualia doesn’t queue the message, so send it again once Qualia is running.
  • If your machine sleeps mid-response, the run stops and may leave a partial reply. Ask again once it wakes.

Choose which chats post to Slack

Each Slack-backed chat has its own thread. To turn updates on or off for a chat, toggle Notify in Slack in the chat tab menu or in an agent’s right-click menu. If Slack isn’t connected yet, the menu shows Connect Slack… instead. Chats you start from Slack post there automatically. A chat you start in the app creates a direct-message thread the first time it posts. To stop updates, turn Notify in Slack off. Qualia closes the chat’s thread, and replies there get a private notice instead of reaching the agent. Turn it back on to resume updates in the same thread. In a shared cloud workspace, only the owner can change Notify in Slack, and only the owner’s chats can post updates. See shared workspaces for roles. Agents post progress updates, findings, completion notices, and questions with answer buttons.

Chat from Slack

  • Start a conversation: @-mention the bot in a channel it has joined, or DM it. Qualia creates a chat and replies in a thread.
  • Reply in a thread: the thread’s agent reads the reply and adjusts its work.
  • Answer questions: fill in the answers in the Slack message and click Submit.
Only Slack users who connected Slack from their own Qualia account can start a conversation. Steering an agent, answering its questions, or approving its work needs edit access to the workspace. Others get a private notice.

Use Slack commands

Type a command that starts with ! in a channel with Qualia or in a DM. Commands don’t start an agent.
  • !help lists the available commands.
  • !workspace [NAME] picks which Qualia workspace the channel, or your DMs, uses. Without a name, Qualia offers a menu.
  • !usage privately shows your usage and when it resets.
A mistyped command gets a private suggestion. A ! name that matches a skill goes to the agent instead. Everyone in a channel can read what Qualia posts there, so pick its workspace with that in mind.

Let the agent read and post in Slack

Once Slack is connected, the agent can list channels, read channels and threads, and post messages during any chat. It reads by channel and thread, and can’t search Slack. Which channels the agent can read depends on where the turn started:
  • A chat you started in Qualia Cloud sees what you see in Slack, including your private channels.
  • A turn started from a Slack thread sees only channels Qualia was invited to, because anyone can reply in that thread.
  • The desktop app offers these tools when Where Qualia runs is This machine, and sees only channels Qualia was invited to.
Posts always go out as the Qualia app, never as you. The agent confirms the wording and destination with you before sending anything you didn’t dictate. To change whether each tool needs your approval, open Customize agent > MCP Servers and select Slack. See MCP integrations for the permission options.

Disconnect Slack

To revoke access, click Disconnect next to Disconnect Slack in Slack settings. Removing the Qualia app from your Slack workspace also disconnects it. After you disconnect, agents stop posting to Slack. Agents in autonomous mode keep working but no longer report progress. You can reconnect at any time.

Troubleshooting