Уведомления
Настройте уведомления о статусе выполнения задач через Email, Telegram, MAX или Webhook.
Эндпоинты
/notifications/settingsТекущие настройки уведомлений
/notifications/settingsОбновление настроек
Каналы уведомлений
Уведомления отправляются на указанные email-адреса.
{
"email_enabled": true,
"email_addresses": ["alerts@example.com"]
}Telegram
Подключите Telegram-бота для мгновенных уведомлений. Чат привязывается через бота: получите код (POST /notifications/chat-links с {"channel": "telegram"}или кнопка «Привязать чат» в панели) и отправьте боту /link КОД из нужного чата или группы. Вручную через PATCH chat_id добавить нельзя — только удалить из списка.
{
"telegram_enabled": true,
"telegram_chat_ids": ["123456789"] // только привязанные через бота
}MAX
Подключите бота в мессенджере MAX для мгновенных уведомлений. Привязка чата аналогична Telegram: код из POST /notifications/chat-links ({"channel": "max"}) и команда /link КОД боту.
{
"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
}