Powiadomienia Telegram w Uptime Kuma — kompletna konfiguracja

Dlaczego Telegram to idealny kanał powiadomień monitoringu

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ń?

• Natychmiastowe dostarczanie — wiadomości docierają w ciągu sekund, push notifications na telefonie
• Zero kosztów — w przeciwieństwie do SMS (płatne per wiadomość) czy PagerDuty (od $21/mies.), Telegram nie kosztuje nic
• Bogate formatowanie — HTML, Markdown, emoji, linki, bold, code blocks
• Grupy i kanały — powiadomienia dla całego zespołu on-call jednocześnie
• Thread Topics — segregacja alertów w wątkach (produkcja, staging, development)
• Multi-platform — telefon, desktop, web — powiadomienie dociera wszędzie
• Bot API — prosty HTTP API, łatwa integracja, brak limitów rate
• Prywatność — end-to-end encryption w secret chats, serwery poza jurysdykcją EU/US

Uptime Kuma ma natywne wsparcie dla Telegram — konfiguracja wymaga tylko tokena bota i Chat ID. Cały proces zajmuje kilka minut.

Tworzenie bota Telegram — krok po kroku

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.

Uzyskanie Chat ID — użytkownik, grupa, kanał

Chat ID to unikalny identyfikator odbiorcy powiadomień. Może to być Twój prywatny czat z botem, grupa zespołowa lub kanał.

Chat ID użytkownika

Aby uzyskać swój Chat ID:

1. Otwórz czat ze swoim botem w Telegram
2. Wyślij dowolną wiadomość (np. /start)
3. W przeglądarce otwórz URL:

https://api.telegram.org/bot/getUpdates

W odpowiedzi JSON znajdź pole chat.id — to Twój Chat ID (liczba, np. 123456789).

Chat ID grupy

1. Dodaj bota do grupy (Invite → wyszukaj username bota)
2. Wyślij wiadomość w grupie
3. Sprawdź getUpdates — Chat ID grupy zaczyna się od - (np. -1001234567890)

Chat ID kanału

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".

Konfiguracja powiadomienia Telegram w Uptime Kuma

Mając token bota i Chat ID, konfiguracja w Uptime Kuma zajmuje 2 minuty.

Formatowanie wiadomości — szablony i zmienne

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ć.

Dostępne zmienne

Formatowanie HTML w Telegram

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ślenie

Telegram dla grup i kanałów — monitoring zespołowy

Dla zespołów, powiadomienia powinny trafiać do grupy (interaktywna dyskusja) lub kanału (jednokierunkowa komunikacja). Każde podejście ma swoje zastosowanie.

Grupa — dla zespołów on-call

Grupa Telegram to najlepszy wybór, gdy zespół musi reagować na alerty i dyskutować o incydentach. Członkowie grupy mogą:

• Reagować na alert emoji (np. 👀 = „widzę", ✅ = „rozwiązuję")
• Dyskutować o przyczynach i rozwiązaniach
• Oznaczać odpowiedzialnych (@username)

Kanał — dla stakeholderów

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.

Zaawansowane ustawienia

Ciche powiadomienia (Silent)

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.

Thread Topics (wątki w supergrupach)

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ę:

• Wątek „Produkcja" — krytyczne alerty z monitorów produkcyjnych
• Wątek „Staging" — alerty ze środowiska testowego
• Wątek „Infrastruktura" — alerty o serwerach i bazach danych

Wiele konfiguracji Telegram

Możesz utworzyć wiele powiadomień Telegram w Uptime Kuma — każde z innym Chat ID, innym botem, innymi ustawieniami. Przykład:

• Telegram — krytyczne → prywatny czat z CTO, dźwięk włączony
• Telegram — zespół DevOps → grupa zespołu, Thread „Alerty"
• Telegram — stakeholderzy → kanał, ciche powiadomienia

Testowanie i troubleshooting

Najczęstsze problemy z konfiguracją Telegram w Uptime Kuma:

Najlepsze praktyki powiadomień Telegram

• Nie spamuj — zbyt wiele alertów prowadzi do alert fatigue. Konfiguruj resend interval (np. co 5 minut) i max retries aby uniknąć fali wiadomości.
• Segreguj priorytety — krytyczne alerty → prywatny czat z dźwiękiem; informacyjne → kanał bez dźwięku.
• Używaj grup z Topics — segregacja alertów w wątkach daje porządek bez tworzenia wielu grup.
• Telegram + Email jako backup — zawsze konfiguruj zapasowy kanał powiadomień na wypadek, gdyby Telegram był niedostępny.
• Formatuj wiadomości — użyj HTML i emoji aby alerty były czytelne na pierwszy rzut oka. 🔴 DOWN, 🟢 UP, ⚠️ WARNING.

Podsumowanie

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:

• BotFather → tworzenie bota i uzyskanie tokena API
• getUpdates API → uzyskanie Chat ID użytkownika, grupy lub kanału
• Custom szablony → formatowanie HTML, zmienne {{name}}, {{status}}, {{msg}}
• Thread Topics → segregacja alertów w wątkach supergrup
• Ciche powiadomienia → bez dźwięku dla alertów niskiego priorytetu
• Backup → zawsze konfiguruj zapasowy kanał (Email, Discord)

Najczęściej zadawane pytania