Уведомления
Настройте уведомления о статусе выполнения задач через Email, Telegram, MAX или Webhook.
Эндпоинты
/notifications/settingsТекущие настройки уведомлений
/notifications/settingsОбновление настроек
/notifications/chat-linksКод для привязки чата через бота CronBox
/notifications/chat-discoveryЧаты, которые видит ваш собственный бот
/notifications/testТестовое уведомление в выбранный канал
Каналы уведомлений
Уведомления отправляются на указанные email-адреса.
{
"email_enabled": true,
"email_addresses": ["alerts@example.com"]
}Telegram
Подключите Telegram-бота для мгновенных уведомлений. Чат привязывается через бота: получите код (POST /notifications/chat-links с {"channel": "telegram"}или кнопка «Привязать чат» в панели) и отправьте боту /link КОД из нужного чата или группы. Через бота CronBox chat_id вручную добавить нельзя — только удалить из списка.
{
"telegram_enabled": true,
"telegram_chat_ids": ["123456789"] // только привязанные через бота
}Свой бот. Уведомления могут уходить от вашего бота, созданного в @BotFather: передайте токен в telegram_bot_token. Сервер проверит его через getMe, сохранит зашифрованным и вернёт только telegram_bot_token_set и telegram_bot_username. Для своего бота chat_id указываются напрямую в telegram_chat_ids, а POST /notifications/chat-discovery подскажет ID чатов, которые недавно писали боту. Пустая строка в telegram_bot_token возвращает бота CronBox. Уведомления через собственного бота доступны на любом тарифе, включая бесплатный: тариф ограничивает только использование ботов CronBox.
{
"telegram_bot_token": "123456789:AAE...", // write-only
"telegram_chat_ids": ["-1001234567890"] // любые чаты вашего бота
}MAX
Подключите бота в мессенджере MAX для мгновенных уведомлений. Привязка чата аналогична Telegram: код из POST /notifications/chat-links ({"channel": "max"}) и команда /link КОД боту. Свой бот из @MasterBot подключается через max_bot_token так же, как в Telegram; chat-discovery для MAX возвращает все диалоги и группы, в которых состоит бот.
{
"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
}