⚡ Smart Alerts

Intelligent notification filtering with grouping and spam protection.

🚨 Alert Types

🚨

Critical

Requires immediate attention

smoking fall

📱

Phone

Phone usage detection

on_phone phone_at_ear phone_in_hand

💼

Workplace

Workplace monitoring

workplace_absence workplace_return

🧍

Pose

Human pose detection

sitting standing walking

📦 Event Grouping

Multiple events of the same type within Batch (sec) seconds are grouped into a single notification.

Grouping Example


                            📱 Phone × 3

                            📍 Camera: Office Entrance

                            ⏰ 14:25:30 — 14:25:33

                            🎯 Confidence: 85-92%

Instead of 3 separate notifications, one message is sent indicating the number of events, time range, and confidence range.

workplace_absence and workplace_return events are always sent separately — they are not grouped.

⚙️ Parameters

Alert Settings

Parameter	Description	Default
`Cooldown (sec)`	Min time between same-type notifications	60
`Batch (sec)`	Event grouping window	5
`Before`	Screenshots before event	2
`After`	Screenshots after event	2
`Interval`	Interval between screenshots (sec)	3

🔄 Cooldown vs Batch

Difference

Parameter	Action	Example
`Cooldown`	Limits send frequency	Max 1 notification per 60 sec
`Batch`	Groups events into one	3 events in 5 sec → 1 notification

Cooldown is a Telegram limit, not an absence timer. For Workplace, use Absence alert after (sec).