Skip to main content

Alert Channels

ChannelSetupWhat’s sent
SlackProvide an incoming webhook URLError title, severity, AI triage summary, link to dashboard
DiscordProvide a webhook URLSame as Slack
WebhookAny HTTP endpointJSON payload with full error details
EmailList of recipient addressesHTML email with error summary

Creating Alert Rules

Go to Dashboard > Alerts > Create Alert Rule. Each rule has:
  • Name — descriptive label for the rule
  • Channel — where to send the notification
  • Conditions — when to trigger

Conditions

ConditionDescription
new_errorsTrigger only for new error groups (not repeat events)
event_thresholdTrigger when event count exceeds N in the current period
severityOnly trigger for specific AI triage severities (critical, high, etc.)
environmentsOnly trigger for specific environments (production, staging)

Webhook Payload

When using a webhook channel, Squasher sends a POST request with this JSON body:
{
  "event": "error.new",
  "error_group": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "TypeError: Cannot read properties of undefined",
    "type": "TypeError",
    "level": "error",
    "status": "unresolved",
    "event_count": 1,
    "first_seen": "2024-01-15T10:30:00Z",
    "last_seen": "2024-01-15T10:30:00Z",
    "triage_summary": "API response returned null instead of expected array",
    "triage_severity": "medium",
    "triage_fix": "Add null check: data?.items?.map(...)"
  },
  "project": {
    "id": "proj_abc123",
    "name": "My App"
  },
  "dashboard_url": "https://app.squasher.ai/dashboard/errors/550e8400-..."
}
If you configured a secret on the webhook, Squasher includes it as the x-squasher-secret header so you can verify the request is authentic.

Testing Alerts

Use the Test button on any alert rule to send a test notification. This verifies your webhook URL, Slack channel, or email configuration is working.