Slack Integration Guide
Real-time uptime monitoring for everyone
Step-by-Step Connection
Connect SitePulse to your Slack workspace in under two minutes. Follow these steps to authorize the bot and route alerts to your preferred channels.
1. Generate Your Webhook URL
Navigate to Project Settings > Integrations in your SitePulse dashboard. Click "Create New Slack Webhook" and copy the unique endpoint provided.
2. Authorize in Slack
Open your Slack workspace and visit the URL copied above. Click "Allow" when prompted to grant SitePulse permission to post messages and manage channel access.
3. Verify Connection
Return to the SitePulse integration panel and click "Test Connection". A verification message from the SitePulse Bot will appear in your selected channel within 10 seconds.
Channel Selection & Message Formatting
Tailor your alert delivery to match your team's workflow. SitePulse supports granular routing and customizable payload structures.
Route Alerts by Severity
Assign critical outages to #ops-critical and routine maintenance notices to #general-status. Use the channel mapping table in your integration settings to define exact routing rules.
Customize Payload Fields
Edit the message template to include incident IDs, affected endpoints, and recovery ETA. Supported variables include {{incident_id}}, {{endpoint_url}}, {{status_code}}, and {{downtime_duration}}.
Enable Interactive Buttons
Activate the "Acknowledge Alert" and "View Dashboard" buttons directly in Slack. These trigger predefined actions in your SitePulse account without leaving the chat interface.
All formatting changes sync instantly across your workspace. Changes to webhook permissions or channel visibility require an admin approval in your Slack workspace settings.
Common Issues & Resolutions
If your Slack alerts are delayed, missing, or failing to render, check these frequent configuration mismatches.
Bot Missing Channel Access
The SitePulse Bot cannot post to private channels by default. Add the bot to the target channel using /invite @sitepulse-bot or adjust your workspace's app permission settings.
Webhook 403 Forbidden Error
This typically indicates an expired or revoked OAuth token. Regenerate your webhook URL in SitePulse and re-authorize the app in your Slack workspace admin console.
Formatting Variables Not Rendering
Ensure your template uses exact double-brace syntax. Custom fields must be published in the endpoint configuration before they appear in Slack payloads.
Still experiencing issues? Contact our support team at support@sitepulse.io with your workspace ID and the last three characters of your webhook URL for expedited review.