Личные уведомления
Мониторинг доступности без задержек
Подключение Telegram к PingKit
Получайте мгновенные оповещения о сбоях, восстановлении и изменениях статуса ваших проектов прямо в Telegram. Весь процесс занимает не более пяти минут и требует только вашего Telegram-аккаунта.
PingKit отправляет уведомления через собственного Telegram-бота. Чтобы настроить канал связи, вам нужно создать бота с помощью BotFather, получить токен авторизации и привязать его к вашему аккаунту PingKit. После этого вы сможете получать уведомления индивидуально или в группах.
Шаг 1 — Создание бота
Откройте диалог с @BotFather в Telegram и отправьте команду /newbot. Укажите имя и юзернейм для вашего бота. BotFather вернёт API-токен — сохраните его, он понадобится на следующем шаге.
Шаг 2 — Получение Chat ID
Напишите любое сообщение своему новому боту, затем откройте в браузере адрес https://api.telegram.org/bot<TOKEN>/getUpdates. В ответном JSON найдите поле chat.id — это ваш уникальный идентификатор чата, например 482719305.
Шаг 3 — Привязка в PingKit
Перейдите в раздел Settings → Notifications → Telegram в панели PingKit. Вставьте токен бота и Chat ID в соответствующие поля, нажмите Test Connection. При успешной проверке бот отправит тестовое сообщение «PingKit: connection verified» в ваш чат.
Работа с токеном бота
Токен бота — это ключ доступа к вашему Telegram-аккаунту. Храните его так же надёжно, как пароль от почты.
Когда BotFather создаёт бота, он генерирует токен формата 724819305:AAHd3Kf9xR2mQw7vLpNcYb1TgZsEjUoImXw. Этот токен позволяет PingKit отправлять сообщения от имени вашего бота. Если токен скомпрометирован, злоумышленник сможет имитировать уведомления от PingKit или читать историю чата.
Ротация токена
Если вы подозреваете утечку токена, отправьте /revoke в диалог с BotFather, указав юзернейм бота. BotFather сгенерирует новый токен. Обновите токен в настройках PingKit в течение 24 часов, чтобы не прерывать уведомления.
Права бота
Бот PingKit работает с минимальными правами: он может отправлять текстовые сообщения и media-файлы. Бот не имеет доступа к вашим контактам, истории переписки с другими пользователями или личным данным. Все данные передаются через HTTPS с TLS 1.3.
Пример конфигурации
В файле конфигурации PingKit токен хранится в зашифрованном виде. При деплое на сервере используйте переменную окружения PINGKIT_TELEGRAM_TOKEN вместо прямого указания в коде. Это исключает попадание токена в репозиторий.
Групповые чаты и команды
Настройте уведомления для всей команды или отдельных подгрупп — от отдела разработки до службы поддержки.
PingKit поддерживает отправку уведомлений в групповые чаты Telegram. Это позволяет координировать реагирование на инциденты: когда сервер падает, оповещение получают сразу все члены дежурной группы, а не один разработчик.
Добавление бота в группу
Пригласите бота в группу через настройки чата (Group Info → Add Member) или по ссылке t.me/<bot_username>?startgroup. Бот должен иметь права администратора или хотя бы право на отправку сообщений. После добавления бот автоматически определяет Chat ID группы — он обычно начинается с минуса, например -1001827493056.
Фильтрация по проектам
В PingKit вы можете назначать разные группы на разные проекты. Например, группа dev-ops-alpha получает уведомления от мониторинга серверов в Москве (msk-web-01, msk-web-02), а группа support-team — только от пользовательского API (api.pingkit.io). Настройка доступна в Settings → Notification Rules.
Тихие часы и эскалация
Настройте расписание «тихих часов» для групповых чатов, чтобы уведомления не приходили в нерабочее время. Если сбой не устранён в течение заданного интервала — например, 15 минут — PingKit автоматически эскалирует уведомление: отправляет сообщение в группу высшего приоритета или индивидуально ответственному инженеру.