> ## Documentation Index
> Fetch the complete documentation index at: https://docs.steadwing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Connect Slack to Steadwing so your team receives instant incident alerts and can trigger AI-powered root cause analysis by @mentioning the Steadwing bot in any channel.

## What does the Slack integration do?

The Slack integration lets your team receive real-time incident alerts and trigger AI-powered root cause analysis directly from Slack -- without switching tools. Steadwing's Slack bot posts incident notifications, accepts @mention commands to start RCA, and delivers threaded results so your team can collaborate on resolution in the same channel where the alert appeared.

## Why Use Slack with Steadwing?

<CardGroup cols={2}>
  <Card title="Instant Notifications" icon="bell">
    Get immediate alerts when incidents occur in your preferred Slack channel
  </Card>

  <Card title="Direct Incident Management" icon="terminal">
    Trigger RCA and manage incidents by simply tagging @Steadwing
  </Card>

  <Card title="Team Collaboration" icon="users">
    Keep your entire team informed with threaded incident updates
  </Card>

  <Card title="Contextual Updates" icon="message-square">
    Receive detailed RCA results and solutions directly in Slack threads
  </Card>
</CardGroup>

## How do I connect Slack to Steadwing?

### Step 1: Connect Slack OAuth

1. Navigate to [Steadwing Settings](https://app.steadwing.com/settings)
2. Find the **Slack** integration card
3. Click the **Connect** button
4. You will be redirected to Slack's authorization page
5. Select the workspace where you want to install Steadwing
6. Click **Allow** to authorize the Steadwing app

### Step 2: Install Steadwing Slack App

After completing OAuth, you need to install the Steadwing Slack App in your workspace:

1. Follow the installation link provided in the settings page (Step 2)
2. Select the channels where you want Steadwing to be active
3. Click **Allow** to complete the installation
4. The Steadwing bot will now appear in your selected channels

## How do I use the Slack integration?

### Conversational Follow-up

After the RCA is completed, you can continue the conversation with Steadwing by tagging the bot in follow-up messages:

* Ask clarifying questions about the root cause
* Request additional details about suggested solutions
* Inquire about alternative approaches or fixes
* Get explanations about specific technical aspects

Simply @mention Steadwing in the thread and ask your question. The bot will respond with context-aware answers based on the completed RCA.

**Example:**

```text theme={null}
Alert: CPU usage at 95% on production server
✅ Steadwing: RCA complete! Found root cause: Recent deployment increased background job frequency
└─ Developer: @Steadwing What's the best way to throttle these background jobs?
   └─ Steadwing: You can implement rate limiting by adding a job queue with concurrency controls...
```

### Triggering Root Cause Analysis

When an alert appears in your Slack channel:

1. Reply to the alert message in a thread
2. Tag `@Steadwing` in your reply
3. Steadwing will acknowledge with a 👀 reaction and post: "Incident created! View it here: \[link]"
4. Once RCA completes, you'll see a ✅ reaction and Steadwing will notify you in the same thread
5. Click the provided link to view detailed results and suggested solutions

**Example:**

```text theme={null}
Alert: CPU usage at 95% on production server
└─ You: @Steadwing please analyze
   👀 Steadwing: Incident created! View it here: https://app.steadwing.com/incidents/123
      ✅ └─ Steadwing: RCA complete! Found root cause: Recent deployment increased background job frequency
```

### Receiving Notifications

Steadwing will automatically post to your Slack channel when:

* An incident is created
* RCA analysis is complete
* Remediation actions are suggested
* Incident status changes

### Automatic Monitoring Bot Analysis

Steadwing can automatically analyze error messages from your existing monitoring tools like Sentry, Datadog, or PagerDuty - no @mention needed.

**How it works:**

When enabled, Steadwing will automatically detect and analyze error messages posted by monitoring bots in channels where the Steadwing bot is installed. Simply enable this feature in your settings, and Steadwing will:

* Monitor messages from bot accounts (like Sentry, Datadog, PagerDuty)
* Automatically create incidents and perform RCA when errors are detected
* Skip human messages and thread replies to focus on new alerts
* Process up to 10 bot messages per hour to prevent alert fatigue

Automatic monitoring bot analysis means you get instant root cause analysis without having to manually tag @Steadwing every time an alert comes in -- your monitoring tools and Steadwing work together seamlessly.

## What permissions does the Slack integration need?

### Required Permissions

The Slack integration requires the following permissions:

* `channels:read` - To read channel information
* `chat:write` - To send messages and incident updates
* `users:read` - To identify team members
* `app_mentions:read` - To detect when @Steadwing is mentioned

### Supported Channels

* Public channels
* Private channels (if Steadwing is explicitly invited)
* Shared channels (with limitations)

## FAQs

<AccordionGroup>
  <Accordion title="Why do I need to complete Step 2 separately?">
    OAuth (Step 1) authorizes Steadwing to access your workspace, but the Slack App installation (Step 2) is required to add the bot to specific channels and enable interactive features.
  </Accordion>

  <Accordion title="Can I use Steadwing in private channels?">
    Yes, but you need to explicitly invite the Steadwing bot to private channels using `/invite @Steadwing`.
  </Accordion>

  <Accordion title="What happens if I don't tag Steadwing on an alert?">
    Steadwing only analyzes alerts when explicitly tagged. Untagged alerts will not trigger automatic RCA.
  </Accordion>

  <Accordion title="Can multiple team members tag Steadwing on the same alert?">
    Yes, but Steadwing will only create one incident per alert. Subsequent tags on the same alert will reference the existing incident.
  </Accordion>

  <Accordion title="How do I disconnect the Slack integration?">
    Go to [Settings](https://app.steadwing.com/settings), find the Slack integration, and click **Disconnect**. You should also uninstall the Steadwing app from your Slack workspace settings.
  </Accordion>
</AccordionGroup>

Need additional help? Please reach out to us at [hello@steadwing.com](mailto:hello@steadwing.com)