Уведомления
Настройте уведомления о статусе выполнения задач через Email, MAX или Webhook.
Эндпоинты
/notifications/settingsТекущие настройки уведомлений
/notifications/settingsОбновление настроек
/notifications/chat-linksКод для привязки чата через бота CronBox
/notifications/chat-discoveryЧаты, которые видит ваш собственный бот
/notifications/testТестовое уведомление в выбранный канал
Каналы уведомлений
Уведомления отправляются на указанные email-адреса.
{
"email_enabled": true,
"email_addresses": ["alerts@example.com"]
}MAX
Подключите бота в мессенджере MAX для мгновенных уведомлений. Для привязки чата получите код через POST /notifications/chat-links ({"channel": "max"}) и отправьте боту команду /link КОД. Свой бот из @MasterBot подключается через max_bot_token. Токен хранится зашифрованным и не возвращается в ответах API. POST /notifications/chat-discovery возвращает все диалоги и группы, в которых состоит бот.
{
"max_enabled": true,
"max_chat_ids": ["123456789"] // только привязанные через бота (или любые — для своего бота)
}Webhook
Отправляйте уведомления на ваш сервер в формате JSON. Секрет передаётся в заголовке X-Webhook-Secret. Он write-only: в ответах возвращается только webhook_secret_set: true|false. Сгенерировать новый секрет можно через POST /notifications/webhook-secret/regenerate — значение возвращается один раз.
{
"webhook_enabled": true,
"webhook_url": "https://your-server.com/cronbox-webhook",
"webhook_secret": "секрет для подписи запросов"
}Типы событий
Общие настройки определяют, о каких событиях уведомлять во все включённые каналы.
{
"notify_on_failure": true,
"notify_on_recovery": true,
"notify_on_success": false
}Для Heartbeat в режиме «Получение сигнала» событие heartbeat.signal включается выбором режима. Переключатели ошибок, восстановления и успешного выполнения не отключают его: используются включённые каналы и интервал signal_cooldown отдельно для каждого сообщения.