DocsPanel: Notifications

Panel Notifications

Use Dashboard → Notifications to control alerting for your workspace.

Backfill Finished

Enable this to get a notification when a backfill request reaches a terminal completion state.

Anchor: #backfill-finished

Delivery Failures

Enable this to get a notification when webhook delivery reaches final failure (no retries left).

Kvasyr dedupes delivery-failure notifications per subscription in a rolling window to prevent email/Telegram floods.

Anchor: #delivery-failures

Data Purge Warning

Enable this to get notified before retention-based purge.

The lead-time offset is configured by admins per plan, not via .env.

Anchor: #data-purge-warning

Channels

Supported channels:

  • Email
  • Telegram

Each notification type can be mapped to either channel.

Email Channel

Email channel sends to the account email on your user profile.

Use Test Email Channel to verify SMTP and recipient configuration.

Anchor: #email-channel

Telegram Channel

Telegram requires:

  • chat_id
  • bot token

Use Test Telegram Channel after setup.

Anchor: #telegram-channel

Telegram Chat ID

  1. Start a conversation with your bot in Telegram.
  2. Send at least one message (for example /start).
  3. Query updates:
curl -sS "https://api.telegram.org/bot<BOT_TOKEN>/getUpdates"
  1. Read message.chat.id from the response and use that as chat_id.

Anchor: #telegram-chat-id

Telegram Bot Token

  1. Open @BotFather in Telegram.
  2. Run /newbot and follow prompts.
  3. Copy the generated bot token.
  4. Paste into Kvasyr Notifications and save.

Anchor: #telegram-bot-token

Test Buttons

Use channel test buttons before enabling notification types in production.

Tests update channel status/error metadata shown on the Notifications page.

Dropped Notification Alerts

If a notification event is queued but its assigned channel is disabled or misconfigured at send time, Kvasyr drops that event and shows a warning block on the Notifications page with recent dropped items and reasons.

Dropped outbox items are retained for about 24 hours.

Admin Policy

Admins can edit Purge warning offset per plan under:

Admin → Plans

Offset must be lower than the plan’s effective retention window.

Anchor: #admin-policy

Panel: WebhooksOutages and Recovery