Уведомления

Настройте уведомления о статусе выполнения задач через Email, Telegram, MAX или Webhook.

Эндпоинты

GET
/notifications/settings

Текущие настройки уведомлений

PATCH
/notifications/settings

Обновление настроек

POST
/notifications/chat-links

Код для привязки чата через бота CronBox

POST
/notifications/chat-discovery

Чаты, которые видит ваш собственный бот

POST
/notifications/test

Тестовое уведомление в выбранный канал

Каналы уведомлений

Email

Уведомления отправляются на указанные 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
}