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:
- OAuth Channels (Recommended) - Connect your Slack workspace and select channels from a list
- 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
Connect Your Slack Workspace
- Go to statusfield.com/integrations
- Click the Slack card
- Click Connect Slack button
- Select your Slack workspace
- 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
Add a Channel
After connecting:
- Click Add Slack Integration button in the manage drawer
- Select "Add Channel" option
- Select desired channel from the list
- Click Add Channel button
- You can edit the channel name later in the manage drawer
You can add multiple channels and configure each one independently.
Test It Out
- Click the menu (⋮) next to your Slack integration
- Select Test Notification
- Check that the test message appears in your Slack channel
Configure Notifications
When adding a monitor for a service:
- Go to statusfield.com/notifications
- Find the service in the list
- 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
Create a Slack Webhook
In your Slack workspace:
- Go to https://api.slack.com/apps
- Click Create New App > From scratch
- Name it "Statusfield" and select your workspace
- Navigate to Slack Features > Incoming Webhooks and toggle it on
- Click Add New Webhook
- Select the channel
- Copy the webhook URL (starts with
https://hooks.slack.com/...)
Add Webhook to Statusfield
- Go to statusfield.com/integrations
- Click the Slack card
- Click Add Slack Integration button
- Select "Slack Webhook" option
- Enter a name (e.g., "#engineering-alerts")
- Paste the webhook URL
- Click Add Webhook button
Test It Out
- Click the menu (⋮) next to your Slack integration
- Select Test Notification
- 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:
- Open statusfield.com/integrations > Slack
- Click Disconnect next to the connected workspace
- 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:
- Click Connect Slack again
- Authorize the workspace
- 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
- Go to statusfield.com/integrations > Slack
- Click Connect Slack button
- Reauthorize the workspace
Security & Privacy
Permissions
Statusfield's Slack app requests minimal permissions:
channels:read- View public channel namesgroups:read- View private channel names (if invited)chat:write- Post messages to selected channelschat: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]