PixoMonitorDocs

Discord Integration

Send PixoMonitor alerts directly to your Discord server. Perfect for development teams, gaming communities, or anyone who lives in Discord.

Overview

The Discord integration uses webhooks to deliver rich embed messages to any Discord channel. Alerts include:

  • Color-coded status — Red for down, green for up, orange for degraded
  • Monitor details — Name, URL, status, and error information
  • Timestamps — When the status change was detected
  • PixoMonitor branding — Easy identification in busy channels

Discord webhooks are perfect for team collaboration. Everyone in the channel sees alerts instantly without needing individual notification setup.

Setting Up Discord Alerts

1

Open Channel Settings

In your Discord server:

  1. Right-click the channel where you want alerts
  2. Select Edit Channel
  3. Click Integrations in the left sidebar
2

Create a Webhook

In the Integrations panel:

  1. Click Webhooks
  2. Click New Webhook
  3. Give it a name (e.g., "PixoMonitor Alerts")
  4. Optionally upload a custom avatar image
3

Copy the Webhook URL

Click Copy Webhook URL to save the URL. It looks like:

https://discord.com/api/webhooks/123456789/abcdefghijklmnop...

Keep this URL secure—anyone with it can post to your channel.

4

Add to PixoMonitor

In PixoMonitor, go to Settings → Alert Channels and click Add Alert Channel:

  • Name: A descriptive name (e.g., "Discord #alerts")
  • Type: Select Discord
  • Webhook URL: Paste your Discord webhook URL
  • Click Save
5

Assign to Monitors

Edit your monitors to add the new Discord alert channel. You can also set it as a default for all new monitors.

Alert Message Format

Discord alerts appear as rich embeds with color-coded borders:

DOWN Alert

🔴 Monitor Alert: MyWebsite

Status    DOWN
URL       https://mywebsite.com
Error     Connection timeout after 30000ms
Time      3/24/2026, 10:30:45 AM

PixoMonitor Monitoring

The embed has a red border indicating a critical alert.

UP (Recovery) Alert

✅ Monitor Alert: MyWebsite

Status    UP
URL       https://mywebsite.com
Time      3/24/2026, 10:35:12 AM

PixoMonitor Monitoring

The embed has a green border indicating recovery.

Degraded Alert

⚠️ Monitor Alert: MyWebsite

Status    DEGRADED
URL       https://mywebsite.com
Time      3/24/2026, 10:32:00 AM

PixoMonitor Monitoring

The embed has an orange border indicating a warning state.

Each alert includes a timestamp in the embed footer, making it easy to track when issues occurred.

Best Practices

Use a Dedicated Channel

Create a dedicated #monitoring or #alerts channel for PixoMonitor notifications. This:

  • Keeps alerts organized and easy to find
  • Allows team members to mute other channels without missing alerts
  • Provides a clear history of all status changes

Configure Discord Notifications

Set up Discord channel notification settings based on importance:

  • All messages: For critical production monitors
  • Only @mentions: For less critical monitors (you can @mention roles in custom webhooks)
  • Nothing: For logging purposes only

Organize by Server

If you manage multiple projects, consider:

  • Separate Discord servers for different clients or projects
  • Different channels within a server for different environments (production, staging)
  • Webhook naming that identifies the source clearly

Keep your webhook URL secret. Anyone with the URL can post messages to your channel. If compromised, delete the webhook and create a new one.

Multiple Discord Channels

You can create multiple Discord alert channels in PixoMonitor:

  • Send production alerts to a high-priority channel
  • Send development alerts to a team channel
  • Route different monitors to different servers entirely

Troubleshooting

Alerts Not Appearing

  1. Check webhook URL: Ensure it starts with https://discord.com/api/webhooks/
  2. Verify channel permissions: The webhook must have permission to post in the channel
  3. Test the webhook: Use PixoMonitor's Test button in alert channel settings
  4. Check Discord status: Discord might be experiencing issues

"Unknown Webhook" Error

The webhook was deleted from Discord. Create a new webhook and update the URL in PixoMonitor.

"Rate Limited" Issues

Discord has rate limits on webhooks. If sending many alerts:

  • Increase alert cooldown settings in PixoMonitor
  • Consider consolidating non-critical monitors
  • Use fewer, more critical monitors per channel

Webhook Shows Wrong Name/Avatar

The webhook name and avatar are set in Discord's webhook settings, not in PixoMonitor. To change them:

  1. Go to your Discord channel settings
  2. Navigate to Integrations → Webhooks
  3. Edit the webhook's name and avatar

Security Considerations

  • URL protection: Treat webhook URLs like passwords—don't share them publicly
  • Channel visibility: Anyone in the Discord channel can see alerts
  • No authentication: Webhooks can't verify the sender, so keep URLs private
  • Audit trail: Discord logs all webhook messages, creating a record of alerts