Slack Integration

Connect Slack to work with Autoheal directly from your workspace. You can message it privately, @mention it in a channel, and receive alert and investigation updates. Autoheal answers conversationally by default. It starts a full investigation when you ask it to look into something.

Capabilities

Once connected, agents can:

Capability	Description
Direct-message chat	DM the Autoheal bot for a private, persistent chat session — ask questions, query data, get help
@Mention in channels	Mention the bot in any channel. It replies in a thread and can escalate to a full investigation
Agent-decided investigations	Ask it to investigate / look into / find the root cause and it starts a real investigation, threading results back to where you asked
About tab	The app's About tab describes what Autoheal does and how to work with it
Welcome message	Teammates you invite to Autoheal get a one-time intro DM in Slack. Connecting Slack also welcomes your existing teammates (with an opt-out). Only people on your Autoheal team are messaged — never your whole Slack workspace
New chat	In a DM, each message you send starts its own chat, and Autoheal replies in that thread. To start fresh, send a new message
Alert & investigation notifications	Receive alerts, investigation updates, and root-cause cards in Slack
Answer the agent in Slack	When an investigation needs your input, its question posts as an interactive card. Pick an option, multi-select, Skip, or Write your own… for a free-text reply. Answering resumes the run automatically
Decide hypotheses in-thread	Root-cause cards carry 👍 Accept / 💬 Refine / 👎 Dismiss on each hypothesis. Accept and Dismiss are recorded straight from Slack. Refine opens the hypothesis's open questions in Autoheal so you can answer them
Progress indicator	A "Working on it…" message posts the moment Autoheal receives your request, then edits itself into the answer when the agent replies
Shareable deep links	Every chat and investigation carries a link back to the Autoheal web app

note

Write tools on this integration are available only to agents granted write access to it. These tools send, update, and pin messages, add reactions and bookmarks, create, join, and archive channels, and invite users. A governance policy on write operations pauses each write for a person to approve, and every call is recorded in the Audit Trail.

Prerequisites

• A Slack workspace where you have permission to install apps
• Admin or owner permissions to authorize the Autoheal Slack app

Setup

1

Connect to Slack

1. Go to Integrations in Autoheal
2. Click Slack
3. Click the Connect to Slack button
4. Authorize the Autoheal app in your Slack workspace

2

Say hi in a DM

1. Open a direct message with the Autoheal app (find it under Apps in your Slack sidebar)
2. Send a message like hi — Autoheal replies in a private, persistent chat session
3. Check the app's About tab for a quick overview of what it can do

3

Invite the Bot to channels (optional)

1. Open any channel where you want Autoheal to help
2. Type /invite @Autoheal or mention @Autoheal
3. The bot joins and is ready to respond in that channel

note

Already connected before these features shipped? Re-authorize the Slack app so Autoheal can get the newer permissions that direct messages need. In Autoheal go to Integrations → Slack and run Connect to Slack again for the same workspace. It re-authorizes in place (no duplicate). Your existing connection keeps working. Reconnecting just grants the added scopes and welcomes your team.

How It Works

• In a DM: each message you send starts its own chat, and Autoheal replies in a thread under it. This matches the channel behavior. Reply within that thread to continue the conversation. Send a new top-level message to start fresh. No @mention needed.
• In a channel: @mention the bot with your question. It replies in a thread. Each thread is its own session.
• Investigations: when you ask Autoheal to investigate, look into, or find the root cause of something, it starts a full investigation. It threads the hypotheses, findings, and root-cause card back to where you asked.
• Acknowledgement: Autoheal posts a "Working on it…" message the instant it receives your request. It then edits that same message into the answer, so you always know it's working.
• Starting fresh: just send a new top-level message. It starts a new chat in its own thread. Your previous threads stay saved and linkable.

Usage Examples

In a direct message (no mention needed):

which services are erroring right now?

investigate why the checkout service is returning 500s

In a channel where the bot is present:

@Autoheal look into high latency on the payments API

@Autoheal what changed in the last deployment?

@Autoheal who is on call for the platform team?

Best Practices

Dedicated Channels

Create dedicated channels for Autoheal investigations (e.g., #autoheal-investigations) to keep your main channels clean while maintaining visibility into ongoing investigations.

Incident Channels

Invite the Autoheal bot to your incident response channels so it can assist during active incidents with real-time investigation capabilities.

Thread Conversations

Use Slack threads for follow-up questions to keep conversations organized and maintain context for Autoheal.

Troubleshooting

Bot Not Responding

• In a channel, check that the bot is invited and that you used @Autoheal (with the @ mention)
• In a DM, message the bot directly. No mention is needed
• Check that the Slack integration shows as Connected in Autoheal
• Try re-authorizing the Slack app if the issue persists

Can't Message the Bot in a DM

• If the DM composer is disabled ("Sending messages to this app has been turned off"), the app's Messages tab isn't enabled. An admin must re-authorize / reinstall the app so the latest configuration applies
• Re-authorizing also grants the direct-message permissions if you connected before those features shipped

Authorization Failed

• Check that you have admin or owner permissions in the Slack workspace
• Check that third-party app installations are allowed in your workspace settings
• Contact your Slack workspace admin if app installations are restricted

Notifications Not Arriving

• Check that the bot is present in the target channel
• Check that the Slack integration is enabled (not disabled) in Autoheal
• Check that Slack notification settings are not muting the bot