integrations
Updated January 13, 2025
Discord Integration
Send rich embed notifications to Discord channels for gaming and developer communities
Discord Integration
Connect StatusPageOne with Discord to receive beautifully formatted incident alerts using rich embeds. Perfect for gaming communities, developer teams, and organizations that use Discord for team communication.
Why Discord Integration?
✅ Benefits
- •Rich embed messages with colors, fields, and structured data
- •Visual color coding - red for incidents, green for recovery
- •Community-focused design perfect for gaming and developer teams
- •Unlimited notifications across all plan tiers
- •Easy setup with Discord's built-in webhook system
🎯 Perfect For
- •Gaming communities monitoring game servers and infrastructure
- •Developer teams using Discord for project communication
- •Open source projects with Discord-based communities
- •Small teams preferring Discord's interface over traditional chat
- •Community servers providing service status to members
Discord Message Format
StatusPageOne sends rich embed messages that display beautifully in Discord:
Incident Alert Example
🚨 Incident Alert in Discord
🚨 Monitor Alert: Game Server API
Monitor Game Server API is DOWN
URL:
Error:
Connection timeout after 30 seconds
Response Time:
30000ms
Status Code:
N/A
Region:
us-east-1
StatusPage One
Recovery Alert Example
✅ Recovery Alert in Discord
✅ Monitor Alert: Game Server API
Monitor Game Server API is UP
StatusPage One
Setup Guide
Step 1: Create a Discord Webhook
-
Open Your Discord Server
- Navigate to the channel where you want alerts
- Right-click the channel name
- Select Edit Channel
-
Create Webhook
- Go to the Integrations tab
- Click Create Webhook
- Give your webhook a name (e.g., "StatusPage Alerts")
- Optionally upload an avatar image
-
Copy Webhook URL
- Click Copy Webhook URL
- The URL format:
https://discord.com/api/webhooks/[ID]/[TOKEN] - Save this URL for StatusPageOne configuration
📋
Webhook URL Formats
Discord webhook URLs can use either format:
New format:
https://discord.com/api/webhooks/...Legacy format:
https://discordapp.com/api/webhooks/...Both formats are supported by StatusPageOne
Step 2: Configure in StatusPageOne
-
Access Integration Settings
- Go to your monitor in the StatusPageOne console
- Click the Integrations tab
- Select Add Integration
- Choose Discord from the integration types
-
Enter Webhook Configuration
Webhook URL * [Configuration field]
The webhook URL from your Discord channel settings
Integration Name [Configuration field]
Descriptive name to identify this integration
[Toggle to enable] Enable notifications
Step 3: Test the Integration
- Click Test Integration to send a sample embed to your Discord channel
- Check your Discord channel for the test message
- Verify the embed displays correctly with proper formatting
Step 4: Save and Activate
- Click Save Integration
- Confirm the integration shows as Active
- Your Discord channel will now receive incident notifications
Advanced Configuration
Multiple Discord Servers
Set up different Discord integrations for various communities or teams:
Game Server Status
Public channel for community members to monitor game server health
Channel: #server-status
Audience: All community members
Services: Game servers, matchmaking API
Development Team
Private channel for developer team infrastructure monitoring
Channel: #dev-alerts
Audience: Development team only
Services: CI/CD, staging environments
Admin Operations
Staff-only channel for critical infrastructure monitoring
Channel: #admin-ops
Audience: Server administrators
Services: Database, payment systems
Project Updates
Open source project monitoring for community contributors
Channel: #project-status
Audience: Contributors and maintainers
Services: Documentation, demo sites
Discord Bot Integration
For advanced setups, consider integrating with Discord bots:
Bot Enhancement Features
- • Auto-reactions: Bots can add reactions to alert messages for acknowledgment
- • Thread creation: Automatically create threads for incident discussion
- • Role mentions: Notify specific roles based on alert severity
- • Status commands: Query current system status via bot commands
- • Escalation workflows: Automatic escalation if alerts go unacknowledged
Message Customization
Discord Embed Features
StatusPageOne's Discord embeds include:
Embed Elements
Title: Alert type with emoji and monitor name
Description: Brief status summary
Color: Red (#FF0000) for incidents, green (#00FF00) for recovery
Fields: Structured incident data (URL, error, timing)
Timestamp: Incident time in ISO format
Footer: StatusPage One attribution
Visual Design
Mobile Optimized: Embeds display perfectly on Discord mobile
Inline Fields: Key information displayed in organized columns
Rich Formatting: Bold text and proper spacing for readability
Consistent Styling: Matches Discord's native embed appearance
Embed Field Structure
Incident Alert Fields
Primary Fields:
- • URL (full width)
- • Error message (full width)
Inline Fields:
- • Response Time
- • Status Code
- • Region
Integration Management
Monitoring Discord Integration Health
Track your Discord integration performance in the StatusPageOne console:
Health Metrics:
- • Delivery Status: Success/failure of recent notifications
- • Response Times: Discord API response performance
- • Error Tracking: Failed deliveries with specific error codes
- • Last Activity: Timestamp of last successful notification
Webhook Management
⚠️
Important: Webhook Security
- • Discord webhooks don't require authentication beyond the URL
- • Keep webhook URLs confidential - anyone with the URL can send messages
- • Delete webhooks from Discord if they're no longer needed
- • Regenerate webhooks if URLs are accidentally exposed
Troubleshooting
Common Issues
❌ Embeds Not Appearing
Webhook Problems:
- • Verify webhook URL is complete and unmodified
- • Check that webhook still exists in Discord channel settings
- • Ensure webhook has permission to post in the target channel
Channel Access:
- • Verify channel wasn't deleted or moved
- • Check if channel permissions changed
- • Ensure webhook wasn't deleted from Discord settings
⚠️ Formatting Issues
Embed Display:
- • Embeds may not display in all Discord clients (web, mobile, desktop)
- • Some fields may be truncated if content is too long
- • Color coding appears as a colored bar on the left side
🔧 API Errors
HTTP Status Codes:
- • 404: Webhook not found (deleted or invalid URL)
- • 401: Webhook token is invalid
- • 429: Rate limited (Discord API limits)
- • 500: Discord API temporary issues
Testing and Validation
🧪 Discord Integration Testing
1Use Test Integration to send a sample embed
2Check that embed appears in correct Discord channel
3Verify embed formatting, colors, and field layout
4Test on different Discord clients (web, desktop, mobile)
5Confirm community members can see the alerts
Best Practices
🎮 Discord Integration Best Practices
Community Management
- • Create dedicated status channels for different services
- • Use clear channel naming: #server-status, #api-alerts
- • Pin important status messages for visibility
- • Set channel permissions appropriately for your community
Alert Organization
- • Use descriptive monitor names that make sense to users
- • Set up separate channels for different service categories
- • Consider user roles and permissions for alert channels
- • Archive old alerts to keep channels organized
Team Coordination
- • Use thread replies for incident updates and discussion
- • Set up role mentions for critical alerts (@admins)
- • Create escalation procedures for unacknowledged alerts
- • Document incident response procedures in channel pins
Technical Setup
- • Test integrations after Discord server changes
- • Monitor webhook health in StatusPageOne console
- • Keep webhook URLs secure and private
- • Set up backup notification methods
Discord vs. Other Platforms
When to Choose Discord
Discord is Best For:
Community-Focused:
- • Gaming communities
- • Open source projects
- • Creator communities
- • Informal team environments
Visual Communication:
- • Rich embed formatting
- • Color-coded alerts
- • Community-friendly interface
- • Mobile-optimized display
Usage and Limits
Plan Limits
| Plan | Discord Notifications | Features |
|---|---|---|
| Free | Unlimited | Basic embeds |
| Pro | Unlimited | Rich embeds + custom formatting |
| Business | Unlimited | Priority delivery + analytics |
Rate Limiting
StatusPageOne respects Discord's API limits:
- Webhook rate limit: 30 requests per minute per webhook
- Automatic retry logic for temporary failures
- Delivery status tracking and error reporting
Community Use Cases
Gaming Communities
Minecraft Server Network
Monitor multiple game servers with dedicated status channels
• #survival-server-status
• #creative-server-status
• #network-status
Esports Organization
Track tournament infrastructure and streaming services
• Tournament servers
• Streaming infrastructure
• Website and registration systems
Developer Communities
Open Source Project
Keep contributors informed about project infrastructure health
• Documentation sites
• Demo environments
• CI/CD pipeline status
Developer Collective
Monitor shared resources and community tools
• Shared hosting services
• Community APIs
• Learning platform status
Next Steps
After setting up Discord integration:
- Configure Email Alerts - Add comprehensive incident documentation
- Set Up Webhooks - Enable automated responses
- Add Telegram Integration - Expand personal notification options
- Explore Monitoring Features - Optimize your monitoring strategy
Discord integration provides excellent community-focused incident communication. Combine with other channels for comprehensive coverage across your team and community.
Support
Need help with Discord integration?
- Verify webhook URL format and permissions
- Use integration test function to troubleshoot delivery
- Check Discord server settings if messages don't appear
- Contact support for persistent integration issues
Improve this page
Found an error or want to contribute? Edit this page on GitHub.