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

# Slack Integration

> Send StatusStack alerts to Slack channels

## Overview

The Slack integration allows you to receive real-time StatusStack alerts directly in your Slack workspace with rich formatting, threading, and mentions.

***

## Setup Guide

<Steps>
  <Step title="Create Slack Webhook">
    In your Slack workspace:

    1. Go to [https://api.slack.com/apps](https://api.slack.com/apps)
    2. Click **"Create New App"** → **"From scratch"**
    3. Name it "StatusStack" and select your workspace
    4. Navigate to **Incoming Webhooks**
    5. Toggle **"Activate Incoming Webhooks"** to ON
    6. Click **"Add New Webhook to Workspace"**
    7. Select the channel (e.g., #alerts)
    8. Copy the webhook URL
  </Step>

  <Step title="Add to StatusStack">
    In StatusStack:

    1. Go to **Settings** → **Notifications**
    2. Click **"Create Notification Rule"**
    3. Select **Slack** as the channel
    4. Paste your webhook URL
    5. Optionally customize display name and icon
  </Step>

  <Step title="Test Integration">
    Click **"Send Test Notification"** to verify setup

    You should see a test message in your Slack channel
  </Step>
</Steps>

***

## Message Format

StatusStack sends rich Slack messages with:

* **Color-coded attachments** based on severity
* **Component information** and status
* **Timestamps** and duration
* **Quick links** to status pages
* **Thread support** for related updates

**Example Critical Alert:**

```
🔴 Production API is DOWN

Stack: Production Infrastructure
Component: Production API
Status: Critical
Duration: 5 minutes

View Details: https://statusstack.com/stacks/prod
```

***

## Advanced Configuration

### Channel Mentions

Mention users or groups for critical alerts:

```yaml theme={null}
@channel - Notify everyone in the channel
@here - Notify active users
@username - Mention specific user
```

Configure in notification rule settings.

### Threaded Alerts

Group related updates in threads:

* Initial alert creates parent message
* Status updates reply in thread
* Resolution posted to thread
* Keeps channel clean

Enable in **Settings** → **Slack** → **"Use Threads"**

***

## Best Practices

<AccordionGroup>
  <Accordion title="Create Dedicated Channels">
    **Don't spam #general:**

    ✅ Create channels:

    * \#statusstack-alerts (all alerts)
    * \#statusstack-critical (critical only)
    * \#client-alerts (client-facing)

    ❌ Avoid:

    * Sending to #general
    * Multiple alerts to same channel
  </Accordion>

  <Accordion title="Use Appropriate Mentions">
    **Match urgency to mention level:**

    * @channel: Critical production outages
    * @here: Degraded services during business hours
    * No mention: Info updates, resolutions
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

### Messages Not Appearing

**Check:**

1. Webhook URL is correct
2. Channel still exists
3. Bot has permissions
4. Notification rule is active

### Rate Limiting

Slack limits: 1 message/second

StatusStack automatically:

* Queues messages
* Respects rate limits
* Retries failures

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Notification Setup" icon="bell" href="/guides/notification-setup">
    Configure notification rules
  </Card>

  <Card title="Discord Integration" icon="discord" href="/integrations/discord">
    Alternative to Slack
  </Card>
</CardGroup>