Telegram Bot API

بررسی وب هوک ربات تلگرام

وب هوک ربات تلگرام خود را با یک کلیک بررسی کنید: ابزار getWebhookInfo را صدا می‌زند، آدرس، آپدیت‌های در صف و آخرین خطای تحویل را همراه با راهنمای رفع آن نشان می‌دهد و اجازه می‌دهد وب هوک را تنظیم یا حذف کنید.

توکن در مرورگر شما (localStorage) می‌ماند و فقط به api.telegram.org ارسال می‌شود.

تنظیم یا تغییر وب هوک

چطور وب هوک ربات تلگرام را بررسی کنیم

  1. توکن ربات را وارد کنید. اگر ربات در محیط تست است، سرور تست را تیک بزنید.
  2. بررسی وب هوک را بزنید. یکی از سه نتیجه را می‌گیرید: وب هوکی نیست (ربات از getUpdates استفاده می‌کند)، وب هوک بدون خطا در 24 ساعت گذشته، یا مشکل تحویل همراه با زمان و متن آخرین خطا و یک راهنما.
  3. شمارنده آپدیت‌های در صف را بررسی کنید. بیش از 100 برجسته می‌شود: آپدیت‌ها در حال انباشته شدن‌اند، چون سرور شما آن‌ها را نمی‌پذیرد.
  4. در پایین پاسخ کامل getWebhookInfo را می‌بینید: url، has_custom_certificate، pending_update_count، last_error_date، last_error_message، max_connections و فیلدهای دیگر.
  5. برای تغییر، بخش تنظیم یا تغییر وب هوک را باز کنید: یک آدرس HTTPS و در صورت نیاز secret_token وارد کنید، انتخاب کنید آپدیت‌های در صف حذف شوند یا نه و setWebhook یا deleteWebhook را بزنید. بررسی به‌طور خودکار دوباره اجرا می‌شود.

خطاهای رایج وب هوک

راهنما بر اساس متن last_error_message انتخاب می‌شود:

شکل خطاچه چیزی را بررسی کنیم
SSL / گواهیگواهی معتبر برای دامنه (یا گواهی خودامضا که از طریق پارامتر certificate در setWebhook آپلود شده)، TLS 1.2+.
Wrong response from the webhook: 4xx/5xxمسیر، بررسی secret_token و خطاهای سرور — تلگرام 2xx انتظار دارد.
Timeout / connection resetسرور باید از اینترنت روی پورت 443، 80، 88 یا 8443 در دسترس باشد و سریع پاسخ دهد.
Connection refusedهیچ سرویسی روی پورت گوش نمی‌دهد یا فایروال تلگرام را مسدود می‌کند.
Host can't be resolvedرکوردهای DNS دامنه وب هوک.

فرم فقط url، secret_token و drop_pending_updates را می‌فرستد. secret (1 تا 256 کاراکتر A-Z a-z 0-9 _ -) در هدر X-Telegram-Bot-Api-Secret-Token هر درخواست می‌رسد. برای allowed_updates، max_connections یا گواهی از /fa/telegram-bot-api-tester.html#setWebhook استفاده کنید.

حریم خصوصی

توکن در localStorage مرورگر شما می‌ماند و getWebhookInfo، setWebhook و deleteWebhook مستقیماً به api.telegram.org ارسال می‌شوند — هیچ چیز از سرور ما عبور نمی‌کند. همین فراخوانی در /fa/telegram-bot-api-tester.html#getWebhookInfo هم در دسترس است. راهنمای کامل راه‌اندازی در /fa/guides/telegram-bot-webhook.html آمده است و 409 Conflict و خطاهای دیگر در /fa/guides/telegram-bot-api-errors.html توضیح داده شده‌اند.

پرسش‌های متداول

چطور بفهمم ربات تلگرام من وب هوک دارد؟

getWebhookInfo را صدا بزنید. اگر url خالی باشد، وب هوکی تنظیم نشده و ربات با getUpdates کار می‌کند. ابزار بالا این متد را برای شما صدا می‌زند و نتیجه را توضیح می‌دهد.

چطور وب هوک ربات تلگرام را حذف کنم؟

deleteWebhook را صدا بزنید — در ابزار بخش تنظیم یا تغییر وب هوک را باز کنید و deleteWebhook را بزنید. گزینه حذف آپدیت‌های در صف را فقط وقتی تیک بزنید که می‌خواهید آپدیت‌های در صف دور ریخته شوند. بعد از آن getUpdates دوباره کار می‌کند.

چرا pending_update_count مدام بیشتر می‌شود؟

تلگرام نمی‌تواند آپدیت‌ها را تحویل دهد: سرور شما در دسترس نیست، کند است یا با وضعیتی غیر 2xx پاسخ می‌دهد. last_error_message را ببینید؛ تلگرام مدام دوباره تلاش می‌کند و آپدیت‌ها حداکثر 24 ساعت نگه داشته می‌شوند.

خطای "Wrong response from the webhook" یعنی چه؟

سرور شما با وضعیت HTTP غیر از 2xx پاسخ داده است، مثلاً 404 برای مسیر اشتباه یا 500 برای کرش. تلگرام پاسخ سریع 2xx انتظار دارد و در غیر این صورت دوباره تلاش می‌کند.

ابزارهای دیگر

یافتن چت آیدیاسکیپ MarkdownV2 و HTMLاعتبارسنجی initData در Mini AppBot API Tester