Overview
Connect Slack to Hatz so you can work with your Slack workspace from inside Hatz Chat and Workflows — searching conversations, catching up on channels, and sending messages without switching tools.
Teams keep their decisions, context, and announcements in Slack, but the work of finding, summarising, and acting on them happens somewhere else. This integration closes that gap: ask Hatz a question in plain language, and it works with Slack on your behalf.
Each person connects their own Slack account. Hatz only reaches the channels, messages, and files your own Slack permissions already allow, and never exceeds the access granted to the authenticated user.
How it works
Slack runs a hosted service that lets approved applications act on a user's behalf. Hatz connects to it through Slack's standard OAuth approval flow — the same screen you see when adding any Slack app.
Once connected, Slack appears as a tool inside Hatz, not as a separate place to go. You use it from Hatz Chat and from Workflows, and the actions it takes land in Slack exactly as if you had done them yourself: messages you send come from you, and appear to your teammates as coming from you.
Because the connection is tied to your own Slack account, two people in the same Hatz workspace will get different results from the same question, reflecting the different channels each of them can see.
What you can do
Search and catch up. Find past discussions across public channels, private channels, DMs, and group DMs you belong to, and summarise what happened.
Send messages. Post updates to channels and DMs, as yourself.
Schedule messages. Queue a message to post to a channel at a set time. It appears in Slack under Drafts & sent > Scheduled.
Find files. Locate documents and attachments shared in your workspace.
Work with canvases. Read existing Slack Canvases and create or update them.
Start conversations. Create new channels and DMs.
Look up people. Find teammates by name, display name, or email.
React. Add emoji reactions to messages.
Example asks
"Summarise what was discussed in #engineering-oncall this week."
"Search Slack for messages about the Q3 launch deadline."
"Send a message to #general letting the team know the deploy is complete."
"Who's in the #product channel?"
"Find the pricing deck someone shared in #sales last month."
"Create a channel called #launch-retro and post the agenda."
Before you start
A Slack account in the workspace you want to connect.
A Hatz account. If you don't see the Slack card in Workshop > Connections, contact your Hatz representative.
Setup has two parts: Hatz AI for Slack is installed in your Slack workspace once, then each person connects their own Slack account in Hatz.
Install Hatz AI for Slack
If you belong to more than one Slack workspace, pick the one you want under "Where do you want to use" on Slack's install screen.
Review the permissions and click Allow.
If your workspace requires admin approval for new apps, Slack sends a request to your Slack admin instead. Once they approve, Hatz AI for Slack is installed for the whole workspace.
This only needs to happen once per Slack workspace. If Hatz AI for Slack is already installed, skip to the next step.
Connect your Slack account
In Hatz, open Workshop > Connections > Hatz Integrations and find the Slack card.
Click Connect. Slack opens and asks you to approve the permissions Hatz requests.
Click Allow. Slack returns you to Hatz and the card shows Connected.
Slack is now available as a tool in Hatz Chat and in Workflow prompt steps.
Each person connects their own account, so Hatz only reaches what that person can already see in Slack.
Using Slack in Hatz
In Chat, select Slack in the tool picker, or simply mention Slack in your request — "check Slack for…", "post this to #general". Hatz asks for your approval before it takes an action in Slack, such as sending a message or creating a channel.
In Workflows, open the tool picker on a prompt step and add Slack. The tool picker appears only when the step's model supports tool calling and no agent is selected for that step. For example, a prompt step can summarise a channel's recent discussion or post an update to a channel.
Review anything Hatz drafts before it goes out, particularly for customer-facing or high-visibility channels.
What Hatz can access
When you connect, Slack asks you to approve a set of permissions. Grouped by what they let Hatz do:
Search conversations you can access: search:read.public, search:read.private, search:read.im, search:read.mpim
Read message history to summarise and retrieve context: channels:history, groups:history, im:history, mpim:history
See which channels and conversations exist: channels:read, groups:read, mpim:read
Send messages as you: chat:write, im:write, mpim:write
Create channels and conversations: channels:write, groups:write
Find and reference shared files: search:read.files, files:read
Read and update Slack Canvases: canvases:read, canvases:write
Look up teammates: users:read, users:read.email, search:read.users
Add and read emoji reactions: reactions:write, reactions:read, emoji:read
These permissions describe the maximum Hatz could do — not what it does on its own. Hatz takes a Slack action only when you ask for one, and every action is bounded by your own Slack access. If you cannot see a private channel in Slack, neither can Hatz when acting for you.
Email addresses are used only to look up and identify teammates inside Hatz. Hatz does not use them to contact anyone.
On Slack's free plan, message and file history is limited to 90 days. Hatz does not surface Slack content beyond what your plan retains.
Privacy and AI
For details on what we collect, how it is used, how long it is kept, and how to request access to or deletion of your data, see our Privacy Policy.
Disconnecting
To disconnect, open Workshop > Connections > Hatz Integrations and click the settings icon on the Slack card. Turn off Enabled to pause Slack, or choose Delete Integration to remove your connection. Hatz stops acting on your Slack account immediately. You can also revoke access from Slack directly, under your workspace's app management settings.
Troubleshooting
The Slack card is not visible. Contact your Hatz representative to turn on the Slack integration for your account.
Slack showed an approval request instead of installing. Your workspace requires admin approval for new apps. A Slack admin approves Hatz AI for Slack once, then everyone can connect.
Connecting says the app isn't installed. Install Hatz AI for Slack in your workspace first, using the link in Install Hatz AI for Slack above.
The card shows Needs Authentication. Your Slack authorisation expired or was revoked. Click Connect and approve again.
Hatz cannot find a channel you expect. Hatz sees only what your Slack account sees. Confirm you are a member of the channel in Slack.
An action did not work. Some actions depend on your own Slack permissions — for example, workspaces can restrict who may create channels. If Slack would block you from doing it yourself, it blocks Hatz acting as you.
Getting help
Chat with Lark Meeper, our support agent, on any page of the Hatz Help Center — open the chat from the bottom of the screen. You do not need an account to reach us, and you can start a conversation without leaving the page you are reading.
Reference links