Slack Integration

Connect StatusPageOne with Slack to get instant, beautifully formatted incident alerts directly in your team channels. Perfect for coordinating incident response and keeping your team informed.

Why Slack Integration?

Benefits

• Instant team notification in channels your team already monitors
• Rich formatting with color coding and structured incident data
• Team coordination through replies and reactions
• Channel history for incident timeline and post-mortem reviews
• Unlimited notifications on all plan tiers

Best For

• Development and DevOps teams
• Real-time incident response coordination
• Teams already using Slack for communication
• Organizations requiring immediate alert visibility

Quick Setup

Step 1: Create Slack Incoming Webhook

1. Access Slack App Directory

   • Go to your Slack workspace settings
   • Navigate to Apps → Browse App Directory
   • Search for "Incoming Webhooks"

2. Configure Incoming Webhook

   • Click Add to Slack
   • Choose the target channel (e.g., #alerts, #devops)
   • Customize webhook name and icon
   • Copy the webhook URL

Step 2: Configure in StatusPageOne

1. Access Integration Settings

   • Navigate to your status page
   • Click "Integrations" in the sidebar
   • Choose Slack from the integration list

2. Enter Webhook Configuration

Configure the following settings:

• Webhook URL (required): https://hooks.slack.com/services/...

  • The incoming webhook URL from your Slack workspace

• Channel (optional): #alerts

  • Override the default channel configured in the webhook

• Integration Name: DevOps Alerts Channel

  • Descriptive name to identify this integration

• Enable notifications: Toggle on to activate alerts

3. Test the Integration
   • Click "Test Integration"
   • Check your Slack channel for the test message
   • Verify formatting and channel delivery

Message Format

Incident Alert

{
  "text": "🚨 API Server is DOWN",
  "attachments": [
    {
      "color": "danger",
      "fields": [
        {
          "title": "Monitor",
          "value": "API Server",
          "short": true
        },
        {
          "title": "URL",
          "value": "https://api.example.com/health",
          "short": true
        },
        {
          "title": "Error",
          "value": "Connection timeout after 30 seconds",
          "short": false
        },
        {
          "title": "Region",
          "value": "us-east-1",
          "short": true
        },
        {
          "title": "Time",
          "value": "2024-01-15T10:30:15Z",
          "short": true
        }
      ]
    }
  ]
}

Recovery Alert

{
  "text": "✅ API Server is back UP",
  "attachments": [
    {
      "color": "good",
      "fields": [
        {
          "title": "Monitor",
          "value": "API Server",
          "short": true
        },
        {
          "title": "Response Time",
          "value": "187ms",
          "short": true
        },
        {
          "title": "Downtime",
          "value": "5 minutes 7 seconds",
          "short": true
        },
        {
          "title": "Status Code",
          "value": "200 OK",
          "short": true
        }
      ]
    }
  ]
}

Advanced Configuration

Multiple Channels Strategy

Channel-based Escalation:

• #alerts-low - Low priority incidents
• #alerts-high - High priority incidents
• #alerts-critical - Critical system failures

Set up separate integrations for each severity level to route alerts appropriately.

Custom Message Formatting

StatusPageOne supports Slack's rich formatting:

• Bold text for emphasis
• Code blocks for technical details

• Quoted text for context

• @channel mentions for critical alerts

Thread Management

Incident Threading:

• Initial alert creates new message
• Recovery notifications reply to original thread
• Keeps channel clean and organized
• Maintains incident timeline

Team Coordination Features

Built-in Actions

StatusPageOne Slack messages include:

• View Status Page - Direct link to public status
• View Monitor - Link to monitor details
• Acknowledge - Mark incident as acknowledged
• Escalate - Trigger additional notifications

Reaction-based Workflow

Establish team conventions:

• 👀 = "I'm investigating"
• ✅ = "Issue resolved"
• 🔥 = "All hands needed"
• 📋 = "Creating incident report"

Enterprise Use Cases

Multi-workspace Setup

For Large Organizations:

Workspace 1: Engineering Teams
├── #backend-alerts
├── #frontend-alerts
└── #platform-alerts

Workspace 2: Operations
├── #ops-notifications
├── #incident-response
└── #leadership-updates

Compliance Integration

SOC 2 / PCI Requirements:

• All alerts logged with timestamps
• Slack message history serves as audit trail
• Integration with incident response procedures
• Automatic documentation generation

Custom Webhook Handlers

Advanced Integration Example:

// Custom Slack webhook handler
app.post('/slack/statuspageone', (req, res) => {
  const { monitor, status, timestamp } = req.body;

  // Custom routing logic
  const channel = determineChannel(monitor.service);
  const mentions = status === 'DOWN' ? '@channel' : '';

  const slackPayload = {
    channel: channel,
    text: `${mentions} ${monitor.name} status: ${status}`,
    attachments: [{
      color: status === 'DOWN' ? 'danger' : 'good',
      fields: buildCustomFields(monitor)
    }]
  };

  // Forward to Slack
  await sendToSlack(slackPayload);
  res.json({ received: true });
});

Troubleshooting

Common Issues

Messages not appearing:

• Verify webhook URL is correct and active
• Check if webhook permissions include target channel
• Ensure StatusPageOne integration is enabled

Formatting problems:

• Slack webhook URLs must be active and valid
• Channel names require # prefix for overrides
• Test with simple message first

Performance considerations:

• Slack has rate limits (1 request per second per webhook)
• StatusPageOne handles retries automatically
• Monitor StatusPageOne logs for delivery status

Testing Tools

Manual webhook test:

curl -X POST "YOUR_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Test message from StatusPageOne",
    "attachments": [{
      "color": "warning",
      "text": "Integration test successful"
    }]
  }'

Rate Limits and Quotas

• Message rate: 1 message per second per webhook URL
• Attachment size: Up to 8KB per message
• Channel limits: No limit on number of channels
• Retry policy: Up to 5 retries with exponential backoff

Security Considerations

• Webhook URLs: Keep webhook URLs secure and private
• Channel permissions: Ensure appropriate team access to alert channels
• Message content: Sensitive data is not included in default alerts
• Access logs: Monitor integration access in StatusPageOne dashboard

Need help setting up your Slack integration? Check our troubleshooting guide or contact support.