Алерты в Telegram

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

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

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

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

У непривязанной интеграции в дашборде два варианта: «В личные сообщения» и «В группу». Для группы дашборд показывает готовую команду с кнопкой «Копировать» — конструировать ничего не нужно.

1. Добавьте бота в группу (шаг 1 в блоке «В группу»).
2. Скопируйте команду из дашборда и отправьте её в группе. Формат команды:

   /start@<имя-бота> <код-привязки>

3. Бот подтвердит привязку в группе, а в карточке интеграции появится «Подключено: название группы».

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

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

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

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

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

• события — любое подмножество 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-алерты продолжают доставляться). Либо чек «флапает» — сработал flap damping: рядом с записью будет причина «чек нестабилен» и ссылка «почему?».
• Быстрая проверка канала. Кнопка «Отправить тестовый алерт» на карточке интеграции шлёт сообщение через реальный канал (не чаще раза в 30 секунд); результат и текст ошибки — в журнале доставки.
• Бот удалён из группы / чат изменился. Доставка будет падать (видно в журнале с текстом ошибки Telegram API) — создайте новую интеграцию и привяжите чат заново.