Telegram

UptimeWarden uyarılarını Telegram'da alın: doğrudan mesaj, grup sohbeti veya konu başlığında, kendi botunuz üzerinden 5 dakikadan kısa sürede.

Telegram pek çok mühendislik takımının tercih ettiği kişisel mobil sohbet istemcisidir: hızlı, ücretsiz ve bildirimleri diğer sohbetlerinizle aynı yerde tutar. UptimeWarden, Telegram'ı bir Webhook olarak yapılandırır: bot'unuzun Telegram Bot API uç noktasına doğrudan sendMessage çağrısı yapar; üstelik düzgün Markdown formatlamasıyla.

Bu sayfa bot oluşturmayı, kurulumu, grup sohbeti desteğini ve mesaj formatlamasını anlatır.

Plan kullanımı

Telegram tüm planlarda, Free dahil, kullanılabilir. Mesajlar webhook olarak gönderildiği için her mesaj planınızın aylık webhook kotasından düşer (Free planında ayda 1.000 webhook gönderimi). Bunun üzerine Telegram'ın kendi rate limit'leri de geçerlidir. Tüm planların kotaları için Bildirimler sayfasına bakın.

Nasıl çalışır

UptimeWarden                  Telegram Bot API
─────────────                ──────────────────
Monitor down ──> bot_token + chat_id ──> sendMessage
                                          │
                                          ▼
                                    Sohbetiniz

Her kullanıcı kendi botuna sahiptir. UptimeWarden paylaşımlı bot sağlamaz; böylece rate limit kontrolü sizde kalır ve Telegram'ın "1 bot, 1000 müşteri" rate-limit tavanına çarpmazsınız.

Adım 1, @BotFather üzerinden bot oluşturun

1. Telegram'ı açın, @BotFather'ı arayın ve sohbet başlatın.
2. /newbot mesajını gönderin.
3. Bir görünen ad seçin: Acme Monitoring. Mesajlarınız bu isim altında görünecek.
4. bot ile biten benzersiz bir kullanıcı adı seçin: acme_monitoring_bot. Kullanıcı adı Telegram genelinde benzersiz olmalı.
5. BotFather size 123456789:AAFq3ZNn-fakebut-like-this-shape gibi bir token döner. Bunu saklayın; bu sizin bot token'ınızdır.

Bot token bir kimlik bilgisidir. Bu token'a sahip olan herkes botunuzu kullanarak mesaj gönderebilir; parola gibi davranın.

Adım 2. Chat ID'yi alın

Kendinize doğrudan mesaj göndermek için:

1. @userinfobot ile sohbet açın.
2. Herhangi bir mesaj gönderin. Bot size sayısal kullanıcı kimliğinizi yanıt olarak yazar. Bu sizin chat ID'nizdir.

Grup sohbeti için:

1. Botunuzu gruba ekleyin.
2. Grupta /start gönderin veya botu etiketleyen herhangi bir mesaj atın.
3. Tarayıcıda https://api.telegram.org/bot<BOT_TOKEN>/getUpdates adresini açın.
4. "chat": {"id": -1001234567890, ...} ifadesini arayın. Negatif sayı grubun chat ID'sidir.

Adım 3. UptimeWarden'da yapılandırın

Telegram, Settings → Notifications → Webhooks altında bir webhook olarak eklenir; artık ayrı bir "Telegram" ekranı yoktur. Add webhook ile (veya webhook sihirbazıyla) Telegram tipini seçin:

1. URL, https://api.telegram.org/bot<BOT_TOKEN>/sendMessage. <BOT_TOKEN> yerine BotFather'dan aldığınız token'ı yazın.
2. Chat ID. 2. adımda aldığınız chat ID'yi girin. Değer x-telegram-chat-id başlığı olarak saklanır.
3. Parse mode / mesaj formatı. Markdown (varsayılan), HTML veya MarkdownV2. Monitor adlarına en toleranslı olanı Markdown'dur.
4. Kaydet.

Send test butonuna tıklayın. Birkaç saniye içinde Telegram'da test mesajını almanız gerekir. Almıyorsanız önce bota bir mesaj attığınızdan emin olun. Telegram, kendisiyle sohbet başlatmamış kullanıcıya bot mesaj göndermesini engeller.

Şifrelenmiş depolama

Bot token'ınız depolanmadan önce şifrelenir. Veritabanı dosyasına erişen biri olsa bile token'ı düz metin olarak okuyamaz. Şifreleme otomatiktir: siz token'ı yapıştırırsınız, biz şifreleriz; teslimat anında yalnızca canlı uygulama çözebilir.

Bot token'ı asla bir yorum alanına, log satırına veya denetim kaydına yapıştırmayın. O yollar şifrelenmez.

Mesaj önizleme

Bir down uyarısı için varsayılan mesaj formatı:

🚨 *Service Down Alert*

*Monitor:* Payment API
*URL:* https://api.example.com
*Error:* HTTP 503
*Time:* 2026-04-27 03:12:00 UTC

Please investigate immediately.

Bunu bir bildirim şablonuyla özelleştirin. Değişken interpolasyon deseni için bkz. Push Şablonları. Telegram da {monitor_name}, {monitor_url}, {error_message}, {response_time}, {ssl_expiry_days} gibi düz placeholder'ları destekler. Hem {tekli} hem {{çiftli}} süslü parantez biçimi çalışır.

Kullanıcı başına birden çok sohbet

Monitor bazında belirli sohbetleri hedefleyebilirsiniz. Monitor düzenleme formundaki Telegram → Chat IDs alanı (virgülle ayrılmış) bir monitor'ü bir veya birden çok belirli sohbete yönlendirir. Şu durumlarda işe yarar:

• Production monitor'ları → #prod-alerts grubuna.
• Geliştirme monitor'ları → yalnızca kişisel DM'e.
• Müşteri yönlü monitor'lar → farklı bir botla müşteriyle paylaşılan gruba.

Chat IDs alanı boş bırakılırsa UptimeWarden varsayılan chat ID'nizi kullanır.

Grup sohbeti görgü kuralları

Telegram botları gruplarda mesaj gönderebilir, ancak varsayılan olarak mesajları okuyamaz; Privacy Mode açıktır. Botunuzun grup içinde /status gibi slash komutlarına yanıt vermesini istiyorsanız:

1. BotFather'ı açın ve /setprivacy gönderin.
2. Botunuzu seçin ve Disable'ı seçin.

UptimeWarden botu yalnızca mesaj gönderir; o yüzden güvenlik için Privacy Mode'u açık bırakın. Yalnızca özel bir gelen mesaj işleme kuruyorsanız kapatın.

Rate limit'ler

Telegram şu sınırları uygular:

• Farklı sohbetlere bot başına saniyede 30 mesaj.
• Bir sohbet veya grup başına saniyede 1 mesaj.

UptimeWarden bu sınırlara saygı duyar. Burst uyarılar bota ulaşmadan önce Akıllı Uyarı Gruplaması tarafından kuyruğa alınır; çok monitor'lü bir kesintide tavana çarpmazsınız.

Sorun giderme

İlgili konular

• Bildirim Kanalları: kanal kullanılabilirlik matrisi
• Push Şablonları: şablon yazım desenleri
• Webhook Yapılandırma: kendi botunuzu çalıştıramıyorsanız geri çekilme yolu
• Akıllı Uyarı Gruplaması: sohbet kanalları için burst kontrolü