Что случилось
9 ноября 2026 года Telegram выпустил Bot API 10.4. Главное нововведение — HTML-виджеты: бот отправляет в сообщение один самодостаточный HTML-документ, а клиент рисует его прямо в пузыре. Внутри могут быть кнопки, таблицы, canvas, анимация и JavaScript. На следующий день Павел Дуров написал, что любое сообщение теперь может стать приложением.
Формулировка красивая, но точнее так: сообщение может стать небольшим интерфейсом без сети, клавиатуры и прокрутки. В анонсе Telegram показывает карточку заказа, статус доставки, крестики-нолики, курс биткоина, промокод и игру на canvas. Всё это — не картинки и не Mini Apps, а HTML, который живёт внутри переписки.
Почему это заметно. Интерфейс не нужно открывать в WebView и загружать с сервера. Он выглядит как часть чата и подстраивается под тему. Состояние можно менять без нового сообщения. Оплата TON запускается прямо из сообщения. Для ботов это заметный способ показать что-то сложнее текста и кнопок, не уводя пользователя на сайт.
Но у новости есть вторая половина. В продакшене виджеты пока работают только в личном чате с ботом. Группы, инлайн-режим и пересылка — на тестовом сервере. Это не «Telegram заменил приложения», а новый формат сообщения с очень жёсткими рамками. Ниже — что именно подтверждает документация, а что остаётся обещанием.
Что такое HTML-виджет
Виджет — это один HTML-документ. Внутри — разметка, инлайн-CSS и JavaScript; картинки только как data: URL или inline SVG. Внешние шрифты, скрипты и изображения не загружаются. Клиент не запускает WebView и не даёт странице сходить в сеть: JavaScript исполняется в QuickJS, изменения DOM проверяются по профилю виджета и рисуются нативно. Поэтому один и тот же виджет должен выглядеть одинаково на iOS, Android, macOS, Telegram Desktop и в вебе.
Ключевое отличие от Mini App — не размер, а среда. Mini App — это веб-страница, которую открывают по кнопке: у неё есть сеть, свой бэкенд, клавиатура и полноэкранный ввод. Виджет — часть сообщения: он всегда на виду, пока вы листаете чат, но не может загрузить данные сам и не принимает текст. Всё, что виджету нужно, он получает от бота.
Виджет и Mini App: что общего и в чём разница
| Критерий | HTML-виджет | Mini App |
|---|---|---|
| Где живёт | Внутри пузыря сообщения | В WebView, открывается по кнопке |
| Код | До 32 КБ HTML, фиксируется при отправке | Страница на вашем сервере, обновляется как угодно |
| Сеть | Нет: fetch, WebSocket и XHR запрещены | Есть, как у обычной веб-страницы |
| Ввод | Только тапы и жесты; клавиатуры нет | Клавиатура, формы, камера, файлы |
| Связь с ботом | Запрос до 64 байт, ответ до 1 КБ | Свой бэкенд и подписанный initData |
| Состояние | Пишет только бот, до 1 КБ | Ваш бэкенд, CloudStorage, DeviceStorage |
Где живёт
- HTML-виджет
- Внутри пузыря сообщения
- Mini App
- В WebView, открывается по кнопке
Код
- HTML-виджет
- До 32 КБ HTML, фиксируется при отправке
- Mini App
- Страница на вашем сервере, обновляется как угодно
Сеть
- HTML-виджет
- Нет: fetch, WebSocket и XHR запрещены
- Mini App
- Есть, как у обычной веб-страницы
Ввод
- HTML-виджет
- Только тапы и жесты; клавиатуры нет
- Mini App
- Клавиатура, формы, камера, файлы
Связь с ботом
- HTML-виджет
- Запрос до 64 байт, ответ до 1 КБ
- Mini App
- Свой бэкенд и подписанный initData
Состояние
- HTML-виджет
- Пишет только бот, до 1 КБ
- Mini App
- Ваш бэкенд, CloudStorage, DeviceStorage
Виджет не заменяет Mini App там, где нужны ввод, сеть или длинный контент. Это разные инструменты для разных задач.
Код виджета задаётся при отправке и не меняется. Нельзя «обновить приложение» в старом сообщении: для нового макета нужно отправить новый виджет, а старые сообщения останутся со старой версией. Меняется только состояние — два текстовых поля до 1 024 байт: chat_data для конкретного сообщения и public_data для shared-виджета, который показывают несколько сообщений.
Состояние пишет только бот: при отправке и позже методами editMessageWidgetData и editSharedWidgetData. Виджет читает его через TelegramWidget.chatData и TelegramWidget.publicData и перерисовывается по событиям chatDataChanged и publicDataChanged. Сам виджет состояние изменить не может — только попросить бота.

Код и состояние: как виджет разговаривает с ботом
У виджета есть только один выход наружу — запрос к боту. Он отправляется через TelegramWidget.request(data), где data — строка от 1 до 64 байт. Запрос приходит боту как update widget_query (или shared_widget_query для пересланного shared-виджета), а бот отвечает answerWidgetQuery с data до 1 024 байт. Ответ получает только тот виджет, который спросил.
- 1Пользователь нажимает кнопку внутри виджета.
- 2Виджет вызывает request('vote:2') — короткий код действия.
- 3Бот получает widget_query с from, data и координатами сообщения.
- 4Бот проверяет данные, меняет состояние и отвечает answerWidgetQuery.
- 5Виджет получает ответ и/или событие chatDataChanged с новым состоянием.
Схема похожа на callback-кнопки, но с двумя важными отличиями. Во-первых, запрос несёт контекст сообщения и пользователя, а не только строку. Во-вторых, ответ приходит не в чат, а внутрь виджета — его видит только тот, кто нажал. Это позволяет делать локальные подсказки, ошибки и подтверждения, не засоряя переписку.
Дисциплина запросов описана жёстко. Один запрос в полёте: второй вернёт BUSY. Ответ — за 15 секунд, иначе TIMEOUT. Не больше 5 запросов за 5 секунд на пару «пользователь + бот». Фоновые запросы разрешены только в личном чате и только пока виджет виден на экране: один при появлении, затем не чаще раза в 5 секунд. Данные запроса — недоверенный ввод, как callback_data: проверяйте их по состоянию, которое храните у себя.
Фоновые запросы — механизм для тикеров и статусов. Виджет сам обновляет курс, пока чат открыт, а бот ходит за данными на биржу или в свою базу. Когда сообщение уходит за экран, виджет ставится на паузу, таймеры замедляются, анимация останавливается. Это честное поведение: никто не тратит батарею на виджет, которого не видно.
Есть и shared-виджеты — один объект на сервере, как опрос, который показывают много сообщений. У него общее public_data: изменение виджет получает через watchPublicData() с периодом обновления от 5 до 3 600 секунд. Это удобно для опросов, счётчиков и курсов, но в продакшене пересылка shared-виджетов пока недоступна — только тестовый сервер.
Что можно и нельзя внутри песочницы
Профиль виджета — это контракт между HTML и клиентами Telegram. Всё, что в него не входит, клиент молча удаляет: селектор, элемент или событие исчезают, а остальная страница продолжает работать. Поэтому «у меня в браузере выглядит нормально» ничего не доказывает: браузер рисует то, что Telegram вырежет.
Профиль виджета: что работает и что вырезано
| Область | Работает | Вырезано или запрещено |
|---|---|---|
| HTML | Текст, заголовки, списки, таблицы, details, button, canvas, img с data: | input, textarea, select, form-контролы, iframe, video, audio, внешние скрипты |
| CSS | Flex, grid, позиционирование, градиенты, тени, анимации, media queries по ширине и теме | vh и другие высотные единицы, overflow: auto, position: sticky, 3D-трансформы, часть фильтров |
| JavaScript | ES2023, DOM, canvas 2D, localStorage, Intl, crypto, таймеры, requestAnimationFrame | fetch, XHR, WebSocket, Worker, навигация, alert/confirm/prompt, WebGL |
| Ввод | Клики, pointer-события, горизонтальные жесты, удержание | Клавиатура, фокус, колесо, вертикальные жесты: они всегда листают чат |
| Внешние ресурсы | Картинки как data: URL, inline SVG, системные шрифты | Шрифты, стили, скрипты и изображения по URL; @font-face |
HTML
- Работает
- Текст, заголовки, списки, таблицы, details, button, canvas, img с data:
- Вырезано или запрещено
- input, textarea, select, form-контролы, iframe, video, audio, внешние скрипты
CSS
- Работает
- Flex, grid, позиционирование, градиенты, тени, анимации, media queries по ширине и теме
- Вырезано или запрещено
- vh и другие высотные единицы, overflow: auto, position: sticky, 3D-трансформы, часть фильтров
JavaScript
- Работает
- ES2023, DOM, canvas 2D, localStorage, Intl, crypto, таймеры, requestAnimationFrame
- Вырезано или запрещено
- fetch, XHR, WebSocket, Worker, навигация, alert/confirm/prompt, WebGL
Ввод
- Работает
- Клики, pointer-события, горизонтальные жесты, удержание
- Вырезано или запрещено
- Клавиатура, фокус, колесо, вертикальные жесты: они всегда листают чат
Внешние ресурсы
- Работает
- Картинки как data: URL, inline SVG, системные шрифты
- Вырезано или запрещено
- Шрифты, стили, скрипты и изображения по URL; @font-face
Отдельно про ввод. Внутри виджета нет ни одного поля ввода: input, select и textarea удаляются вместе с содержимым. Клавиатура не открывается, фокус не работает, а нажатие клавиши не считается тапом. Всё, что пользователь может сделать, — нажать, удержать, провести пальцем по горизонтали. Вертикальный жест всегда принадлежит чату: виджет не может сделать вертикальный слайдер, колесо выбора или карту.
Прокрутки внутри виджета тоже нет. overflow: auto и scroll превращаются в hidden, position: sticky становится relative. Высота пузыря — от 50 до 600 px, всё, что ниже, обрезается. Длинный контент придётся разбивать на страницы, табы или «показать ещё» — и проверять на узком экране, где 600 px — это не так уж много.
Зато внутри песочницы есть полезное. Canvas 2D с анимацией — для игр и графиков. localStorage и sessionStorage — по 4 КБ на область на сообщение, чтобы запомнить рекорд или факт копирования. HapticFeedback — вибрация на поддерживаемых устройствах. copyText — копирование промокода в один тап. openLink и openTelegramLink — аккуратный выход на сайт или в бота. Плюс themeParams и CSS-переменные, чтобы попасть в палитру конкретного чата.
Лимиты, которые определяют дизайн
Ограничения виджета — не мелкие технические детали, а главный дизайнерский фактор. Ниже — ключевые цифры из документации. Их стоит держать перед глазами до того, как рисовать макет.
Ключевые лимиты HTML-виджета
| Параметр | Лимит | Что это значит на практике |
|---|---|---|
| HTML | 32 768 байт UTF-8 | Много для текста, мало для тяжёлой разметки и data:-картинок |
| Сжатый HTML | 4 096 байт после zlib level 9 | Главный лимит: повторяющийся CSS сжимается, уникальный текст и картинки — нет |
| Высота пузыря | 50–600 px | Нет скролла и фуллскрина; длинный контент — на страницы и табы |
| chat_data / public_data | 1 024 байта каждый | Хватает на JSON небольшой игры или карточки, не на историю |
| Запрос к боту | 1–64 байта | Короткий код действия, а не полезная нагрузка |
| Ответ бота | 1 024 байта; ответ за 15 секунд | Успевайте ответить; тяжёлую работу делайте после ответа |
| Запросы | 5 за 5 секунд на пару «пользователь + бот» | Фоновое обновление — раз в 5 секунд, не чаще |
| localStorage / sessionStorage | 4 КБ на область на сообщение | Храните только мелочи: рекорд, флаг, идентификатор |
HTML
- Лимит
- 32 768 байт UTF-8
- Что это значит на практике
- Много для текста, мало для тяжёлой разметки и data:-картинок
Сжатый HTML
- Лимит
- 4 096 байт после zlib level 9
- Что это значит на практике
- Главный лимит: повторяющийся CSS сжимается, уникальный текст и картинки — нет
Высота пузыря
- Лимит
- 50–600 px
- Что это значит на практике
- Нет скролла и фуллскрина; длинный контент — на страницы и табы
chat_data / public_data
- Лимит
- 1 024 байта каждый
- Что это значит на практике
- Хватает на JSON небольшой игры или карточки, не на историю
Запрос к боту
- Лимит
- 1–64 байта
- Что это значит на практике
- Короткий код действия, а не полезная нагрузка
Ответ бота
- Лимит
- 1 024 байта; ответ за 15 секунд
- Что это значит на практике
- Успевайте ответить; тяжёлую работу делайте после ответа
Запросы
- Лимит
- 5 за 5 секунд на пару «пользователь + бот»
- Что это значит на практике
- Фоновое обновление — раз в 5 секунд, не чаще
localStorage / sessionStorage
- Лимит
- 4 КБ на область на сообщение
- Что это значит на практике
- Храните только мелочи: рекорд, флаг, идентификатор
Есть и ресурсные лимиты: 300 мс JavaScript в секунду, 500 мс на одну задачу, 8 МБ памяти, 2 000 узлов DOM. Превышение останавливает виджет, а не просто замедляет.
Сжатие — самая недооценённая часть. 4 КБ — это не «мало места», а дисциплина: повторы и компактный CSS жмутся хорошо, а data:-картинки и длинные уникальные строки — почти нет. Проверять размер нужно ровно так, как это делает сервер: Python-функцией zlib.compress(html, 9). Node.js и gzip -9 дают немного другой результат, и на границе 4 096 байт это может стоить отправки.
Высота 600 px и отсутствие скролла ломают привычный веб-дизайн. Нельзя сделать длинную форму, ленту комментариев или таблицу на сто строк. Зато можно сделать компактную карточку, которая решает одну задачу: показать статус, принять голос, скопировать код, запустить короткую игру. Чем уже сценарий, тем лучше виджет помещается в рамки.
Оплата и подпись через TON
Одна из самых практичных возможностей — встроенный кошелёк. Виджет может попросить пользователя отправить транзакцию или подписать данные, используя форматы TON Connect. Выглядит это так: пользователь нажимает «Оплатить», виджет просит бота подготовить транзакцию, бот отвечает готовым запросом, а клиент показывает окно кошелька с суммой и адресом. Подтверждение происходит вне пузыря, в системном окне — виджет не получает доступ к ключам.
- 1Проверить, что TelegramWidget.wallet не null: кошелёк есть не у всех и не во всех странах.
- 2По тапу вызвать request('pay:42', { wallet: true }) — бот получит карточку кошелька пользователя.
- 3Бот отвечает свежей транзакцией TON Connect: адреса, суммы в нанотонах, payload.
- 4Виджет вызывает wallet.sendTransaction(transaction, 'paid:42'); пользователь подтверждает в окне кошелька.
- 5Бот получает sent_transaction с msg_hash и проверяет транзакцию в сети, а не только по хешу.
Для подписи есть signData: текст, бинарные данные или ячейка TON. Подписанный результат приходит боту вместе с public_key кошелька, который подписал. Домен, для которого подписывают, — bot<bot_id>: это привязывает подпись к конкретному боту и защищает от повторного использования в другом месте.
Для электронной коммерции это важный сдвиг. Карточка товара, промокод, подписка и оплата могут жить в одном сообщении, без перехода на сайт и без отдельного Mini App. Но платёж не становится «магическим»: бот всё равно готовит транзакцию, хранит заказ и проверяет результат в блокчейне. Виджет — только лицо, бэкенд — по-прежнему бот.
Где виджеты работают сейчас
Это самый важный раздел для планирования. Официальная таблица доступности выглядит так: в продакшене виджеты работают только в личном чате с ботом. Группы, инлайн-режим и пересылка включены на тестовом сервере, где любой бот может проверить полный набор. Каналы не поддерживают виджеты ни там, ни там.
Доступность виджетов в ноябре 2026 года
| Где | Продакшен | Тестовый сервер |
|---|---|---|
| Личный чат с ботом | Да, с запросами и кошельком | Да |
| Группа или супергруппа | Нет | Да |
| Инлайн-режим | Нет | Да |
| Пересылка виджета | Нет | Да |
| Канал: отправить новый виджет | Нет | Нет |
Личный чат с ботом
- Продакшен
- Да, с запросами и кошельком
- Тестовый сервер
- Да
Группа или супергруппа
- Продакшен
- Нет
- Тестовый сервер
- Да
Инлайн-режим
- Продакшен
- Нет
- Тестовый сервер
- Да
Пересылка виджета
- Продакшен
- Нет
- Тестовый сервер
- Да
Канал: отправить новый виджет
- Продакшен
- Нет
- Тестовый сервер
- Нет
В тестовом сервере пересланный виджет может оказаться и в канале; отправить туда новый виджет нельзя.
В продакшене сообщения с виджетами получают protected content: пользователь не может их переслать, а методы copyMessage и copyMessages их не копируют. Это прямо противоречит идее «вирусных» виджетов, которую подчёркивают некоторые обзоры. Сейчас виджет — это личный, не пересылаемый интерфейс в конкретном чате. Для бизнеса это скорее плюс: меньше утечек и меньше копирования промокодов, но и меньше органического распространения.
Telegram называет раскатку поэтапной. Документация обещает одинаковый вид на iOS, Android, macOS, Telegram Desktop и в вебе, но доступность зависит от версии приложения. На момент записи ролика автор не смог открыть виджеты в десктопном клиенте. Мы не проверяли все клиенты и не выдаём документацию за результат: перед запуском проверяйте свою аудиторию и конкретные версии приложений.
Что на этом строить
Виджет хорошо работает там, где нужно показать небольшую меняющуюся карточку и получить одно действие. Пять сценариев, которые документация и демо подтверждают лучше всего.
Сценарии для HTML-виджетов
| Сценарий | Что заменяет | Сильная сторона | Ограничение |
|---|---|---|---|
| Карточка заказа | Письмо со ссылкой или PDF | Статус и кнопка «Открыть» в одном сообщении | Состояние до 1 КБ, без истории |
| Тикер или курс | Скриншот или ссылку на график | Обновление раз в 5 секунд, пока чат открыт | Только пока виден; фон — лишь в личном чате |
| Промокод | Картинку с кодом | Копирование в один тап и вибрация | Нет ввода, 4 КБ на всю разметку |
| Игра или опрос | Mini App или внешний сайт | Запускается мгновенно, без установки | 600 px, нет клавиатуры, вертикальные жесты всегда у чата |
| Оплата | Ссылку на сайт или Mini App | TON-кошелёк прямо в сообщении | Бот готовит транзакцию и проверяет её в сети |
Карточка заказа
- Что заменяет
- Письмо со ссылкой или PDF
- Сильная сторона
- Статус и кнопка «Открыть» в одном сообщении
- Ограничение
- Состояние до 1 КБ, без истории
Тикер или курс
- Что заменяет
- Скриншот или ссылку на график
- Сильная сторона
- Обновление раз в 5 секунд, пока чат открыт
- Ограничение
- Только пока виден; фон — лишь в личном чате
Промокод
- Что заменяет
- Картинку с кодом
- Сильная сторона
- Копирование в один тап и вибрация
- Ограничение
- Нет ввода, 4 КБ на всю разметку
Игра или опрос
- Что заменяет
- Mini App или внешний сайт
- Сильная сторона
- Запускается мгновенно, без установки
- Ограничение
- 600 px, нет клавиатуры, вертикальные жесты всегда у чата
Оплата
- Что заменяет
- Ссылку на сайт или Mini App
- Сильная сторона
- TON-кошелёк прямо в сообщении
- Ограничение
- Бот готовит транзакцию и проверяет её в сети
За пределами таблицы остаются уведомления из админки, остатки на складе, очередь, счёт матча, открытки и небольшие калькуляторы. Общий признак: данных немного, обновление частое, действие одно. Если нужен ввод текста, загрузка файла, прокрутка или сеть — виджет не подходит, и это не лечится уменьшением шрифта.
Как собрать первый виджет
Порядок действий простой, но с двумя ловушками: размер после сжатия и отсутствие сети. Если помнить о них, первый виджет можно собрать за вечер.
- 1Прочитайте core.telegram.org/bots/widgets — там профиль, лимиты и примеры, а не только описание методов.
- 2Сверстайте один HTML-файл с инлайн-CSS и JavaScript. Уберите input, внешние ссылки на шрифты и картинки, vh и overflow: auto.
- 3Посчитайте сжатие ровно как сервер — командой ниже. Цель — меньше 4 096 байт, с запасом.
- 4Отправьте виджет методом sendWidget с chat_id, html и allow_queries, если виджету нужно общаться с ботом.
- 5Обрабатывайте widget_query: проверяйте from и data, отвечайте answerWidgetQuery за 15 секунд.
- 6Меняйте состояние через editMessageWidgetData; авторитетное состояние храните у себя, а не в виджете.
- 7Проверьте обе темы, узкий экран, старый телефон и сценарий без кошелька.
python3 -c 'import sys,zlib; print(len(zlib.compress(sys.stdin.buffer.read(), 9)))' < widget.html
В документации есть готовый системный промпт для LLM: длинный блок правил песочницы, который можно вставить в модель. Автор ролика им не пользовался — просто дал агенту ссылку на документацию, и тот собрал демо-стенд. Мы не проверяли, насколько промпт улучшает результат, но сама идея логична: модели обычно ошибаются именно на вырезанных возможностях, а не на синтаксисе HTML.
Для отладки полезно помнить: вне Telegram window.TelegramWidget равен undefined, а браузер рисует то, что клиент вырежет. Поэтому быстрый просмотр в браузере — только первый шаг. Финальная проверка — в реальном клиенте, в личном чате с ботом, на телефоне.
Риски и трезвая оценка
Главный риск — принять демонстрацию за продукт. Красивые примеры из анонса работают в узком сценарии и на тестовом стенде. В продакшене другой набор прав, другая аудитория и другие ограничения. Ниже — то, что стоит проверить до запуска.
Безопасность
Данные из виджета — недоверенный ввод, как callback_data. Проверяйте их по состоянию, которое храните на боте, не доверяйте client-side проверкам и не выполняйте по data платёж без проверки заказа. from и widget_id подделать нельзя, но всё остальное — можно. Для платежей проверяйте транзакцию в сети: отправителя, получателей, суммы и результат.
Продукт
Виджет нельзя обновить в старом сообщении: новый макет — новое сообщение. Нельзя переслать, нельзя открыть в группе, нельзя дать пользователю ввод. Если сценарий требует хотя бы одного из этого, виджет будет обузой. И наоборот: для статуса, тикера и промокода ограничения почти не мешают.
Дизайн
Палитра принадлежит чату, а не вам. Жёстко заданные цвета могут не контрастировать с пузырём в тёмной теме. Пользуйтесь --tg-theme-* и проверяйте обе схемы. Помните, что время сообщения рисуется в нижнем углу: нижнюю полосу нужно держать свободной, иначе текст или кнопка окажутся под часами.
Что дальше
Telegram обещает расширять доступность: группы, инлайн и пересылки уже работают на тестовом сервере. Если их включат в продакшене, сценариев станет заметно больше — от опросов в чатах до вирусных карточек и игр на двоих. Но сроков документация не называет, и выдавать тестовый сервер за готовый продукт нельзя.
Экосистема подтягивается. node-telegram-bot-api 2.4.0 добавил sendWidget и обработку widget_query, у puregram появился плагин @puregram/widgets с примерами опросов и общей логикой состояния. Для ИИ-агентов виджет — удобная поверхность: статус задачи, отчёт, карточка результата в одном сообщении вместо десятка новых. Это, пожалуй, самый интересный сценарий помимо электронной коммерции.
Стоит ли пробовать сейчас. Если у вас есть бот и повторяющийся сценарий — статус заказа, курс, промокод, короткий опрос — да. Если нужен ввод, сеть, длинный контент или пересылка — пока нет. Виджеты не отменяют Mini Apps и не заменяют сайт. Они добавляют ещё один формат: маленький, быстрый и очень ограниченный интерфейс, который живёт там, где пользователь и так проводит время.
Для PullVid это ещё и напоминание: чем ближе интерфейс к человеку, тем важнее дисциплина. Мы делаем инструменты для скачивания видео и медиа — на сайте и в музыкальном разделе, — и виджеты показывают, что даже 4 КБ могут быть полезны, если задача сформулирована точно.
FAQ
Что такое HTML-виджет в Telegram?
Это один HTML-документ с инлайн-CSS и JavaScript, который бот отправляет в сообщение. Клиент рисует его прямо в пузыре, без WebView и без доступа к сети. Код фиксируется при отправке, а состояние может менять только бот.
Сколько весит виджет?
До 32 768 байт HTML и до 4 096 байт после сжатия zlib level 9. Сервер проверяет оба лимита. Картинки можно использовать только как data: URL или inline SVG; внешние шрифты и ресурсы не загружаются.
Это то же самое, что Mini App?
Нет. Mini App — веб-страница, которую открывают по кнопке; у неё есть сеть, клавиатура и свой бэкенд. Виджет живёт внутри сообщения, не имеет сети и ввода, а общается с ботом короткими запросами. Это разные инструменты.
Работают ли виджеты в группах и каналах?
В продакшене в ноябре 2026 года — только в личном чате с ботом. Группы, инлайн-режим и пересылка доступны на тестовом сервере. Каналы не поддерживают виджеты ни там, ни там.
Можно ли переслать виджет?
В продакшене нет: сообщения с виджетами получают protected content, а copyMessage и copyMessages их не копируют. На тестовом сервере пересылка работает, в том числе для shared-виджетов.
Есть ли у виджета доступ в интернет?
Нет. fetch, XMLHttpRequest, WebSocket и другие сетевые API выбрасывают NetworkDisabledError. Внешние скрипты, стили, шрифты и картинки не загружаются. Данные виджет получает только от бота через request или из своего состояния.
Можно ли принимать оплату прямо в виджете?
Да, через встроенный TON-кошелёк: виджет просит бота подготовить транзакцию, пользователь подтверждает её в окне кошелька, а бот проверяет результат в сети. Кошелёк доступен не всем, поэтому нужен обычный сценарий заказа без него.
Как создать свой виджет?
Сверстать один HTML-файл, проверить сжатие до 4 КБ, отправить его методом sendWidget с allow_queries при необходимости, обрабатывать widget_query и отвечать answerWidgetQuery за 15 секунд. Состояние менять через editMessageWidgetData.
Нужен ли отдельный сервер?
Да, если виджету нужно состояние или реакция на действия. Сервером выступает бот: он хранит авторитетное состояние, готовит ответы и проверяет платежи. Сам виджет сети не имеет и самостоятельным приложением не является.
Источники и примечания
Проверено 12 ноября 2026. Ссылки ведут на официальные документы и оригинальные публикации.
- 01Telegram Bot API — changelog, 9 ноября 2026
официальный список изменений Bot API 10.4
- 02Telegram Widgets — руководство
устройство, профиль, лимиты, доступность, TON-кошелёк
- 03Telegram Bot API — sendWidget
параметры отправки виджета
- 04Telegram Bot API — answerWidgetQuery
ответ на запрос виджета
- 05Telegram Bot API — editMessageWidgetData
изменение состояния виджета
- 06Digital Trends — Telegram turns messages into mini-apps
обзор релиза и TON-платежей
- 07Gadgets 360 — Telegram Bot API 10.4
контекст релиза и QuickJS
- 08iPhones.ru — микроприложения в чатах Telegram
русскоязычный обзор анонса
- 09node-telegram-bot-api 2.4.0
поддержка sendWidget и widget_query в библиотеке
- 10puregram — плагин widgets
примеры работы с виджетами и состоянием
PullVid — независимый журнал. Материал основан на официальной документации Telegram и открытых публикациях. Мы не аффилированы с Telegram и не получали доступа к тестовому серверу.
PullVid Journal
Понравилась статья? Поделитесь с друзьями
Отправьте материал друзьям или сохраните ссылку, чтобы вернуться к нему позже.
PullVid
Скачивайте видео из YouTube и социальных сетей через PullVid
Отправьте ссылку на видео в Telegram — PullVid поможет получить доступный для скачивания контент.