Telegram Bot API 10.4: мы сделали виджет заказа и потеряли кнопку «Переслать»
6 минут

Telegram Bot API 10.4: мы сделали виджет заказа и потеряли кнопку «Переслать»

Мы внедрили HTML-виджеты Telegram для заказов и бонусов. Показываем на скринах, как работают статусы, почему нет пересылки и зачем клиенту PDF.

Сергей, основатель TEZAM · 12 ноября 2026

Заказ на 50 рублей. Один зелёный лак. Статус «Выполнен». Допустим, клиент хочет уточнить у поддержки, почему заказ уже закрыт. Самое простое — переслать сообщение. Открываем меню. «Ответить» есть. «Закрепить» есть. «Переслать» — нет.

Вот на этом месте у нас в задаче «сделать красивую карточку заказа» появился генератор PDF.

9 ноября 2026 года вышел Telegram Bot API 10.4. На 12 ноября это последняя версия API. Главное для нас в этом релизе — HTML-виджеты: бот может отправить в чат сообщение со своим интерфейсом. Мы в TEZAM взялись за них, как только получили доступ. У нас каждый бизнес работает со своей CRM и своим Telegram-ботом, так что проверять было на чём: заказы, записи, бонусы. Начали с заказа.

Что даёт HTML-виджет в Telegram

Допустим, вы заказали три лака. Магазин присылает карточку: «Новый», состав заказа и кнопка «Подробнее». Когда сотрудник меняет статус в CRM, бот обновляет ту же карточку. После выполнения в ней уже можно поставить звёзды и повторить заказ. Не приходится искать среди пяти сообщений, какое из них последнее и куда нажимать.

Виджет нового заказа в Telegram: три лака и кнопка «Подробнее»

Тут есть тонкость, которая важнее анимации. Когда бот редактирует виджет, Telegram не присылает уведомление и не поднимает чат. Если клиент сам открыл переписку узнать, как дела, — отлично. Если кофе уже готов и человек должен подойти к стойке, тихо поменять надпись на «Готов» недостаточно. Для такого события нужен отдельный сигнал. Как Telegram обновляет виджеты.

Почему нельзя переслать виджет заказа

В рабочей версии Telegram автоматически защищает сообщения с HTML-виджетами от пересылки. Параметра, который позволил бы магазину снять эту защиту при отправке, в документации нет. Вот что показывает сам клиент Telegram, если открыть меню карточки. Описание sendWidget в Bot API.

Меню Telegram без команды «Переслать». Внизу выделено сообщение о запрете копирования и пересылки

Обычно в такой ситуации просишь: «Тогда пришлите скрин». В нашем тесте, пока виджет был виден в чате, клиент Telegram блокировал и снимок экрана. На иллюстрации выше виден именно запрет пересылки и копирования сообщения. В документации Telegram не указан единый режим скриншотов для всех устройств и всей истории чата.

Для бизнеса вопрос простой. Если клиент говорит «у меня в заказе было другое», что он может прислать менеджеру? Просить человека вручную переписать номер, состав и сумму после того, как мы столько сил потратили на удобный интерфейс, было бы довольно изобретательно.

Поэтому рядом с заказом мы добавили два действия:

  • Скопировать детали. Иконка в самой карточке кладёт в буфер номер заказа, статус, позиции и сумму. Текст можно вставить в чат поддержки. У штатного copyText предел в 256 единиц UTF-16; эмодзи может занять две. Длинный заказ в одну такую копию не поместится, поэтому сокращённый вариант помечаем словом «Кратко».
  • Получить подтверждение. Для полного состава предусмотрели отдельный PDF. Его формируем по данным заказа именно того бизнеса, у которого клиент покупал, и отправляем обычным документом без защиты от пересылки. Это подтверждение заказа с номером и деталями. Если нужен кассовый чек, он выдаётся отдельно.
Заказ на 50 BYN: иконка копирования в правом верхнем углу и отдельная кнопка «Получить подтверждение» под карточкой

32 КБ HTML и всего 4 КБ после сжатия

У разработчика здесь свой повод пересчитать заказ. Telegram одновременно проверяет два размера одного и того же виджета: до 32 768 байт исходного HTML со стилями и скриптами и до 4 096 байт после сжатия zlib на уровне 9. Ещё до 1 024 байт даётся на chat_data — меняющиеся данные сообщения. Официальные лимиты Telegram Widgets.

В одной из наших сборок карточка заказа заняла 3 925 байт после сжатия. Запас — 171 байт. И вот уже дизайнерская просьба «давайте поставим свой фон для каждого магазина» превращается в инженерную задачу. Виджет не может сходить на сайт магазина за картинкой. Если встраиваем её прямо в HTML, она делит те же четыре килобайта с кнопками, стилями и логикой заказа.

С составом получилось ещё интереснее. Сначала мы показывали по две позиции на странице. Заказал три лака — чтобы увидеть третий, листай. После теста договорились: три обычные позиции должны читаться сразу, каждая со своим количеством. Для действительно длинного заказа оставили страницы и переход в Mini App. Там хватает места на цену за единицу, итог и способ оплаты. А в чате клиенту чаще всего нужен ответ на один вопрос: «Что с моим заказом?»

Детали заказа в Mini App груминг-салона: шампунь, количество, цена и способ оплаты

А если отправить бонусное колесо прямо в Telegram-канал?

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

Сейчас так опубликовать HTML-виджет в канале нельзя. На 12 ноября 2026 года в production бот может отправить его только в личный чат с пользователем. Переслать готовую карточку из лички в канал тоже не получится. Для кофейни рабочий путь длиннее на один переход: в канале публикуем приглашение со ссылкой на бота, а колесо человек крутит уже в личке. Где доступны виджеты Telegram.

И вот в личке у колеса как раз есть смысл. На скрине у клиента 232 бонуса и бесплатная попытка. Он уже пришёл проверить баланс, видит «Испытать удачу» и может нажать здесь же. Так мы используем виджет у тех бизнесов, где включена эта механика.

Бонусная карта TEZAM в личном чате: баланс 232 бонуса, бесплатная попытка и кнопка «Испытать удачу»

Стоит ли бизнесу внедрять Telegram-виджеты

На демо мне тоже нравится погода в чате: облако плывёт, дождь идёт, всё живое. А теперь честно: когда вы последний раз открывали отдельный чат, чтобы узнать, брать ли зонт?

С заказом ответ у нас есть. Человек уже открывает чат магазина, чтобы проверить статус. С бонусами тоже: человек пришёл за балансом, а тут доступно вращение. Ради этих двух сценариев мы бы взялись за виджеты снова. А перед следующим я бы задал команде ровно один вопрос: что клиент собирался сделать в этом чате ещё до того, как мы придумали виджет?

Посмотреть, как выглядят клиентские приложения для кофейни, салона и магазина, можно в демо TEZAM.

В этом материале

  • Что даёт HTML-виджет в Telegram
  • Почему нельзя переслать виджет заказа
  • 32 КБ HTML и всего 4 КБ после сжатия
  • А если отправить бонусное колесо прямо в Telegram-канал?
  • Стоит ли бизнесу внедрять Telegram-виджеты
Enterprise / под ключ

Обсудить индивидуальную разработку под ключ

Оставьте заявку, если вашему бизнесу нужна сложная архитектура, кастомный дизайн или глубокие API-интеграции.

Телефон:+375 (33) 918-88-19
Нажимая на кнопку, вы соглашаетесь с обработкой персональных данных и офертой компании.