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.
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.
Use Slack commands
Type a command that starts with! in a channel with Qualia or in a DM. Commands don’t start an agent.
!helplists the available commands.!workspace [NAME]picks which Qualia workspace the channel, or your DMs, uses. Without a name, Qualia offers a menu.!usageprivately shows your usage and when it resets.
! 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.

