Отличия от Telegram
Из 194 методов Bot API 10.3 полностью поддерживаются 194, ещё 0 работают с ограничениями. Ниже то, что стоит учесть при переносе бота.
Недавно добавлено (октябрь 2026)
Если вы читали документацию раньше: эти возможности теперь работают. В колонке «Особенности» указано, чем поведение отличается от api.telegram.org; «как в Telegram» означает, что отличий нет.
| Возможность | Методы | Особенности |
|---|---|---|
| Mini Apps | @BotFather /newapp, /myapps; answerWebAppQuery, savePreparedInlineMessage, setChatMenuButton | подписанный initData (hash + signature), CloudStorage, openInvoice, прямые ссылки. См. Mini Apps |
| StaticGram Login (вход на сайты) | @BotFather /setlogin, /logininfo, /resetloginsecret; login_url в InlineKeyboardButton | кнопка staticgram-widget.js, JS SDK и OpenID Connect на oauth.staticgram.top. См. StaticGram Login |
| Файлы до 2000 МБ | все send*, getFile | фото и стикеры до 25 МБ, по URL до 10 МБ. См. Файлы |
| Telegram Passport | setPassportDataErrors, passport_data в Message | нет проверки телефона и e-mail (доступен только телефон аккаунта); публичный ключ бота не регистрируется (принимается любой PEM) |
| Гостевой режим | answerGuestQuery, guest_message | включается /setguestmode; ответ публикуется от имени вызвавшего пользователя через бота |
| Платные инвайт-ссылки | createChatSubscriptionInviteLink, editChatSubscriptionInviteLink | только каналы; период 30 дней, 1-10 000 статиков; редактируется только name |
| Платные медиа | sendPaidMedia, purchased_paid_media | личные чаты, каналы, супергруппы, бизнес-чаты |
| Топики в личных чатах | createForumTopic и др. с chat_id пользователя | включается /settopics; одна отметка прочтения на весь чат |
| Live-локация в inline-сообщениях | editMessageLiveLocation, stopMessageLiveLocation с inline_message_id | как в Telegram |
| Реакции от имени чата | deleteMessageReaction (actor_chat_id), actor_chat в message_reaction | как в Telegram |
| Платные реакции | message_reaction_count с {"type":"paid"}, paid в available_reactions | платные реакции ставят пользователи в каналах; total_count = сумма статиков. Боты ставить их не могут (setMessageReaction → 400, как в Telegram). message_reaction_count приходит сразу, без группировки, и не присылается при удалении реакций админом или удалении сообщения |
Области unique_gift в историях | postStory, editStory | как в Telegram (не больше одной области). Сожжённый подарок отклоняется (STARGIFT_SLUG_INVALID) |
| Подарки бизнес-аккаунтов | getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift | улучшенные подарки отдаются как OwnedGiftUnique (также в getUserGifts, getChatGifts). UniqueGift.colors не заполняется: на сервере нет цветовых схем коллекционных подарков; was_refunded не встречается (возвратов нет); окна конвертации в статики нет. В transferGift активность чата за 24 часа проверяется только для получателя-пользователя |
| Управляемые боты | кнопка request_managed_bot, managed_bot_created, обновление managed_bot, getManagedBotToken, replaceManagedBotToken, getManagedBotAccessSettings, setManagedBotAccessSettings | режим включается в @BotFather → бот → Настройки → «Управление ботами» (по умолчанию выключен, как в Telegram). managed_bot приходит при создании бота и смене его токена; смены владельца бота нет. Кнопка в группе показывается, но поделиться через неё нельзя (BUTTON_DATA_INVALID) |
| Live-фото | sendLivePhoto, InputMediaLivePhoto | видео до 10 с и 10 МБ, обе части загрузкой или по file_id (URL не поддерживается, как в Telegram). Размеры и длительность видео определяются по файлу (MP4/MOV) |
| Личные сообщения каналов и предложенные посты | direct_messages_topic_id, suggested_post_parameters во всех send*, approveSuggestedPost, declineSuggestedPost, direct_messages_topic, suggested_post_info | бот с правом can_manage_direct_messages отвечает от имени канала в существующую тему (direct_messages_topic_id = id пользователя); бот без права пишет только в свою тему и платит цену сообщения из своего баланса статиков. sendInvoice и sendPaidMedia в такой чат → 400. При решении по предложенному посту edited_message не присылается; suggested_post_paid показывает долю канала (85%) |
Не поддерживается
- Платёжные провайдеры и фиатные валюты. Только статики (
XTR), см. Оплата статиками. Счета с доставкой иInputInvoiceMessageContentотклоняются. file_idиз Telegram. Файлы нужно загрузить заново, см. Файлы.
Работает иначе
- Нет обычных групп. Это архитектурное решение сервера: любая группа, включая созданную как обычную (
messages.createChat), сразу является супергруппой. Поэтомуchat.typeбываетprivate,supergroupилиchannel, но неgroup; апдейтовmigrate_to_chat_id/migrate_from_chat_idне бывает. Id супергрупп и каналов имеют вид-100…. Код, который обрабатывает иgroup, иsupergroup, работает без изменений. - Фото: уменьшенные копии не генерируются, размеры
mиxуказывают на один файл. Видео: еслиwidth/height/durationне переданы, они берутся из файла (MP4/MOV/WEBM). @usernameв chat_id работает для публичных каналов, супергрупп и ботов.- Файлы: загрузка и скачивание до 2000 МБ,
file_pathсовпадает сfile_id. См. Файлы. - Вебхуки: self-signed сертификат и
ip_addressне поддерживаются, разрешён HTTP. - User: поля
language_codeиadded_to_attachment_menuв обновлениях Bot API пока не заполняются (вinitDataMini Appslanguage_codeесть). - logOut / close просто возвращают
true: сервер один, переносить нечего. - Частота запросов: жёсткого RPS-лимита нет, но обрабатывайте
429. См. Ошибки и лимиты. - Mini Apps: подключайте JS SDK с
https://staticgram.top/js/telegram-web-app.js; ключ для проверкиsignatureсвой. См. Mini Apps.
Методы с ограничениями
Полный список частично поддерживаемых методов и что именно в них не работает. Тот же статус показан бейджем на странице каждого метода.
| Метод | Что не поддерживается |
|---|