Slack Integration

Receive service status notifications in your Slack workspace

Get instant notifications in your Slack workspace when monitored services experience issues. Perfect for keeping your team informed in real-time with collaborative incident response.

Overview

Statusfield supports two types of Slack integration:

  1. OAuth Channels (Recommended) - Connect your Slack workspace and select channels from a list
  2. Incoming Webhooks - Use Slack webhook URLs for simple one-way notifications

Which Method Should I Use?

OAuth is recommended for most users - it's easier to set up, more reliable, and allows you to pick channels from a list. Use webhooks only if you need to send notifications to external Slack workspaces you don't control.

Quick Start: OAuth Channels

1

Connect Your Slack Workspace

  1. Go to statusfield.com/integrations
  2. Click the Slack card
  3. Click Connect Slack button
  4. Select your Slack workspace
  5. Click Allow to grant Statusfield permissions

Permissions

Statusfield requests permission to:

  • View channel names and topics
  • Post messages to channels you select
  • No access to message history or DMs
2

Add a Channel

After connecting:

  1. Click Add Slack Integration button in the manage drawer
  2. Select "Add Channel" option
  3. Select desired channel from the list
  4. Click Add Channel button
  5. You can edit the channel name later in the manage drawer

You can add multiple channels and configure each one independently.

3

Test It Out

  1. Click the menu (⋮) next to your Slack integration
  2. Select Test Notification
  3. Check that the test message appears in your Slack channel
4

Configure Notifications

When adding a monitor for a service:

  1. Go to statusfield.com/notifications
  2. Find the service in the list
  3. Configure when you want to receive notifications (status by column)
  • On any status change
  • On maintenance status
  • On degraded status
  • On major outage status
  • On partial outage status

All statuses will notify you when the component went back to operational status.

Quick Start: Slack Webhooks

1

Create a Slack Webhook

In your Slack workspace:

  1. Go to https://api.slack.com/apps
  2. Click Create New App > From scratch
  3. Name it "Statusfield" and select your workspace
  4. Navigate to Slack Features > Incoming Webhooks and toggle it on
  5. Click Add New Webhook
  6. Select the channel
  7. Copy the webhook URL (starts with https://hooks.slack.com/...)
2

Add Webhook to Statusfield

  1. Go to statusfield.com/integrations
  2. Click the Slack card
  3. Click Add Slack Integration button
  4. Select "Slack Webhook" option
  5. Enter a name (e.g., "#engineering-alerts")
  6. Paste the webhook URL
  7. Click Add Webhook button
3

Test It Out

  1. Click the menu (⋮) next to your Slack integration
  2. Select Test Notification
  3. Check that the test message appears in your Slack channel

Slack Message Format

Each Slack notification includes:

  • Service name - Clear identification (e.g., "🔴 GitHub")
  • Status level - Current status with emoji indicator
    • 🟢 Operational
    • 🟡 Degraded
    • 🟠 Partial Outage
    • 🔴 Major Outage
    • 🔵 Maintenance
  • Affected components - List of impacted components
  • Timestamp - When the incident started
  • Link - Button linking to full incident details on Statusfield

Managing OAuth Connections

View Connected Workspace

In the Slack integrations drawer, you'll see:

  • Connected workspace name (e.g., "Connected to Acme Corp workspace")

Disconnect Workspace

To disconnect your Slack workspace:

  1. Open statusfield.com/integrations > Slack
  2. Click Disconnect next to the connected workspace
  3. Confirm the action

Warning

Disconnecting removes all OAuth channels and their notification rules. Everything is deleted. Webhooks are not affected.

Reconnect After Disconnection

If you disconnected or revoked access:

  1. Click Connect Slack again
  2. Authorize the workspace
  3. Re-add your channels

Your previous notification configuration won't be restored automatically.

Troubleshooting

Not Receiving Slack Notifications?

Common issues and solutions:

1. OAuth Connection Expired

Security & Privacy

Permissions

Statusfield's Slack app requests minimal permissions:

  • channels:read - View public channel names
  • groups:read - View private channel names (if invited)
  • chat:write - Post messages to selected channels
  • chat:write.public - Post to public channels without invitation

We never access:

  • Message history or content
  • Direct messages
  • User information
  • Files or attachments

Data Protection

  • OAuth tokens are encrypted in our database
  • Tokens are only used to post notifications, nothing else
  • Webhook URLs are stored securely
  • All Slack API calls use HTTPS

Need Help?

Contact our support team at [email protected]