وقتی حجم فایل‌ها بالا می‌رود، نوسان شبکه، قطعی‌های کوتاه، محدودیت‌های نرخ (Rate Limit) و سقف اندازه‌ی مجاز هر درخواست، همه‌وهمه می‌توانند ارسال/دریافت را شکننده کنند. از سوی دیگر، Bot API یک رابط HTTP استاندارد با قواعد مشخص است؛ بنابراین باید منطقی طراحی کنیم که قطعه‌قطعه‌سازی، ازسرگیری، تأیید یکپارچگی و کنترل پهنای باند را در سمت خودمان پیاده کند تا هم انتقال‌ها پایدار باشد و هم از محدودیت‌ها عبور نکنیم.در این مقاله میخواهیم بدانیم که چگونه آپلود فایل حجیم در Bot API تلگرام را داشته باشیم.
نکته: مقادیر دقیق سقف اندازه‌ی فایل و نرخ‌ها ممکن است با گذر زمان تغییر کنند. برای تصمیم‌های حساس، همیشه مستندات رسمی را بررسی کنید و بر اساس واقعیت‌های زیرساختی خود پروفایل بگیرید.
برای آپلود فایل حجیم در Bot API تلگرام، بهتر است مستقیماً آپلود کنیم یا URL بدهیم؟
چه گزینه‌هایی داریم و کِی از هرکدام استفاده کنیم؟
-
آپلود مستقیم (multipart/form-data)
ساده است اما معمولاً سقف اندازه‌ی سخت‌گیرانه‌تری دارد؛ اگر انتقال شکست بخورد، تمام بدنه باید از ابتدا تکرار شود. -
ارائهٔ URL به تلگرام (ارسال InputFile به‌صورت URL)
فایل را در یک فضای ابری/CDN خودتان قرار می‌دهید و فقط URL می‌فرستید؛ تلگرام از آن URL دانلود می‌کند. این الگو برای فایل‌های بزرگ عملی‌تر است، چون:-
می‌توانید chunking + resume را بین کاربر و فضای ابری خودتان پیاده کنید؛
-
تلگرام فقط دانلود نهایی را انجام می‌دهد؛
-
کنترل کامل روی سرعت، محدودیت‌ها و احراز هویت URL دارید (مثلاً لینک یک‌بارمصرف).
-
جمع‌بندی: برای فایل‌های واقعاً حجیم، معمولاً معماری «آپلود به ذخیره‌ساز خودتان → ارسال URL به Bot API» پایدارتر و مقیاس‌پذیرتر است.
chunking را چگونه طراحی کنیم تا هم پایدار باشد و هم ساده نگه داریم؟
چه اندازهٔ تکه (chunk size) انتخاب کنیم؟
-
بازه‌ی ۵ تا ۱۶ مگابایت در عمل تعادل خوبی میان سربارِ HTTP و حافظه ایجاد می‌کند.
-
شبکه‌های ناپایدار: chunks کوچک‌تر (۵–۸MB).
-
دیتاسنتر یا شبکهٔ داخلی: chunks بزرگ‌تر (۸–۱۶MB).
متادادهٔ ضروری برای هر آپلود چیست؟
-
file_id داخلی (UUID) برای کل فایل؛
-
size کل فایل و chunk_size ثابت؛
-
checksum سراسری (SHA-256) و checksum هر chunk؛
-
bitset/manifest وضعیت دریافت chunkها (true/false) برای ازسرگیری.
پروتکل سادهٔ آپلود از دید کلاینت
-
INIT: درخواست شروع با اندازه، نام و hash اعلامی → سرور، file_id برمی‌گرداند.
-
UPLOAD: ارسال chunkها با هدرهای
Content-Rangeیا پارام‌های offset/index + hash همان chunk. -
COMMIT: پس از آخرین chunk، سرور hash سراسری را می‌سنجد و در صورت صحت، فایل را «نهایی» می‌کند.
-
PUBLISH: فایل نهایی به یک URL کوتاه‌عمر (Signed URL) قابل دانلود برای تلگرام نگاشت می‌شود.
resume دقیقاً چگونه باید کار کند تا انتقال نیمه‌کاره هدر نرود؟
الگوی ازسرگیری امن بر پایهٔ manifest
-
manifest برای هر file_id نگه دارید (اندازه، chunk_size، تعداد کل chunk، bitset دریافت‌شده، زمان آخرین فعالیت).
-
اگر اتصال قطع شد، کلاینت به‌جای شروع از صفر، فقط chunkهای دریافت‌نشده یا نامعتبر را دوباره می‌فرستد.
-
برای جلوگیری از «بازپخش» ناخواسته، هر chunk را با hash خودش و index صحیح اعتبارسنجی کنید.
راهکار نهایی برای ازسرگیری دانلود
-
اگر به کاربر نهایی لینک دانلود مستقیم می‌دهید، روی لایهٔ CDN/ابری خود HTTP Range را فعال کنید تا کلاینت‌ها بتوانند از هر جایی دانلود را ادامه دهند.
-
اگر از سمت ربات نیاز به دانلود از تلگرام دارید (getFile → file_path)، دانلودر شما باید Range Requests و backoff را پشتیبانی کند تا با قطعی کوتاه، کل فایل تکرار نشود.
content hash را کجا و چگونه حساب کنیم تا هم دقیق باشد و هم سریع؟
چه الگوریتمی انتخاب کنیم؟
-
SHA-256 تعادل خوبی بین سرعت و ایمنی دارد؛ برای تشخیص خطای تصادفی، حتی MD5 هم کار می‌کند، ولی برای امنیت توصیه نمی‌شود.
-
در آپلود، hash هر chunk را در کلاینت محاسبه کنید؛ سرور هر chunk را جداگانه می‌سنجد و در پایان hash کل فایل را روی concatenation بایت‌ها می‌سازد.
امتیازهای hash per-chunk
-
تشخیص سریع خراب‌شدن قطعه بدون نیاز به محاسبهٔ کل فایل؛
-
امکان deduplication: اگر chunk با hash مشخص قبلاً ذخیره شده، می‌توانید از کش استفاده کنید؛
-
در resume، فقط همان chunk خراب یا مفقود را دوباره می‌فرستید.
مصرف پهنای باند را چگونه کنترل کنیم تا هم سریع باشد و هم ارزان؟
الگوریتم‌های محدودکننده (Rate Limiting)
-
Token Bucket / Leaky Bucket برای کنترل سرعت متوسط و پیک؛
-
Per-User/Per-Chat/Per-File سقف بگذارید تا یک کاربر منابع را تصاحب نکند.
کنترل هم‌زمانی (Concurrency)
-
تعداد آپلود/دانلود موازی را سقف‌گذاری کنید؛
-
صف پیام/کار (Queue) داشته باشید تا درخواست‌ها منصفانه توزیع شوند؛
-
اولویت‌بندی: فایل‌های حیاتی یا کوچک‌تر را جلو بیندازید (کاهش زمان انتظار ادراک‌شده).
پهنای باند تطبیقی (Adaptive Throttling)
-
در ساعات شلوغی، سقف را پایین بیاورید؛
-
به‌محض مشاهدهٔ 429/FloodWait از سمت Bot API، backoff نمایی و صف‌بندی مجدد را فعال کنید.
فشرده‌سازی و «هوشمندی محتوا»
-
اگر ماهیت فایل فشرده‌پذیر است (لُگ متنی، CSV)، فشرده‌سازی سمت کلاینت/سرور ارزشمند است؛
-
برای رسانه‌هایی که قبلاً فشرده‌اند (ویدیو/تصویر مدرن)، فشرده‌سازی دوباره سودی ندارد و CPU را هدر می‌دهد.
چطور با محدودیت‌های Bot API کنار بیاییم بدون اینکه تجربهٔ کاربر خراب شود؟
-
ارسال URL به‌جای باینری مستقیم برای فایل‌های بسیار بزرگ؛
-
تقسیم عملیات: متاداده را سریع بفرستید، «بدنهٔ حجیم» را به مسیر CDN خود بسپارید؛
-
file_id را ذخیره کنید: وقتی فایلی یک بار به تلگرام فرستاده شد، در دفعات بعد به‌جای آپلود مجدد می‌توانید همان file_id را ارسال کنید (صرفه‌جویی بزرگ در پهنای باند و زمان).
برای دانلود سریع‌تر، چه الگوهایی جواب می‌دهند؟
-
pre-signed URLs با انقضای کوتاه و محدودهٔ IP؛
-
CDN با Edge نزدیک کاربر + فعال‌سازی Range؛
-
cache-control هوشمند برای فایل‌های پرتکرار؛
-
prefetch برای فایل‌هایی که می‌دانید کاربر بلافاصله پس از پیام، آن‌ها را می‌خواهد.
مانیتورینگ چه سیگنال‌هایی به بهینه‌سازی کمک می‌کند؟
-
TTFB و صدک‌های ۹۵/۹۹ زمان آپلود/دانلود؛
-
نرخ شکست per-chunk و درصد ازسرگیری موفق؛
-
429/FloodWait و زمان‌های backoff؛
-
مصرف پهنای باند بر حسب کاربر/چت/فایل؛
-
نرخ deduplication (صرفه‌جویی ذخیره‌سازی/ترافیک).
چه خطاهای رایجی باید از آن‌ها دوری کنیم؟
-
آپلود مستقیم فایل‌های بسیار بزرگ بدون resume؛
-
نبود hash per-chunk و کشف دیرهنگام خرابی؛
-
نداشتن queue + priority و گرفتارشدن در صفی از انتقال‌های طولانی؛
-
بی‌توجهی به 429/FloodWait و تکرار کورکورانه‌ی درخواست‌ها؛
-
نادیده‌گرفتن file_id برای ارسال‌های تکراری.
KingMember چه منابعی برای تکمیل این مسیر دارد؟
برای امنیت حساب و پیشگیری از ریسک‌های انسانی، راهنمای تأیید دو مرحله‌ای تلگرام را ببین. برای مدیریت محتوای رسانه‌ای و کیفیت خروجی، این راهنما هم مفید است: افزایش کیفیت عکس تلگرام. اگر با کانال‌ها و توزیع فایل به جمع بزرگ سروکار داری، این مقاله مکمل خوبی‌ست: ساخت و مدیریت کانال تلگرام.
جمع‌بندی؛ معماری پیشنهادی یک‌خطی چیست؟
-
آپلود بزرگ: کلاینت ←(chunk+hash+resume)→ فضای ابری شما → (URL امضاشده) → Bot API
-
دانلود بزرگ: Bot API/file_id یا URL شما → CDN با Range + پهنای‌باند تطبیق
-
پایداری: queue + priority + token bucket + backoff نمایی
-
صحت: hash per-chunk + hash سراسری + manifest/bitset
-
صرفه‌جویی: استفادهٔ مجدد از file_id و حذف آپلود تکراری
