StaticGramBot API

Отличия от 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 PassportsetPassportDataErrors, 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 пока не заполняются (в initData Mini Apps language_code есть).
  • logOut / close просто возвращают true: сервер один, переносить нечего.
  • Частота запросов: жёсткого RPS-лимита нет, но обрабатывайте 429. См. Ошибки и лимиты.
  • Mini Apps: подключайте JS SDK с https://staticgram.top/js/telegram-web-app.js; ключ для проверки signature свой. См. Mini Apps.

Методы с ограничениями

Полный список частично поддерживаемых методов и что именно в них не работает. Тот же статус показан бейджем на странице каждого метода.

МетодЧто не поддерживается

Описания методов и типов взяты из официальной документации Telegram Bot API (Bot API 10.3). Адрес API: https://api.staticgram.top