Skip to main content

Notifications

Send real-time alerts to your team when a new error is captured or a new lead is submitted.

Supported Channels​

ChannelTrigger
SlackNew error (first occurrence or re-open), new lead
TelegramNew error, new lead
EmailNew error, new lead
Webhook (n8n)New error, new lead
In-app (WebSocket)New error, new lead

Configuration​

All notification settings are per-site, configured in Dashboard → Sites → [Site] → Settings.

Slack​

Slack Webhook URL: https://hooks.slack.com/services/T.../B.../...

Create the webhook in your Slack workspace: App Directory → Incoming Webhooks → Add to Slack.

Telegram​

Telegram Bot Token: 123456789:ABCDEF...
Telegram Chat ID:   -1001234567890
  1. Create a bot via @BotFather — save the token
  2. Add the bot to your group/channel
  3. Get the chat ID from https://api.telegram.org/bot<token>/getUpdates

Email​

Email Notify:       enabled
Notification Email: team@yourdomain.com

Requires SMTP_* environment variables to be set on the Platform server — see Configuration.

Webhook (n8n)​

n8n Error Webhook URL: https://n8n.yourdomain.com/webhook/...
n8n Leads Webhook URL: https://n8n.yourdomain.com/webhook/...

The Platform sends a POST request with a JSON payload. You can use n8n to route notifications to any other system (PagerDuty, Jira, WhatsApp, etc.).

Notification Logic​

  • New error: fires when an error is created for the first time (first occurrence)
  • Re-opened error: fires when an error previously marked resolved or ignored is received again
  • Errors marked muted: never trigger notifications, even on re-open
  • Errors marked ignored: do not trigger notifications after the initial one

Webhook Payload Format​

Error notification​

{
  "event": "new_error",
  "siteId": 1,
  "error": {
    "id": 42,
    "message": "Cannot read property 'x' of undefined",
    "source": "https://mysite.com/app.js",
    "status": "new",
    "occurrenceCount": 1,
    "firstSeenAt": "2024-01-15T10:00:00Z"
  }
}

Lead notification​

{
  "event": "new_lead",
  "siteId": 1,
  "lead": {
    "id": 17,
    "email": "customer@example.com",
    "firstName": "Jane",
    "cartTotal": "89.99",
    "capturedAt": "2024-01-15T10:05:00Z"
  }
}

In-App Real-Time Alerts​

The dashboard uses a WebSocket connection (Socket.IO) to push notifications in real time to any browser that has the dashboard open. Alerts appear as a toast notification in the top-right corner without requiring a page refresh.