Telegram Bot API 10.0: боты выходят за пределы чата — Telegram API и Разработка Ботов на TGLand.ru

Telegram Bot API 10.0, опубликованный в официальном changelog 8 мая 2026 года, — это не косметическое обновление, а заметный сдвиг в модели взаимодействия ботов: появились гостевой режим, расширенная коммуникация bot-to-bot, новые инструменты для опросов, реакций, Live Photo и управления ботами. Главная практическая ценность версии — теперь бот может быть временным «приглашённым участником» сценария, не становясь полноценным членом чата и не получая доступ к истории.

Главное: Bot API 10.0 делает ботов контекстными инструментами, а не постоянными участниками чата

До версии 10.0 архитектура Telegram-ботов в большинстве сценариев строилась вокруг двух привычных моделей: бот либо находится в чате и получает разрешённые обновления, либо работает через inline mode, когда пользователь сам выбирает результат и отправляет его в диалог. Bot API 10.0 добавляет третью модель — Guest Mode, при которой бот может быть вызван в поддерживаемом чате, получить ограниченный контекст и ответить, не становясь участником этого чата.

Это важно не только для AI-ассистентов. Гостевой бот подходит для переводчиков, факт-чекеров, модерационных помощников, утилит по работе с документами, корпоративных агентов и любых сервисов, которые должны вмешиваться точечно: «позвали → получил контекст → ответил → исчез». Такой подход снижает трение для пользователей и уменьшает объём доступа, который нужно давать боту.

В результате Telegram явно двигает Bot API в сторону одноразовых, контекстных, агентных взаимодействий. Бот больше не обязан быть постоянной сущностью в группе, чтобы принести пользу конкретному сообщению или ветке обсуждения.

Что именно вышло 8 мая 2026 года

Официальная документация Telegram указывает релиз Bot API 10.0 от 8 мая 2026 года. В changelog обновление сгруппировано по нескольким направлениям: Guest Mode, управление чатами, опросы, Live Photos и общие изменения для Business Bots, bot-to-bot коммуникации и managed bots.

Ключевые блоки версии:

Направление	Что изменилось	Практический смысл
Guest Mode	Бот может получать отдельные guest-сообщения и отвечать через `answerGuestQuery`	Вызов бота без добавления в чат
Chat Management	Новые методы и права для реакций, расширения администраторских списков и видимости сообщений ботов	Больше контроля для модерации и групповых сценариев
Polls	Медиа в опросах, медиа в вариантах ответов, member-only и country-based ограничения, один вариант ответа как минимум	Опросы становятся полноценным интерактивным форматом
Live Photos	Новый тип Live Photo и метод `sendLivePhoto`	Боты могут отправлять фото с коротким видео
Business / Managed Bots	Больше возможностей для бизнес-ботов и управления ботами	Упрощение агентных и SaaS-сценариев

Версия 10.0 логически продолжает линию релизов 2026 года: Bot API 9.4 добавил темы в приватных чатах ботов и Premium-связанные возможности, 9.5 — сущность date_time, теги участников и черновики сообщений, 9.6 — managed bots и крупное расширение опросов. Bot API 10.0 собирает эти направления в более цельную платформу для сложных бот-сценариев.

Guest Mode: главное нововведение версии 10.0

Как работает гостевой бот

Guest Mode позволяет боту взаимодействовать с пользователями в группах и приватных чатах без вступления в них. Пользователь упоминает гостевого бота — например, @botname — или отвечает на одно из его сообщений. После этого бот получает специальное обновление и может отправить один ответ в тот же контекст.

Важно: гостевой режим не даёт доступ к истории чата, списку участников и будущим сообщениям. Бот видит только релевантный контекст вызова и не продолжает получать обновления, пока его снова не упомянут или пока ему снова не ответят. Это делает Guest Mode более приватной и управляемой альтернативой постоянному добавлению ботов в группы.

Новые поля и методы

Для Guest Mode в Bot API 10.0 добавлены:

Элемент API	Назначение
`User.supports_guest_queries`	Показывает, поддерживает ли бот гостевые запросы; возвращается в `getMe`
`Update.guest_message`	Новое обновление с гостевым сообщением
`Message.guest_query_id`	Идентификатор guest-запроса, который используется для ответа
`Message.guest_bot_caller_user`	Пользователь, вызвавший гостевого бота
`Message.guest_bot_caller_chat`	Чат, из которого был вызван бот
`SentGuestMessage`	Объект результата отправки guest-сообщения
`answerGuestQuery`	Метод ответа на guest-запрос

Официальная документация описывает answerGuestQuery как метод ответа на полученное guest-сообщение; он принимает guest_query_id и result типа InlineQueryResult, а при успехе возвращает SentGuestMessage.

Чем Guest Mode отличается от inline mode

Inline mode решает задачу «найти или подготовить контент, который пользователь сам отправит в чат». Guest Mode решает другую задачу: «позвать бота, чтобы он сам ответил в контексте текущего обсуждения». Telegram прямо разделяет эти сценарии: inline mode хорош для поиска, быстрых утилит и вложений, а Guest Mode — для ассистентов, переводчиков, факт-чекеров и временных инструментов, которым нужен контекст сообщения.

Практическая разница:

Сценарий	Inline Mode	Guest Mode
Кто отправляет итоговое сообщение	Пользователь	Бот
Нужен ли бот в чате	Нет	Нет
Получает ли бот контекст сообщения	Ограниченно, через inline query	Да, через dedicated guest update
Подходит для AI-ответа в обсуждении	Частично	Да
Получает ли историю чата	Нет	Нет

Guest Mode особенно полезен там, где постоянное присутствие бота выглядит избыточным: например, команда обсуждает контракт и один раз вызывает бота для краткого резюме; студент зовёт переводчика в диалог; модератор просит ассистента проверить спорный фрагмент; разработчик вызывает agent-бота для анализа лога.

Минимальная схема обработки Guest Mode

Ниже — не SDK-код, а API-схема уровня HTTP/JSON, основанная на официальных полях и методах Bot API 10.0.

Пользователь в чате:
  "@my_helper_bot объясни это сообщение"

Telegram:
  отправляет боту Update.guest_message

Бэкенд бота:
  1. Проверяет наличие message.guest_query_id
  2. Анализирует текст и доступный контекст
  3. Формирует InlineQueryResult
  4. Вызывает answerGuestQuery

Telegram:
  публикует один ответ бота в исходный чат

Минимальная форма запроса к Bot API выглядит так:

POST https://api.telegram.org/bot<TOKEN>/answerGuestQuery
Content-Type: application/json

{
  "guest_query_id": "<guest_query_id from Message>",
  "result": {
    "type": "article",
    "id": "answer-1",
    "title": "Ответ",
    "input_message_content": {
      "message_text": "Краткий ответ по контексту вызова."
    }
  }
}

Документация Telegram фиксирует общий формат вызова методов через https://api.telegram.org/bot<TOKEN>/METHOD_NAME, поддержку JSON и структуру ответа с полем ok; сам метод answerGuestQuery принимает guest_query_id и result.

Bot-to-bot коммуникация: Telegram готовится к агентным цепочкам

В Bot API 10.0 Telegram расширил сценарии взаимодействия ботов друг с другом. В changelog указано, что появилась возможность отправлять сообщения другим ботам по username, если оба бота включили bot-to-bot communication, а также отвечать другим ботам от имени business bot при включённой соответствующей возможности.

Официальная страница возможностей Telegram уточняет несколько режимов:

в группах бот может взаимодействовать с другим ботом через команду с упоминанием или ответ на сообщение;
при включённом Bot-to-Bot Communication Mode бот может получать сообщения других ботов в группе при соблюдении условий администрирования или privacy mode;
в приватном режиме бот может отправлять сообщения другому боту по @username, если режим включён у отправителя и получателя;
через бизнес-аккаунты бот может использовать другого бота как инструмент внутри бизнес-процесса.

Это направление явно рассчитано на multi-agent архитектуры. Например:

@SupportBot получает обращение клиента
        ↓
@ClassifierBot определяет категорию
        ↓
@DocsBot ищет релевантную инструкцию
        ↓
@SupportBot формирует ответ оператору или клиенту

Но здесь появляется новая инженерная проблема: циклы. Telegram отдельно подчёркивает необходимость защиты от бесконечного обмена сообщениями между ботами: дедупликация, rate limit, ограничение глубины взаимодействия и таймауты.

Практическое правило: если вы включаете bot-to-bot communication, сразу проектируйте протокол завершения диалога. У каждого межботового запроса должен быть correlation id, лимит шагов и явное состояние done, failed или timeout.

Опросы: Bot API 10.0 превращает polls в медиаформат

Опросы в Bot API 10.0 получили одно из самых крупных расширений. Telegram добавил медиа в сам опрос, медиа в объяснение quiz-опроса, медиа в варианты ответа, новые input-типы для отправки медиа в опросах, ограничения members_only и country_codes, а также снизил минимальное число вариантов ответа с двух до одного.

Что это меняет практически:

Возможность	Где пригодится
Медиа в опросе	Образовательные тесты, UX-исследования, голосования по изображениям
Медиа в вариантах ответа	Выбор дизайна, товара, кандидата, визуального варианта
`members_only`	Закрытые клубы, корпоративные группы, локальные сообщества
`country_codes`	Региональные кампании, локальные голосования, compliance-сценарии
Один вариант ответа	Подтверждения, реакции, «я участвую», waiting list

Особенно заметен переход от текстового опроса к контентному объекту. Раньше опрос часто был простой формой выбора; теперь он может быть визуальным интерфейсом внутри чата.

Live Photos: новый медиаформат для ботов

В Bot API 10.0 появился тип LivePhoto, InputMediaLivePhoto, поле live_photo у Message и ExternalReplyInfo, метод sendLivePhoto, а также платные варианты PaidMediaLivePhoto и InputPaidMediaLivePhoto. Telegram также разрешил использовать live photos в sendMediaGroup и editMessageMedia.

Метод sendLivePhoto принимает статическое фото и короткое видео. В документации указано ограничение: видео для live photo должно быть не длиннее 10 секунд и не больше 10 МБ; отправка Live Photo по URL на момент документации не поддерживается — нужно использовать file_id или multipart upload.

Где это полезно:

витрины товаров и маркетплейсы;
travel-боты и event-боты;
платный визуальный контент;
AI-генерация коротких визуальных превью;
медиаотчёты в каналах и бизнес-чатах.

Live Photos особенно хорошо сочетаются с Telegram Stars и paid media: бот может продавать не только фото или видео, а более «живой» формат контента.

Управление чатами и реакциями: больше инструментов для модерации

В части Chat Management Telegram добавил поле can_react_to_messages в ChatMemberRestricted и ChatPermissions, параметр return_bots в getChatAdministrators, методы deleteAllMessageReactions и deleteMessageReaction, а также возможность видеть некоторые сообщения, отправленные другими ботами в группах.

Метод deleteAllMessageReactions позволяет удалить до 10 000 недавних реакций в группе или супергруппе, добавленных конкретным пользователем или чатом; для этого боту требуется право администратора can_delete_messages.

Это полезно для:

борьбы с reaction spam;
удаления координированных накруток;
модерации публичных групп;
очистки реакций от подозрительных аккаунтов;
корпоративных чатов, где реакции используются как часть рабочего процесса.

Важно не воспринимать новые методы как «косметику». Реакции давно стали сигналом вовлечённости и инструментом давления в публичных чатах. Возможность централизованно чистить реакционные всплески — это уже часть антиспам-инфраструктуры.

Managed Bots и BotAccessSettings: шаг к ботам как SaaS-инфраструктуре

Bot API 9.6 уже добавил managed bots: боты-менеджеры могут помогать пользователям создавать и контролировать другие боты. Bot API 10.0 расширил эту линию через BotAccessSettings, getManagedBotAccessSettings и setManagedBotAccessSettings.

BotAccessSettings описывает, ограничен ли доступ к управляемому боту, и содержит список дополнительных пользователей, которым доступ разрешён. Метод setManagedBotAccessSettings позволяет включить режим ограниченного доступа и указать до 10 дополнительных пользователей, кроме владельца.

Практическая модель:

SaaS-платформа
  └── Manager Bot
        ├── Bot клиента A
        ├── Bot клиента B
        └── Bot клиента C

Для разработчиков это означает, что Telegram постепенно делает Bot API не только интерфейсом для отдельных ботов, но и инфраструктурой для платформ, где один сервис управляет множеством пользовательских ботов.

Business Bots: меньше барьеров для бизнес-автоматизации

В Bot API 10.0 Telegram указал, что Business Bots теперь могут управлять пользовательскими аккаунтами без Telegram Premium subscription. Также расширены сценарии взаимодействия бизнес-ботов с другими ботами при включённой bot-to-bot communication.

На практике это снижает порог входа для CRM-ботов, support-ботов, агентных помощников и вертикальных SaaS-решений. Если раньше часть сценариев могла упираться в Premium-зависимость, то теперь бизнес-автоматизация становится более доступной.

Однако бизнес-боты остаются зоной повышенной ответственности. Официальная документация Telegram напоминает, что владелец аккаунта определяет доступные чаты, а бот в разрешённых чатах может получать поддерживаемые обновления и, в зависимости от настроек, отправлять сообщения или выполнять действия от имени владельца в активных чатах.

Что проверить перед миграцией на Bot API 10.0

1. Обновления и allowed_updates

Если вы используете webhook или long polling с явным списком allowed_updates, проверьте, добавлен ли новый тип guest_message. Иначе бот может поддерживать Guest Mode в настройках, но не получать нужные события.

Минимальный чек:

allowed_updates:
  - message
  - edited_message
  - callback_query
  - guest_message

Если вы намеренно фильтруете обновления, новая функциональность почти всегда требует пересмотра фильтра.

2. Проверка supports_guest_queries

После включения Guest Mode в BotFather стоит вызвать getMe и проверить поле supports_guest_queries. Оно возвращается только в getMe и показывает, поддерживает ли бот guest queries.

3. Логика ответа на guest-запросы

Guest Mode — это не обычное сообщение в чате. Нельзя проектировать его как бесконечный диалог. У вас есть вызов, ограниченный контекст и один ответ через answerGuestQuery.

Рекомендуемая логика:

if update.guest_message exists:
    extract guest_query_id
    extract caller user/chat
    build one-shot response
    answerGuestQuery(...)

Не стоит пытаться хранить состояние guest-чата так, будто бот является его участником. Документация прямо указывает, что guest bot не получает историю, список участников и будущие сообщения без повторного вызова.

4. Защита bot-to-bot сценариев

Для inter-bot взаимодействий нужны технические предохранители:

Риск	Что сделать
Бесконечный цикл ответов	Максимальная глубина цепочки
Дубли сообщений	Idempotency key / correlation id
Шторм запросов	Rate limit на пару bot→bot
Непредсказуемый внешний бот	Таймаут и circuit breaker
Потеря контекста	Явный trace id в payload

Telegram отдельно предупреждает, что бот должен оставаться стабильным даже если другой бот отвечает мгновенно и непрерывно.

5. Совместимость SDK

Bot API обычно обновляется быстрее, чем клиентские библиотеки. Если вы используете aiogram, python-telegram-bot, grammY, Telegraf, Telegram.Bot для .NET или другой SDK, проверьте поддержку именно Bot API 10.0 в релизах библиотеки. До обновления SDK можно вызывать новые методы напрямую через HTTP, но типизация новых объектов, обработчики обновлений и сериализация InlineQueryResult могут ещё не быть готовы.

Локальный Bot API Server: когда он нужен после 10.0

Официальный сервер Telegram Bot API доступен в репозитории tdlib/telegram-bot-api. Telegram указывает, что локальный сервер позволяет скачивать файлы без лимита размера, загружать файлы до 2000 МБ, использовать локальные пути файлов, HTTP URL для webhook, любые локальные IP и порты, а также повышать max_webhook_connections до 100000.

Для большинства ботов облачного https://api.telegram.org достаточно. Но после Bot API 10.0 локальный сервер может стать полезнее в трёх случаях:

Медиа-heavy боты — Live Photos, paid media, большие файлы, генерация контента.
Высокая нагрузка — крупные группы, агентные цепочки, интенсивные webhook-потоки.
Инфраструктурный контроль — необходимость локального хранения файловых путей, кастомной сетевой схемы или приватного webhook-контура.

При этом локальный сервер требует дисциплины: нужно корректно вызывать logOut перед переносом бота с облачного Bot API, иначе нет гарантии получения всех обновлений. Это прямо указано в README официального репозитория.

Архитектурные сценарии, которые открывает Bot API 10.0

AI-ассистент по вызову

Пользователь упоминает бота в группе:

@LegalHelperBot проверь, нет ли риска в этом пункте договора

Бот получает guest update, анализирует сообщение и возвращает один ответ. Он не остаётся в группе, не читает дальнейшую переписку и не требует добавления в список участников.

Командная цепочка ботов

Один бот принимает задачу, второй классифицирует, третий ищет данные, четвёртый формирует ответ. Это удобно для агентных систем, где каждый бот специализируется на отдельной функции.

Router Bot → Search Bot → Summarizer Bot → Support Bot

Визуальные опросы

Бренд запускает голосование по дизайну упаковки: каждый вариант ответа содержит изображение, а голосовать могут только участники сообщества или пользователи из заданных стран.

SaaS для персональных ботов

Платформа создаёт пользователю управляемого бота, ограничивает доступ через BotAccessSettings, получает токен managed bot и разворачивает персональный AI-agent или support-agent.

Медиабот с Live Photos

Бот создаёт короткие live-превью для событий, недвижимости, товаров или travel-маршрутов и отправляет их как обычный или платный контент.

Что изменится для разработчиков в повседневной работе

Bot API 10.0 заставляет пересмотреть несколько привычек.

Во-первых, обработчики обновлений должны стать более гибкими. Update уже давно перестал быть просто message или callback_query; теперь важно аккуратно обрабатывать business_message, managed_bot, guest_message и другие специализированные ветки.

Во-вторых, боты всё чаще работают в режимах с разным уровнем доступа: обычный чат, бизнес-чат, guest-вызов, managed bot, bot-to-bot. Нельзя использовать одну модель авторизации и контекста для всех случаев.

В-третьих, Telegram постепенно переносит сложность из интерфейса пользователя в backend разработчика. Пользователь просто зовёт бота или нажимает кнопку, а разработчик должен правильно маршрутизировать контекст, не нарушить приватность, не создать цикл и не превысить лимиты.

Практический чек-лист внедрения Bot API 10.0

Перед включением новых возможностей пройдите короткий список:

□ Проверить официальную документацию Bot API 10.0 и список новых методов.
□ Обновить SDK или подготовить прямые HTTP-вызовы для новых методов.
□ Добавить guest_message в allowed_updates, если используется фильтрация.
□ Включить Guest Mode в BotFather Mini App, если нужен гостевой сценарий.
□ Проверить supports_guest_queries через getMe.
□ Реализовать обработчик Message.guest_query_id.
□ Отвечать на guest-вызовы через answerGuestQuery, а не через обычный sendMessage.
□ Для bot-to-bot коммуникации включить режим у нужных ботов.
□ Добавить дедупликацию, rate limit и максимальную глубину agent-chain.
□ Проверить права администратора для удаления реакций.
□ Пересмотреть модели данных для опросов с медиа.
□ Учесть ограничения sendLivePhoto: видео до 10 секунд и до 10 МБ.
□ Для managed bots внедрить политику доступа через BotAccessSettings.
□ Обновить мониторинг webhook-ошибок и логирование новых типов обновлений.

Вывод: Bot API 10.0 — это фундамент для временных, агентных и более приватных ботов

Telegram Bot API 10.0 делает платформу заметно ближе к современным агентным интерфейсам. Главное новшество — Guest Mode — меняет саму механику присутствия бота: теперь его можно вызвать как инструмент, не добавляя в чат и не раскрывая ему лишний контекст.

Второй важный вектор — bot-to-bot communication. Telegram явно готовит почву для цепочек специализированных ботов, но одновременно требует от разработчиков инженерной зрелости: защиты от циклов, лимитов, дедупликации и устойчивости.

Третий слой — расширение медиа и управления: Live Photos, медиаопросы, реакционная модерация, managed bots и настройки доступа. Всё это делает Bot API не просто интерфейсом для чат-ботов, а полноценной инфраструктурой для продуктов, ассистентов, бизнес-автоматизации и AI-сценариев внутри Telegram.