[Admin Assistant] Task 8: Real-time Notifications (Telegram Integration)

[jsirish]

Overview

Implement real-time notification system with Telegram integration for urgent alerts and time-sensitive items.

Requirements

Notification Channels

Primary: Telegram (via OpenClaw message tool)
Secondary: Email (for non-urgent summaries)
Optional: SMS (via Twilio, for critical only)

Alert Categories & Priorities

Priority	Category	Response Time	Examples
🔴 Critical	Immediate (< 5 min)	Meeting in <15 min, System down, Emergency
🟠 Urgent	< 30 minutes	Meeting in 30 min, Urgent email, Overdue task
🟡 Normal	< 2 hours	Deal closing soon, Pipeline bottleneck
🟢 Info	Next briefing	New newsletter, FYI notifications

Notification Templates

Meeting Reminder:

⏰ Meeting in 30 minutes

📅 [Title]
🕐 [Time]
📍 [Location/Link]
👥 [Attendees]

Urgent Email:

📧 Urgent Email from [Sender]

Subject: [Subject]
Received: [Time]
Priority: [Reason]

[Preview text...]

Pipeline Alert:

🤖 Pipeline Bottleneck

Phase: [Phase name]
Count: [X] issues (threshold: [Y])

Top issue: #[number] - [title]

Task Overdue:

✅ Task Overdue

[Task title]
Project: [Project name]
Overdue: [X] days
Priority: [High/Medium/Low]

Notification Preferences

Configuration:

notifications:
  telegram:
    enabled: true
    chat_id: "5987965246"
    quiet_hours:
      start: "22:00"
      end: "07:00"
  email:
    enabled: true
    address: "jsirish@agentmail.to"
  sms:
    enabled: false
    number: "+1-XXX-XXX-XXXX"
    only_critical: true

alerts:
  meeting_minutes_before: [30, 15]
  email_urgent_threshold_minutes: 15
  task_overdue_alert: true
  pipeline_bottleneck_threshold: 5

Quiet Hours

Rules:

• 10:00 PM - 7:00 AM: Only critical alerts
• Weekends: Only urgent+ (configurable)
• Holidays: Only critical (configurable)
• Override for specific contacts (family, key clients)

Notification History

Track:

• All notifications sent
• Delivery status
• User responses (if interactive)
• Dismissed alerts
• Follow-up actions

Deliverables

• Telegram integration
• Alert prioritization logic
• Notification templates
• Quiet hours enforcement
• Notification history
• Preference management

Acceptance Criteria

• Alerts delivered reliably
• Priorities respected
• Quiet hours enforced
• Templates clear and concise
• History tracked
• Preferences configurable

Technical Notes

• Use OpenClaw message tool for Telegram
• Store preferences in memory/notification-prefs.json
• Log all notifications in memory/notification-log.json
• Rate limit to avoid spam
• Support interactive buttons (acknowledge, snooze, dismiss)

Relates to #182