پارامترها
پاسخ
Bot API Tester ابزاری رایگان برای تست ربات تلگرام به‌صورت آنلاین و مستقیم در مرورگر است: توکن ربات را وارد کنید، یکی از 185 متد Bot API 10.3 را انتخاب کنید، فرم پارامترها را پر کنید و پاسخ JSON را همان لحظه ببینید. این ابزار یک محیط Telegram Bot API آنلاین و جایگزینی سبک برای Postman است؛ با آن می‌توانید ربات را امتحان کنید، توکن را بررسی کنید یا یک درخواست را بدون نوشتن کد دیباگ کنید.
روش تست ربات تلگرام با Bot API Tester
- در @BotFather با دستور
/newbotیک ربات بسازید و توکن آن را بگیرید (جزئیات در راهنمای دریافت توکن ربات). - توکن را در فیلد توکن بالای صفحه وارد کنید. توکن در localStorage مرورگر شما ذخیره می‌شود.
- متد
getMeرا اجرا کنید تا مطمئن شوید توکن درست کار می‌کند. - متد موردنظر را از 19 دسته‌بندی یا با جستجو پیدا کنید، یا آن را مستقیماً با hash آدرس باز کنید؛ مثلاً
telegram-bot-api-tester.html#sendMessage. - پارامترها را پر کنید (پارامترهای الزامی علامت دارند) و روی «اجرا» کلیک کنید یا Ctrl+Enter را بزنید.
- نتیجه را در نمایشگر JSON تاشو بخوانید و هر بخشی را که لازم دارید کپی کنید.
تست توکن ربات تلگرام با getMe
متد getMe عملاً یک توکن‌چکر است: اگر توکن معتبر باشد، پاسخ "ok": true همراه با شیء User ربات (شامل id و username) برمی‌گردد. خطای 401 Unauthorized یعنی توکن اشتباه کپی شده یا باطل شده است. اگر توکن جایی لو رفت، آن را در @BotFather باطل کنید و توکن جدید بگیرید.
کاربردهای رایج
- پیدا کردن chat ID. Long Polling را شروع کنید، به ربات پیام بدهید و مقدار
message.chat.idرا در تاریخچه آپدیت‌ها ببینید؛ تستر 100 آپدیت آخر را نگه می‌دارد. توضیح کامل در راهنمای پیدا کردن chat ID در تلگرام. - تست پیام و قالب‌بندی. قبل از کدنویسی،
sendMessageرا باparse_mode، کیبورد اینلاین (دکمه‌های شیشه‌ای) و پیش‌نمایش لینک امتحان کنید؛ جزئیات در راهنمای ارسال پیام با Bot API. - مدیریت وب‌هوک. متدهای
setWebhook،getWebhookInfoوdeleteWebhookرا طبق راهنمای وب‌هوک ربات تلگرام فراخوانی کنید. - آشنایی با Bot API 10.x. پیام‌های غنی، پیام‌های موقت و join request queries در کنار متدهای کلاسیک آمده‌اند و با توکن شما آماده اجرا هستند.
از آنجا که getUpdates هنگام فعال بودن وب‌هوک کار نمی‌کند، شروع Long Polling ابتدا deleteWebhook را صدا می‌زند (آپدیت‌های در صف حذف نمی‌شوند). اگر ربات شما در محیط production روی وب‌هوک کار می‌کند، بعد از تست آن را دوباره با setWebhook تنظیم کنید.
حریم خصوصی: توکن در مرورگر شما می‌ماند
تستر یک صفحه استاتیک است و بک‌اند اختصاصی ندارد. توکن در localStorage مرورگر نگه داشته می‌شود و هر درخواست مستقیماً از مرورگر شما به api.telegram.org می‌رود که از CORS پشتیبانی می‌کند؛ توکن و ترافیک API شما هرگز از سرورهای ما عبور نمی‌کند. با این حال، برای آزمایش بهتر است از یک ربات تستی جداگانه استفاده کنید.
ابزارها و مراجع دیگر
توضیحات OpenAPI 3.1 همه متدها را در Swagger مرور کنید، JavaScript API مربوط به Telegram.WebApp را با Mini App Tester تست کنید یا برای پارامترها و مثال‌های curl، Python و JavaScript به مرجع متدها سر بزنید.
پرسش‌های متداول
چطور بفهمم توکن ربات تلگرام معتبر است؟
توکن را در تستر وارد کنید و متد getMe را اجرا کنید. توکن معتبر پاسخ "ok": true را همراه با id و username ربات برمی‌گرداند؛ خطای 401 Unauthorized یعنی توکن اشتباه است یا باطل شده است.
آیا وارد کردن توکن ربات در این ابزار امن است؟
توکن فقط در localStorage مرورگر شما ذخیره می‌شود و درخواست‌ها مستقیماً از مرورگر به api.telegram.org می‌روند، نه از سرورهای ما. روی کامپیوتر مشترک بعد از کار توکن را پاک کنید و اگر توکن لو رفت، با دستور /revoke در @BotFather آن را باطل کنید.
آیا می‌توانم به‌جای Postman از Bot API Tester استفاده کنم؟
بله، برای Telegram Bot API. هر متد از قبل فرم پارامتر با نوع داده و توضیحات دارد، نیازی به ایمپورت کالکشن نیست و Long Polling، تاریخچه آپدیت‌ها و نمایشگر JSON در خود ابزار وجود دارد.
چرا getUpdates نتیجه خالی برمی‌گرداند؟
معمولاً فقط آپدیت جدیدی وجود ندارد؛ اول به ربات پیام بدهید. آپدیت‌ها فقط 24 ساعت نگه داشته می‌شوند و تا وقتی وب‌هوک تنظیم شده باشد، getUpdates کار نمی‌کند (409 Conflict)؛ به همین دلیل تستر پیش از شروع Long Polling متد deleteWebhook را صدا می‌زند.
این تستر از کدام نسخه Bot API پشتیبانی می‌کند؟
Bot API 10.3 (منتشرشده در 24 اوت 2026): همه 185 متد در 19 دسته‌بندی، از جمله پیام‌های غنی (rich messages)، پیام‌های موقت (ephemeral messages) و join request queries.
آپدیت‌ها 0
آپدیتی وجود ندارد.
برای شروع Long Polling روی «شروع» کلیک کنید.