Notifications

Stay in the loop with real-time alerts for tasks, emails, and agent activity.

Overview

Delegated sends notifications when important things happen — tasks completing, emails arriving, the agent flagging an issue. You choose where notifications go and which events trigger them.

Notification Channels

The most popular notification channel. Get push notifications on your phone instantly.

Setup:

Open your Delegated dashboard and go to Settings → Notifications
Click Connect Telegram
You'll receive a link to start a conversation with your Delegated bot
Send /start to the bot — your Telegram chat ID is now linked

Or configure via API:

POST /api/notifications/configure
{
  "channel": "telegram",
  "events": ["task.started", "task.completed", "task.failed", "email.urgent"],
  "chat_id": "YOUR_TELEGRAM_CHAT_ID"
}

Tip: Telegram notifications support rich formatting — you'll get task titles, durations, and results formatted nicely with emoji indicators.

Email Notifications

Get digest emails or instant alerts sent to your inbox. Useful for less urgent updates that don't need a push notification.

Configure in Settings → Notifications → Email. You can choose between:

Instant — One email per event
Hourly digest — Batched summary every hour
Daily digest — End-of-day summary

In-App Notifications

A notification bell in the dashboard header shows unread alerts. Click to see recent events. These are always enabled and require no configuration.

Event Types

Event	Description	Default
`task.started`	Agent picks up a task from TODO	Off
`task.completed`	Agent finishes a task successfully	On
`task.failed`	Task fails or gets blocked	On
`email.received`	New email detected via IMAP	Off
`email.urgent`	Agent flags an email as urgent	On
`agent.alert`	Agent proactively flags an issue	On
`order.new`	New Shopify order received	Off
`integration.error`	An integration connection fails	On

Notification Preferences

You can fine-tune notifications per channel and per event type. For example:

Telegram: only task.completed and task.failed
Email: daily digest of all events
In-app: everything

Quiet hours: By default, non-urgent notifications are suppressed between 23:00–08:00 (your timezone). You can adjust or disable this in Settings.

Example Notifications

✅ Task completed: "Generate weekly ad creatives"
   Duration: 8m 23s
   Result: 5 ad variations saved to /ads/spring-2026/

⚠️ Task failed: "Update product prices"
   Error: Shopify API rate limit exceeded
   Retry: Scheduled in 15 minutes

📧 Urgent email from: supplier@example.com
   Subject: "Order #4521 shipping delay"
   Agent summary: Supplier reports 3-day delay on bulk order

Next Steps

Integrations — Connect Shopify, email, and more
Webhooks — Build custom notification handlers
Dashboard Chat — Get updates via conversation