Telegram Bot Webhook Denetleyici
Telegram botunuzun webhook'unu tek tıkla kontrol edin: araç getWebhookInfo çağırır, URL'yi, bekleyen güncellemeleri ve son teslimat hatasını nasıl düzeltileceğine dair bir ipucuyla gösterir ve webhook'u ayarlamanıza veya silmenize olanak tanır.
Token tarayıcınızda (localStorage) kalır ve yalnızca api.telegram.org adresine gönderilir.
Webhook'u ayarla veya değiştir
Telegram bot webhook'u nasıl kontrol edilir
- Bot token'ını yapıştırın. Bot test ortamındaysa Test sunucusu kutusunu işaretleyin.
- Webhook'u kontrol et düğmesine basın. Üç sonuçtan birini alırsınız: webhook yok (bot
getUpdateskullanıyor), son 24 saatte hatasız bir webhook ya da son hatanın zamanı, metni ve bir ipucuyla birlikte bir teslimat sorunu. - Bekleyen güncellemeler sayacını kontrol edin. 100'ün üzeri vurgulanır: sunucunuz kabul etmediği için güncellemeler birikiyor.
- Aşağıda tam
getWebhookInfoyanıtını görürsünüz:url,has_custom_certificate,pending_update_count,last_error_date,last_error_message,max_connectionsve diğer alanlar. - Değiştirmek için Webhook'u ayarla veya değiştir bölümünü açın: bir HTTPS URL'si, isteğe bağlı bir
secret_tokengirin, bekleyen güncellemelerin atılıp atılmayacağını seçin ve setWebhook veya deleteWebhook düğmesine basın. Kontrol otomatik olarak yeniden çalışır.
Sık karşılaşılan webhook hataları
İpucu, last_error_message metnine göre seçilir:
| Hata şuna benziyor | Neyi kontrol etmeli |
|---|---|
| SSL / sertifika | Alan adı için geçerli bir sertifika (veya setWebhook metodunun certificate parametresiyle yüklenmiş kendinden imzalı bir sertifika), TLS 1.2+. |
| Wrong response from the webhook: 4xx/5xx | Yol, secret_token kontrolünüz ve sunucu hataları — Telegram 2xx bekler. |
| Zaman aşımı / bağlantı sıfırlandı | Sunucu internetten 443, 80, 88 veya 8443 portunda erişilebilir olmalı ve hızlı yanıt vermelidir. |
| Bağlantı reddedildi | Portu dinleyen bir şey yok veya bir güvenlik duvarı Telegram'ı engelliyor. |
| Sunucu adı çözümlenemiyor | Webhook alan adının DNS kayıtları. |
Form yalnızca url, secret_token ve drop_pending_updates gönderir. Gizli anahtar (1–256 karakter A-Z a-z 0-9 _ -) her isteğin X-Telegram-Bot-Api-Secret-Token başlığında gelir. allowed_updates, max_connections veya sertifika için /tr/telegram-bot-api-tester.html#setWebhook kullanın.
Gizlilik
Token tarayıcınızın localStorage alanında kalır; getWebhookInfo, setWebhook ve deleteWebhook doğrudan api.telegram.org adresine gönderilir — hiçbir şey sunucumuzdan geçmez. Aynı çağrı /tr/telegram-bot-api-tester.html#getWebhookInfo içinde de mevcuttur. Adım adım kurulum /tr/guides/telegram-bot-webhook.html rehberinde, 409 Conflict ve diğer hatalar ise /tr/guides/telegram-bot-api-errors.html rehberinde ele alınır.
Sık sorulan sorular
Telegram botumun webhook'u olup olmadığını nasıl kontrol ederim?
getWebhookInfo çağırın. url boşsa webhook ayarlı değildir ve bot getUpdates ile çalışır. Yukarıdaki denetleyici bu çağrıyı sizin için yapar ve sonucu açıklar.
Telegram bot webhook'u nasıl silinir?
deleteWebhook çağırın — araçta Webhook'u ayarla veya değiştir bölümünü açıp deleteWebhook düğmesine basın. Bekleyen güncellemeleri at kutusunu yalnızca kuyruktaki güncellemeleri atmak istiyorsanız işaretleyin. Bundan sonra getUpdates yeniden çalışır.
pending_update_count neden artıyor?
Telegram güncellemeleri teslim edemiyor: sunucunuz erişilemez, yavaş ya da 2xx dışı bir durum koduyla yanıt veriyor. last_error_message alanına bakın; Telegram yeniden denemeye devam eder ve güncellemeler en fazla 24 saat saklanır.
"Wrong response from the webhook" ne anlama gelir?
Sunucunuz 2xx dışında bir HTTP durum koduyla yanıt verdi; örneğin yanlış yol için 404 veya çökme için 500. Telegram hızlı bir 2xx yanıtı bekler, aksi halde yeniden dener.
Diğer yardımcı araçlar
Chat ID bulucuMarkdownV2 ve HTML kaçışlayıcıMini App initData doğrulayıcıBot API Tester