# Telegram Bot API compatibility

این پروژه بر مبنای مستندات رسمی Telegram Bot API در تاریخ 2026-08-29 طراحی شده است.

- نسخه بررسی‌شده: Bot API 10.3 (منتشرشده در 2026-08-24)
- InlineKeyboardButton از `style` با مقادیر `primary`, `success`, `danger` استفاده می‌کند.
- `callback_data` در پروژه کوتاه نگه داشته می‌شود و سقف 64 بایت رعایت می‌شود.
- همه Callback Queryها بلافاصله با `answerCallbackQuery` پاسخ داده می‌شوند.
- Webhook با `secret_token` و هدر `X-Telegram-Bot-Api-Secret-Token` اعتبارسنجی می‌شود.
- عضویت Join Required با `getChatMember` بررسی می‌شود؛ برای تضمین بررسی کاربران دیگر، Bot باید در کانال/گروه مربوطه دسترسی مناسب داشته باشد.
- آلبوم‌ها با `media_group_id` دریافت و با `sendMediaGroup` ارسال می‌شوند.
- Mediaها با Telegram `file_id` نگهداری می‌شوند و نیازی به دانلود و آپلود مجدد ندارند.
- خطای 429 با `retry_after` مدیریت می‌شود.

مرجع رسمی: `https://core.telegram.org/bots/api`