Alert Notifications

Email Notifications

How It Works

When an alert triggers, an email is sent to your account email.

Email Contents

• Alert name
• Alert type
• Trigger time
• Metrics snapshot
• Link to dashboard

Managing Email Alerts

Each alert can have email notifications enabled or disabled independently.

Webhook Notifications (Enterprise)

How It Works

When an alert triggers, a POST request is sent to your webhook URL.

Webhook Payload

{
  "event": "qr.alert.scan_spike",
  "alert_id": "uuid",
  "alert_name": "High Traffic Alert",
  "alert_type": "scan_spike",
  "team_id": "uuid",
  "qr_id": "uuid or null",
  "triggered_at": "2024-01-15T10:30:00Z",
  "metrics": {
    "current_scans": 150,
    "threshold": 100,
    "timeframe": "5min"
  }
}

Webhook Events

• `qr.alert.scan_spike`
• `qr.alert.scan_drop`
• `qr.alert.limit_near`
• `qr.alert.limit_reached`
• `qr.alert.no_scans`
• `qr.alert.new_country`

Setting Up Webhooks

• Go to Settings and select Webhooks
• Add your webhook URL
• Enable alert events
• Test the webhook

Cooldown Period

To prevent notification spam:

• Alerts won't re-trigger during cooldown
• Default: 60 minutes
• Configurable per alert

Best Practices

• Set appropriate thresholds: Avoid too many alerts
• Use cooldowns wisely: Balance responsiveness and noise
• Monitor alert history: Tune based on patterns
• Test webhooks: Ensure integration works

Need to create a new alert? Follow our step-by-step guide.