Skip to main content

Discord Integration

Connect Pulsar to Discord for real-time alerts in your server.

Setup​

Step 1: Create a Discord Webhook​

  1. Open your Discord server
  2. Go to Server Settings → Integrations → Webhooks
  3. Click New Webhook
  4. Give it a name (e.g., "Pulsar Alerts")
  5. Select the channel for alerts
  6. Click Copy Webhook URL

Step 2: Create the channel in Pulsar​

  1. Go to Settings → Notification Channels → Create Channel
  2. Enter a Channel Name (for example "Dev Discord")
  3. Set Channel Type to Discord
  4. Paste the URL into Webhook URL
  5. Click Create

A channel sends nothing until it is attached to a site. Open the site in Pulsar, click Link Channel in the Notification Channels card and pick the channel. Repeat for every site that should alert there. Use the Test action on the channel row in Settings to send a test message.

Message Format​

Pulsar sends embedded messages with:

  • Color-coded status (red for down, green for up)
  • Site name and URL
  • Error details
  • Timestamp

Example Alert Message​

🔴 mystore.com is DOWN

Error: HTTP 503 Service Unavailable
Time: 2024-01-15 14:32:00 UTC

View in Pulsar →

Example Recovery Message​

🟢 mystore.com is UP

Downtime: 13 minutes
Time: 2024-01-15 14:45:00 UTC

View in Pulsar →

Channel Recommendations​

ChannelUse Case
#alertsAll Pulsar notifications
#opsOperations team alerts
#devDevelopment-related issues

Best Practices​

  1. Dedicated channel - Keep alerts separate from general chat
  2. Enable notifications - Configure Discord to notify for alert channels
  3. Use threads - Enable threading for related alerts
  4. Pin dashboard link - Pin the Pulsar dashboard URL in the channel

Troubleshooting​

Webhook Not Working​

  1. Verify the webhook URL is correct and complete
  2. Check if the webhook was deleted in Discord
  3. Ensure the channel still exists
  4. Send a Test from the channel row in Settings

Rate Limiting​

Discord has rate limits on webhooks. If you're hitting limits:

  • Consider using digest mode for non-critical alerts
  • Spread alerts across multiple channels/webhooks