Алерты в Telegram

Telegram — основной канал алертов CronAlive: личные сообщения и групповые чаты, привязка по одноразовой ссылке, без передачи номера телефона.

Подключение в личку

1. В дашборде откройте Интеграции → Новая интеграция, выберите канал Telegram и сохраните. На карточке интеграции появится одноразовая ссылка привязки вида https://t.me/<бот>?start=<код> (то же самое можно сделать через API: POST /api/v1/integrations).
2. Откройте ссылку и нажмите Start — Telegram сам отправит боту код.
3. Бот ответит подтверждением («Готово! Алерты интеграции … будут приходить в этот чат») на языке владельца аккаунта — интеграция включена.

Подключение в группу

1. Создайте интеграцию так же, как для лички, — получите код из ссылки (часть после ?start=).
2. Добавьте бота в группу.
3. Отправьте в группу сообщение /start <код> или /link <код> (вариант с упоминанием — /start@<бот> <код> — тоже работает).
4. Бот подтвердит привязку в группе — алерты будут приходить в этот чат.

Код одноразовый: после успешной привязки он гасится. Чтобы привязать другой чат, создайте новую интеграцию.

Какие алерты приходят

Сообщения приходят обычным текстом: заголовок со статусом и деталями — имя чека, проект, время в вашей таймзоне и причина.

• 🔴 down — чек упал: пинг не пришёл в срок, задача сообщила об ошибке или вернула ненулевой код выхода.
• 🟢 up — чек снова работает.
• 🟡 late — пинг опаздывает, идёт grace-период (down ещё не объявлен).
• 🔴 напоминания — если чек остаётся в down, приходят повторные сообщения через настроенные интервалы (например, 1, 3 и 24 часа); каждый интервал — один раз на инцидент.
• ⚠ SSL — для HTTPS-чеков: сертификат истекает через N дней (порог 7/14/30 настраивается на чеке; не чаще раза в сутки).

Что настраивается на интеграции:

• события — любое подмножество down / up / late;
• теги — алерты только по чекам с указанными тегами (пусто = все чеки проекта);
• тихие часы — окно (с таймзоной, может переходить через полночь), в котором доставка откладывается до конца окна, а не теряется;
• напоминания — список интервалов в часах (1–168) для незакрытых down.

Язык алертов равен языку владельца аккаунта. Доставка идёт с 3 попытками (пауза 10 с → 1 мин → 5 мин); если Telegram так и не ответил — алерт продублируется на email владельца аккаунта.

Если бот молчит

• Интеграция не привязана. Пока код не отправлен боту, интеграция выключена (бейдж «не привязана» на карточке). Откройте журнал доставки — кнопка Журнал на странице интеграций: ошибка «not linked (no chat_id)» означает, что привязка не завершена.
• Бот не видит команду в группе. Бот должен быть участником группы; если у бота включён privacy mode (настройка BotFather), он видит только команды — отправляйте именно /start <код>, а не код отдельным сообщением.
• Код не распознан. Команда и код должны быть в одном сообщении: /start abc…. Код — только из ссылки; после успешной привязки он уже не действует.
• Подписка на события. Если интеграция подписана только на down — up-сообщения не приходят; проверьте также фильтр по тегам.
• Тихие часы. В журнале статус pending, а алерт «задерживается» — доставка отложена до конца тихого окна.
• Статус suppressed в журнале. Сервис зафиксировал сбой собственных воркеров и временно подавил down-алерты, чтобы не слать ложные; up-алерты при этом продолжают доставляться.
• Бот удалён из группы / чат изменился. Доставка будет падать (видно в журнале с текстом ошибки Telegram API) — создайте новую интеграцию и привяжите чат заново.