Documentation

Discord Webhook Alert Setup

Configure Discord webhook notifications for team monitoring

Route ChainRaven alerts to any Discord channel using Discord's built-in webhook system. Great for team monitoring — everyone on your server sees alerts as they happen.

What You'll Need

  • A Discord server where you have Manage Webhooks permission
  • A channel where you want to receive alerts (create a dedicated #contract-alerts channel for best results)

Step 1: Create a Discord Webhook

  1. Open your Discord server and navigate to the channel where you want alerts
  2. Right-click on the channel name and select Edit Channel
  3. Click Integrations in the left sidebar
  4. Click Webhooks, then New Webhook
  5. Give it a name (e.g., ChainRaven Alerts)
  6. Optionally set a custom avatar
  7. Click Copy Webhook URL, then Save Changes

Keep this URL secret. Anyone with the webhook URL can post to your channel.

The URL will look like:

https://discord.com/api/webhooks/1234567890/AbCdEfGhIjKlMnOpQrStUvWxYz

Step 2: Connect in ChainRaven

  1. Log in to your ChainRaven dashboard
  2. Go to Profile > Integrations
  3. In the Discord section, paste your webhook URL
  4. Click Connect Discord

You'll receive a welcome message in your Discord channel confirming the connection was successful.


Step 3: Enable Discord Alerts

  1. Go to Profile > Alert Preferences
  2. Expand each alert type you want sent to Discord
  3. Check the Discord checkbox
  4. Click Save Changes

Step 4: Test Your Setup

Click Send Test Message in the Discord Integrations section. A test alert should appear in your channel within a few seconds.


What Alerts Look Like

Discord alerts are delivered as rich embeds with:

ElementDetails
Severity barColor-coded left border (🔴 red = critical, 🟠 orange = high, 🟡 yellow = medium, 🔵 blue = low)
Event typeWhat was detected (ownership transfer, proxy upgrade, etc.)
Event detailsAddresses, amounts, and other event-specific information
ContractAddress and blockchain network
LinksTransaction on block explorer + ChainRaven dashboard
TimestampWhen the event was detected

Troubleshooting

Test message not appearing?

  1. Make sure you're looking at the correct channel
  2. The webhook may have been deleted in Discord — create a new one and reconnect
  3. Check Discord's system status at discordstatus.com

Alerts not sending?

  1. Go to Alert Preferences and verify Discord is checked for the alert types you want
  2. Review your cooldown settings — repeated alerts from the same contract may be blocked
  3. Send a test message to confirm the webhook connection is still valid
  4. Check Sent Alerts in your dashboard to see delivery status and any error messages

Invalid webhook URL error?

  • Make sure you copied the complete URL from Discord
  • The URL must start with https://discord.com/api/webhooks/
  • Regenerate the webhook in Discord and try again

Tips

  • Create a dedicated #contract-alerts channel — keeps alerts organized and separate from team chat
  • Set channel permissions to control which roles can see alerts (e.g., only devs and security team)
  • Customize the webhook avatar in Discord so alerts are visually distinct from other bots

Next Steps