Dlaczego Telegram to idealny kanał powiadomień • Tworzenie bota Telegram — krok po kroku • Uzyskanie Chat ID — użytkownik, grupa, kanał • Konfiguracja powiadomienia Telegram w Uptime Kuma • Formatowanie wiadomości — szablony i zmienne • Telegram dla grup i kanałów • Zaawansowane ustawienia • Testowanie i troubleshooting • Najlepsze praktyki • Podsumowanie • Najczęściej zadawane pytania
Telegram jest jednym z najpopularniejszych kanałów powiadomień w Uptime Kuma — i nie bez powodu. Oferuje natychmiastowe dostarczanie wiadomości, bogate formatowanie, obsługę botów, grup i kanałów, a przede wszystkim — jest całkowicie darmowy, bez limitów na liczbę wiadomości.
Dlaczego Telegram wygrywa z innymi kanałami powiadomień?
Uptime Kuma ma natywne wsparcie dla Telegram — konfiguracja wymaga tylko tokena bota i Chat ID. Cały proces zajmuje kilka minut.
Pierwszym krokiem jest utworzenie bota Telegram, który będzie wysyłał powiadomienia. Boty tworzy się przez BotFather — oficjalnego bota Telegram do zarządzania botami.
1.
W Telegram wyszukaj @BotFather i otwórz czat. BotFather to oficjalny bot Telegram — jest zweryfikowany niebieską ikoną.
2.
Wyślij komendę /newbot. BotFather zapyta o nazwę bota (display name, np. „Monitoring MojaFirma") i username (np. mojafirma_monitoring_bot — musi kończyć się na bot).
3.
BotFather zwróci token API w formacie: 7123456789:AAF-qwertyuiopasdfghjklzxcvbnm123. Zapisz go — będzie potrzebny w konfiguracji Uptime Kuma. Token jest jak hasło — nie udostępniaj go publicznie.
4.
Możesz ustawić opis bota (/setdescription), zdjęcie profilowe (/setuserpic) i komendy (/setcommands). To opcjonalne — bot będzie działał bez tego.
1.
W panelu Uptime Kuma kliknij ikonę ustawień (Settings) w menu bocznym, przejdź do zakładki Notifications i kliknij Setup Notification.
2.
Z listy kanałów wybierz Telegram. Zobaczysz formularz z polami: Bot Token, Chat ID, oraz opcje zaawansowane.
3.
Wypełnij: Friendly Name (np. „Telegram — zespół DevOps"), Bot Token i Chat ID. Opcjonalnie zaznacz „Default Enabled" aby powiadomienie było automatycznie włączone dla nowych monitorów.
4.
Kliknij Test. Jeśli konfiguracja jest prawidłowa, otrzymasz wiadomość testową na Telegram. Kliknij Save.
/revoke.
Chat ID to unikalny identyfikator odbiorcy powiadomień. Może to być Twój prywatny czat z botem, grupa zespołowa lub kanał.
Aby uzyskać swój Chat ID:
/start)https://api.telegram.org/bot/getUpdatesW odpowiedzi JSON znajdź pole chat.id — to Twój Chat ID (liczba, np. 123456789).
getUpdates — Chat ID grupy zaczyna się od - (np. -1001234567890)Dla kanału możesz użyć @nazwa_kanalu jako Chat ID (np. @moj_monitoring). Bot musi być administratorem kanału z uprawnieniami „Post Messages".
Mając token bota i Chat ID, konfiguracja w Uptime Kuma zajmuje 2 minuty.
Uptime Kuma pozwala customizować treść wiadomości Telegram za pomocą szablonów z zmiennymi. Domyślna wiadomość zawiera nazwę monitora, status (UP/DOWN) i URL, ale możesz ją całkowicie przerobić.
| Zmienna | Opis | Przykład wartości |
|---|---|---|
{{name}} | Nazwa monitora | Strona WWW — MojaFirma |
{{msg}} | Treść alertu | Down — Connection timeout |
{{status}} | Status (UP/DOWN) | DOWN |
{{hostname}} | Host monitora | www.mojafirma.pl |
{{timezoneOffset}} | Offset strefy czasowej | +01:00 |
{{heartbeatJSON}} | Pełne dane heartbeat jako JSON | {"status": 0, "time": "2026-03-23..."} |
Telegram obsługuje formatowanie HTML w wiadomościach botów. Możesz używać:
bold — pogrubienie
italic — kursywa
inline code — kod inline
code block
— blok kodu
link — hiperłącze
strikethrough — przekreślenieDla zespołów, powiadomienia powinny trafiać do grupy (interaktywna dyskusja) lub kanału (jednokierunkowa komunikacja). Każde podejście ma swoje zastosowanie.
Grupa Telegram to najlepszy wybór, gdy zespół musi reagować na alerty i dyskutować o incydentach. Członkowie grupy mogą:
Kanał Telegram to jednokierunkowa komunikacja — idealna dla stakeholderów, klientów VIP lub menedżerów, którzy chcą wiedzieć o statusie, ale nie uczestniczyć w dyskusji technicznej.
Opcja „Disable Notification" (Silent) powoduje, że wiadomość Telegram dociera bez dźwięku i wibracji. Przydatne dla alertów niskiego priorytetu lub w godzinach nocnych — alert jest w historii czatu, ale nie budzi telefonu.
Od nowszych wersji Uptime Kuma obsługuje Message Thread ID — możesz kierować alerty do konkretnego wątku (topic) w supergrupie z włączonymi tematami. Pozwala to na segregację:
Możesz utworzyć wiele powiadomień Telegram w Uptime Kuma — każde z innym Chat ID, innym botem, innymi ustawieniami. Przykład:
Najczęstsze problemy z konfiguracją Telegram w Uptime Kuma:
| Problem | Przyczyna | Rozwiązanie |
|---|---|---|
| Test notification nie dociera | Nieprawidłowy token lub Chat ID | Sprawdź token przez getMe API; sprawdź Chat ID przez getUpdates |
| Bot nie odpowiada w grupie | Bot nie ma uprawnień | Upewnij się, że bot jest członkiem grupy i ma uprawnienia do wysyłania wiadomości |
| Chat ID grupy nie pojawia się w getUpdates | Bot ma włączony Privacy Mode | Wyłącz Privacy Mode w BotFather (/setprivacy → Disable) lub wspomnij bota w grupie |
| Wiadomości na kanale nie docierają | Bot nie jest administratorem kanału | Dodaj bota jako administratora kanału z uprawnieniami „Post Messages" |
| Thread ID nie działa | Supergrupa nie ma włączonych tematów | Włącz Topics w ustawieniach supergrupy |
Telegram jest jednym z najlepszych kanałów powiadomień dla monitoringu — darmowy, szybki, z bogatym formatowaniem i obsługą grup/kanałów/wątków. Konfiguracja w Uptime Kuma trwa kilka minut i wymaga tylko tokena bota oraz Chat ID.
Kluczowe punkty:
Najprościej: napisz wiadomość do swojego bota, potem otwórz w przeglądarce https://api.telegram.org/botTWOJ_TOKEN/getUpdates — w odpowiedzi JSON znajdziesz chat.id. Alternatywnie użyj bota @userinfobot lub @getidsbot — wyślij do niego /start, a odpowie Twoim Chat ID.
Tak. Dodaj bota do grupy, wyślij wiadomość w grupie, a potem sprawdź Chat ID grupy przez getUpdates API. Chat ID grupy zaczyna się od - (minus), np. -1001234567890 dla supergrup.
W ustawieniach powiadomienia Telegram w Uptime Kuma zaznacz opcję 'Disable Notification' (Silent). Powiadomienia będą dostarczane bez dźwięku — przydatne dla alertów niskiego priorytetu lub w godzinach nocnych.
Tak. Dodaj bota jako administratora kanału (z uprawnieniami do wysyłania wiadomości), a jako Chat ID wpisz @nazwa_kanalu lub numeryczny ID kanału.
Uptime Kuma obsługuje szablony wiadomości z zmiennymi: {{name}}, {{msg}}, {{status}}, {{heartbeatJSON}}. Telegram obsługuje formatowanie HTML — bold, italic, code, linki.
Tak, od nowszych wersji. W konfiguracji powiadomienia możesz podać Message Thread ID, aby alerty trafiały do konkretnego wątku (topic) w supergrupie z włączonymi tematami.