Công cụ kiểm tra webhook của bot Telegram
Kiểm tra webhook của bot Telegram chỉ với một cú bấm: công cụ gọi getWebhookInfo, hiển thị URL, số update đang chờ và lỗi gửi gần nhất kèm gợi ý cách sửa, đồng thời cho phép đặt hoặc xóa webhook.
Token chỉ lưu trong trình duyệt của bạn (localStorage) và chỉ được gửi tới api.telegram.org.
Đặt hoặc đổi webhook
Cách kiểm tra webhook của bot Telegram
- Dán token của bot. Tick Máy chủ thử nghiệm nếu bot nằm trong môi trường thử nghiệm.
- Bấm Kiểm tra webhook. Bạn nhận được một trong ba kết quả: chưa đặt webhook (bot dùng
getUpdates), webhook không có lỗi trong 24 giờ qua, hoặc có sự cố khi gửi update kèm thời gian, nội dung lỗi gần nhất và gợi ý. - Xem bộ đếm update đang chờ. Trên 100 sẽ được tô nổi bật: update đang dồn lại vì server của bạn không nhận chúng.
- Bên dưới là toàn bộ phản hồi
getWebhookInfo:url,has_custom_certificate,pending_update_count,last_error_date,last_error_message,max_connectionsvà các trường khác. - Để thay đổi, mở Đặt hoặc đổi webhook: nhập URL HTTPS,
secret_tokentùy chọn, chọn có bỏ update đang chờ hay không rồi bấm setWebhook hoặc deleteWebhook. Việc kiểm tra sẽ tự chạy lại.
Lỗi webhook thường gặp
Gợi ý được chọn dựa trên nội dung của last_error_message:
| Lỗi có dạng | Cần kiểm tra |
|---|---|
| SSL / chứng chỉ | Chứng chỉ hợp lệ cho domain (hoặc chứng chỉ tự ký được upload qua tham số certificate của setWebhook), TLS 1.2+. |
| Wrong response from the webhook: 4xx/5xx | Đường dẫn, phần kiểm tra secret_token và lỗi server — Telegram cần 2xx. |
| Timeout / connection reset | Server phải truy cập được từ internet qua cổng 443, 80, 88 hoặc 8443 và phản hồi nhanh. |
| Connection refused | Không có gì lắng nghe ở cổng đó, hoặc tường lửa chặn Telegram. |
| Không phân giải được host | Bản ghi DNS của domain webhook. |
Biểu mẫu chỉ gửi url, secret_token và drop_pending_updates. Chuỗi bí mật (1–256 ký tự A-Z a-z 0-9 _ -) được gửi kèm trong header X-Telegram-Bot-Api-Secret-Token của mọi request. Với allowed_updates, max_connections hoặc chứng chỉ, hãy dùng /vi/telegram-bot-api-tester.html#setWebhook.
Quyền riêng tư
Token nằm trong localStorage của trình duyệt, và getWebhookInfo, setWebhook, deleteWebhook được gửi thẳng tới api.telegram.org — không có gì đi qua server của chúng tôi. Lệnh gọi tương tự có trong /vi/telegram-bot-api-tester.html#getWebhookInfo. Hướng dẫn cài đặt đầy đủ có trong /vi/guides/telegram-bot-webhook.html, còn 409 Conflict và các lỗi khác được trình bày trong /vi/guides/telegram-bot-api-errors.html.
Câu hỏi thường gặp
Làm sao biết bot Telegram có đặt webhook không?
Gọi getWebhookInfo. Nếu url rỗng, bot chưa đặt webhook và đang hoạt động bằng getUpdates. Công cụ ở trên gọi phương thức này giúp bạn và giải thích kết quả.
Làm sao xóa webhook của bot Telegram?
Gọi deleteWebhook — trong công cụ, mở Đặt hoặc đổi webhook và bấm deleteWebhook. Chỉ tick Bỏ update đang chờ nếu bạn muốn hủy các update trong hàng đợi. Sau đó getUpdates hoạt động trở lại.
Vì sao pending_update_count tăng liên tục?
Telegram không gửi được update: server của bạn không truy cập được, chậm hoặc trả về mã trạng thái khác 2xx. Hãy xem last_error_message; Telegram sẽ tiếp tục thử lại, và update được lưu tối đa 24 giờ.
"Wrong response from the webhook" nghĩa là gì?
Server của bạn trả về mã HTTP khác 2xx, ví dụ 404 do sai đường dẫn hoặc 500 do bị crash. Telegram cần phản hồi 2xx nhanh chóng, nếu không sẽ gửi lại.
Tiện ích khác
Công cụ tìm chat IDCông cụ escape MarkdownV2 & HTMLCông cụ xác thực initData của Mini AppBot API Tester