Skip to main content

Slack Integration

Connect Slack to interact with Autoheal directly from your Slack workspace. When you @mention the Autoheal bot in any channel, it automatically creates an investigation and responds with insights.

Capabilities​

Once connected, the AI agent can:

CapabilityDescription
@Mention InvestigationsStart investigations by mentioning the bot in any channel
Alert NotificationsReceive investigation updates and alerts in Slack
Conversational InterfaceAsk follow-up questions directly in Slack threads
Channel IntegrationWorks in any channel where the bot is invited

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
Invite the Bot
  1. Open any Slack channel where you want to use Autoheal
  2. Type /invite @Autoheal or mention @Autoheal to invite the bot
  3. The bot will join the channel and be ready to respond
3
Test the Integration
  1. In a channel with the bot, type @Autoheal what can you do?
  2. The bot should respond with information about its capabilities

How It Works​

  1. Mention @Autoheal in any channel where the bot is present
  2. Include your question or describe the issue you want to investigate
  3. Autoheal automatically creates an investigation
  4. The bot replies with a link to the investigation and initial findings
  5. Continue the conversation in a thread for follow-up questions

Usage Examples​

In any Slack channel with the Autoheal bot, you can send messages like:

@Autoheal why is the checkout service returning 500 errors?
@Autoheal investigate 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 the AI agent.

Troubleshooting​

Bot Not Responding
  • Verify the bot has been invited to the channel
  • Check that the Slack integration shows as Connected in Autoheal
  • Ensure you are using @Autoheal (with the @ mention) to trigger the bot
  • Try re-authorizing the Slack app if the issue persists
Authorization Failed
  • Verify 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
  • Verify the Slack integration is enabled (not disabled) in Autoheal
  • Ensure Slack notification settings are not muting the bot