Telegram Bot API به فارسی: آموزش‌ها و ابزارهای رایگان
این سایت برای توسعه‌دهندگانی است که با Telegram Bot API کار می‌کنند: آموزش‌های فارسی و کاربردی درباره توکن، چت آیدی، وب هوک و ارسال پیام، همراه با ابزارهای رایگانی که مستقیم در مرورگر اجرا میشوند. میتوانید هر 185 متد Bot API 10.3 را بدون نصب چیزی امتحان کنید، مستندات OpenAPI را ببینید و Mini App خود را تست کنید.
آموزش‌های فارسی ربات تلگرام
راهنماهای قدم‌به‌قدم با کد آماده curl، Python و JavaScript؛ از ساخت ربات و گرفتن توکن تا وب هوک و ارسال پیام.
ساخت ربات تلگرام: آموزش قدم‌به‌قدم از BotFather تا اولین پیام با Python
ساخت ربات تلگرام قدم‌به‌قدم: ساخت ربات در BotFather، گرفتن توکن، تست با getMe، پیدا کردن chat id و ارسال اولین پیام با curl و Python.
ارسال پیام با ربات تلگرام از طریق API تلگرام (sendMessage)
آموزش ارسال پیام با ربات تلگرام از طریق API تلگرام: متد sendMessage با curl، Python و JavaScript، قالب‌بندی HTML و MarkdownV2، دکمه شیشه‌ای و رفع خطاها.
توکن ربات تلگرام: چیست، چطور بگیریم، بررسی و باطل کنیم
توکن ربات تلگرام چیست و از کجا بگیریم؟ گرفتن توکن از BotFather، پیدا کردن توکن ربات قبلی، تست با getMe، باطل کردن توکن لو رفته و نگهداری امن آن.
وب هوک ربات تلگرام: راه‌اندازی setWebhook، بررسی و رفع خطا
آموزش ست وب هوک تلگرام با setWebhook: پیش‌نیازهای HTTPS و پورت‌ها، secret_token، بررسی با getWebhookInfo، حذف وب هوک و رفع خطاهای رایج مثل 409.
چت آیدی تلگرام: چیست، کجاست و چطور chat id کاربر، گروه و کانال را پیدا کنیم
چت آیدی تلگرام کجاست؟ پیدا کردن chat_id کاربر، گروه، سوپرگروه، کانال و تاپیک با getUpdates، معنی آیدی‌های منفی و رفع مشکل نتیجه خالی و خطای 409.
ابزارهای آنلاین
Bot API Tester
هر 185 متد Bot API 10.3 را از مرورگر صدا بزنید: فرم پارامترها، long polling برای getUpdates و نمایش خوانای پاسخ JSON.
Swagger / OpenAPI
مستندات OpenAPI 3.1 برای همه 185 متد؛ با توکن ربات Authorize کنید و با Try it out درخواست واقعی بفرستید.
Mini App Tester
Telegram.WebApp JS API را در مرورگر معمولی (حالت mock) یا داخل خود تلگرام تست کنید.
پرسش‌های متداول درباره شروع کار با ربات‌های تلگرام
Telegram Bot API چیست و چه فرقی با API تلگرام (MTProto) دارد؟
Bot API یک رابط HTTP برای ساخت ربات است: درخواست HTTPS میفرستید و پاسخ JSON میگیرید. API اصلی تلگرام (MTProto) برای ساخت کلاینتهای تلگرام و کار با حسابهای کاربری است و پیچیدهتر است.
برای شروع کار با Bot API به چه چیزهایی نیاز دارم؟
یک حساب تلگرام، یک ربات ساختهشده در BotFather همراه با توکن آن، و ابزاری برای ارسال درخواست HTTPS مثل curl، Python یا Bot API Tester همین سایت.
آیا استفاده از Telegram Bot API هزینه دارد؟
خیر، ساخت ربات و ارسال پیام به کاربران رایگان است. فقط اگر ربات بخواهد بیش از حدود 30 پیام در ثانیه ارسال انبوه کند، می‌تواند ارسال پولی را فعال کند که برای هر پیام 0.1 Telegram Star هزینه دارد.
آیا بدون سرور میتوانم ربات را تست کنم؟
بله. با Bot API Tester میتوانید از مرورگر getMe، getUpdates و sendMessage را اجرا کنید. برای اینکه ربات همیشه آنلاین باشد و به پیامها جواب بدهد، به سروری نیاز دارید که کد ربات را اجرا کند.
آیا توکن ربات من در این سایت ذخیره میشود؟
توکن فقط در localStorage مرورگر خودتان میماند و درخواستها مستقیم از مرورگر به api.telegram.org ارسال میشوند. این سایت یک پروژه مستقل است و وابسته به تلگرام نیست.