Канали сповіщень

HelloCron може сповіщати вас про події моніторів (збої, пропущені виконання, таймаути, відновлення) через декілька каналів. Ви можете налаштувати будь-яку кількість каналів та обрати, які типи подій кожен канал отримує.

Усі канали керуються в панелі в розділі Settings -> Notification Channels. Кожен канал має кнопку Test, яка надсилає тестове сповіщення лише на цей канал, тож ви можете перевірити налаштування до того, як почнете на нього покладатись.

Email

Найпростіший канал. Залиште поле адреси порожнім, щоб використати email вашого облікового запису, або введіть іншу адресу (наприклад, псевдонім команди).

Telegram

Сповіщення в Telegram безкоштовні та миттєві, а підключення займає один клік.

1. У панелі додайте канал типу Telegram і натисніть Підключити Telegram.
2. Відскануйте QR-код телефоном (або натисніть Відкрити в Telegram) і натисніть Start у відкритому чаті. Для групи скористайтеся Додати до групи та виберіть групу.
3. Форма заповниться сама й покаже «Підключено». Збережіть канал і натисніть Test.

Сповіщення доставляє офіційний бот HelloCron. Без токенів, без chat ID, нічого не треба шукати.

Розширені: власний бот. Якщо хочете, щоб сповіщення надходили від бота під вашим контролем, розгорніть у формі Розширені: власний бот: створіть бота через @BotFather (/newbot, скопіюйте токен у форматі 123456789:AAF...), отримайте chat ID з https://api.telegram.org/bot<TOKEN>/getUpdates (ID груп від’ємні) і заповніть обидва поля. Канал із власним токеном завжди надсилає через цього бота. HelloCron зберігає токен лише для доставки й ніколи не пише його в логи.

Discord

Сповіщення в Discord використовують webhook-и каналу, бот не потрібен.

1. У Discord відкрийте налаштування потрібного каналу: Integrations -> Webhooks -> New Webhook.
2. Скопіюйте URL webhook-а (він починається з https://discord.com/api/webhooks/).
3. У панелі додайте канал типу Discord і вставте URL.
4. Натисніть Test. Сповіщення приходять як embed-и, зелені для відновлень і червоні для збоїв.

Slack

1. Створіть incoming webhook у вашому робочому просторі Slack.
2. У панелі додайте канал типу Slack і вставте URL webhook-а (починається з https://hooks.slack.com/services/).
3. Натисніть Test.

PagerDuty

Сповіщення PagerDuty використовують Events API v2: збої відкривають інциденти, а відновлення автоматично їх закривають.

1. У PagerDuty створіть сервіс (або відкрийте наявний) і додайте інтеграцію Events API v2: Service -> Integrations -> Add integration -> Events API v2.
2. Скопіюйте Integration Key (його також називають routing key, 32 символи).
3. У панелі додайте канал типу PagerDuty і вставте ключ.
4. Натисніть Test.

Як відображаються події:

• Failed, Missed і Timeout відкривають інцидент із рівнем critical; Degraded і Still failing використовують warning.
• Recovered закриває інцидент, відкритий для цього монітора, завдяки спільному ключу дедуплікації, тож нестабільний монітор ніколи не накопичує інциденти.
• Кожен інцидент містить посилання на монітор у панелі HelloCron.

Webhook

Надсилає JSON payload на будь-який HTTP ендпоінт, корисно для інтеграції з вашими власними системами, інструментами чергування (on-call) або автоматизацією.

{
  "id": 123,
  "type": "failed",
  "monitor_name": "db-backup",
  "message": "Monitor db-backup failed",
  "metadata": {},
  "occurred_at": "2026-07-24T18:00:00+00:00"
}

• Метод: POST (за замовчуванням) або GET (payload як параметри запиту).
• Власні заголовки: один на рядок у форматі Header-Name: value, наприклад заголовок Authorization для вашого ендпоінта.
• URL webhook-ів Slack та Discord тут навмисно відхиляються: їхні API очікують інший формат payload. Замість цього використовуйте відповідний тип каналу Slack або Discord.

Групи сповіщень

Група сповіщень - це іменований набір каналів. Монітор, призначений групі, сповіщає лише її канали; монітори без групи зберігають типову поведінку і сповіщають усі увімкнені канали акаунта.

Типова схема: група «backups», що вказує на окремий чат Telegram, і група «www» з черговим webhook. Оскільки акаунт може мати кілька каналів одного типу, кожна група може цілитися у власний чат Telegram.

Керуйте групами в Налаштування -> Канали сповіщень -> Керувати групами: створіть групу, позначте її канали і на тій самій сторінці прикріпіть монітори (ping і перевірки HTTP/SSL). Групу також можна вибрати під час редагування окремого монітора.

Дві важливі деталі:

• Група без каналів робить свої монітори беззвучними поза панеллю (дзвіночок у застосунку працює далі). Панель попереджає про це.
• Видалення групи не видаляє нічого іншого: її монітори повертаються до всіх каналів акаунта.

У маніфестах config-as-code група подорожує як notification_group (назва групи). Пропущений ключ відкріплює групу; невідомі назви відхиляються з кодом помилки notification_group_invalid.

Типи подій

Кожен канал підписується на підмножину типів подій: