📲 Telegram уведомления

Настройка мгновенных уведомлений о событиях через Telegram-бота.

🔧 Подключение бота

  1. Создать бота

    Откройте @BotFather в Telegram и создайте нового бота командой /newbot

  2. Получить токен

    BotFather вернёт токен вида 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

  3. Создать группу/канал

    Создайте группу или канал и добавьте бота как администратора

  4. Получить Chat ID

    Используйте @userinfobot или API для получения ID чата

  5. Настроить в OKITO

    Введите токен и Chat ID в настройках камеры → Alerts

Chat ID группы отрицательный: -1001234567890
Chat ID лички положительный: 123456789

⚙️ Настройки

Основные параметры

Параметр Описание По умолчанию
Enable Telegram Alerts Включить отправку уведомлений Off
Bot Token Токен бота от BotFather —
Chat ID ID чата/группы для отправки —
Cooldown (sec) Мин. время между уведомлениями одного типа 60
Batch (sec) Окно группировки событий одного типа 5
Cooldown — это ограничение частоты отправки Telegram, а не таймер отсутствия на рабочем месте. Для Workplace используйте Absence alert after (sec).

Группировка событий (Batch)

Если несколько событий одного типа происходят в течение Batch (sec) секунд, они объединяются в одно сообщение:

🤖
OKITO Bot
14:25:33
📱 Телефон × 3
📍 Камера: Офис вход
⏰ 14:25:30 — 14:25:33
🎯 Уверенность: 85-92%

События workplace_absence и workplace_return всегда отправляются отдельно.

📸 Скриншоты

К каждому уведомлению прикрепляются скриншоты с камеры.

Параметры скриншотов

Параметр Описание По умолчанию
Before Количество кадров до события 2
After Количество кадров после события 2
Interval Интервал между скриншотами (сек) 3
Width Ширина скриншота (px) 640
Height Высота скриншота (px) 480

📋 Формат уведомлений

🤖
OKITO Bot
14:25:33
🚨 #smoking
📍 Камера: Офис вход
⏰ 14:25:33
🎯 Уверенность: 87%

Элементы сообщения

Элемент Описание
🚨 / 📱 / ✓ Иконка типа события
#smoking Хэштег класса детекции
📍 Камера Имя камеры
⏰ Время Время события (HH:MM:SS)
🎯 Уверенность Confidence в процентах