Telegram Bot API

Pemeriksa Webhook Bot Telegram

Cek webhook bot Telegram kamu dengan satu klik: alat ini memanggil getWebhookInfo, menampilkan URL, update tertunda, dan error pengiriman terakhir beserta saran perbaikannya, serta memungkinkan kamu memasang atau menghapus webhook.

Token tetap di browser kamu (localStorage) dan hanya dikirim ke api.telegram.org.

Pasang atau ubah webhook

Cara mengecek webhook bot Telegram

  1. Tempel token bot. Centang Server tes jika bot berada di lingkungan tes.
  2. Tekan Cek webhook. Kamu mendapat salah satu dari tiga hasil: tidak ada webhook (bot memakai getUpdates), webhook tanpa error dalam 24 jam terakhir, atau masalah pengiriman dengan waktu dan teks error terakhir plus saran.
  3. Periksa penghitung update tertunda. Angka di atas 100 disorot: update menumpuk karena server kamu tidak menerimanya.
  4. Di bawahnya kamu melihat respons getWebhookInfo lengkap: url, has_custom_certificate, pending_update_count, last_error_date, last_error_message, max_connections, dan field lainnya.
  5. Untuk mengubahnya, buka Pasang atau ubah webhook: masukkan URL HTTPS, secret_token opsional, pilih apakah update tertunda dibuang, lalu tekan setWebhook atau deleteWebhook. Pengecekan dijalankan lagi secara otomatis.

Error webhook yang umum

Saran dipilih berdasarkan teks last_error_message:

Bentuk errorYang perlu dicek
SSL / certificateSertifikat valid untuk domain (atau sertifikat self-signed yang diunggah lewat parameter certificate di setWebhook), TLS 1.2+.
Wrong response from the webhook: 4xx/5xxPath, pengecekan secret_token, dan error server — Telegram mengharapkan 2xx.
Timeout / connection resetServer harus bisa dijangkau dari internet di port 443, 80, 88, atau 8443 dan menjawab dengan cepat.
Connection refusedTidak ada yang mendengarkan di port tersebut, atau firewall memblokir Telegram.
Host can't be resolvedRecord DNS domain webhook.

Formulir hanya mengirim url, secret_token, dan drop_pending_updates. Secret (1–256 karakter A-Z a-z 0-9 _ -) dikirim di header X-Telegram-Bot-Api-Secret-Token pada setiap request. Untuk allowed_updates, max_connections, atau sertifikat, gunakan /id/telegram-bot-api-tester.html#setWebhook.

Privasi

Token tetap di localStorage browser kamu, dan getWebhookInfo, setWebhook, serta deleteWebhook dikirim langsung ke api.telegram.org — tidak ada yang melewati server kami. Panggilan yang sama tersedia di /id/telegram-bot-api-tester.html#getWebhookInfo. Panduan pemasangan lengkap ada di /id/guides/telegram-bot-webhook.html, dan 409 Conflict serta error lainnya dibahas di /id/guides/telegram-bot-api-errors.html.

Pertanyaan umum

Bagaimana cara mengecek apakah bot Telegram punya webhook?

Panggil getWebhookInfo. Jika url kosong, tidak ada webhook dan bot bekerja dengan getUpdates. Pemeriksa di atas memanggilnya untuk kamu dan menjelaskan hasilnya.

Bagaimana cara menghapus webhook bot Telegram?

Panggil deleteWebhook — di alat ini buka Pasang atau ubah webhook lalu tekan deleteWebhook. Centang Buang update tertunda hanya jika kamu ingin membuang update yang mengantre. Setelah itu getUpdates berfungsi lagi.

Kenapa pending_update_count terus bertambah?

Telegram tidak bisa mengirim update: server kamu tidak bisa dijangkau, lambat, atau menjawab dengan status selain 2xx. Lihat last_error_message; Telegram terus mencoba ulang, dan update disimpan maksimal 24 jam.

Apa arti "Wrong response from the webhook"?

Server kamu menjawab dengan status HTTP selain 2xx, misalnya 404 karena path salah atau 500 karena crash. Telegram mengharapkan respons 2xx yang cepat dan mencoba ulang jika tidak mendapatkannya.

Utilitas lainnya

Pencari Chat IDEscaper MarkdownV2 & HTMLValidator initData Mini AppBot API Tester