Telegram Widgets: інтерактивні повідомлення з іграми та TON-платежами

Telegram офіційно запустив Widgets — інтерактивні блоки, які боти можуть розміщувати безпосередньо всередині повідомлень. Оновлення з’явилося 9 листопада 2026 року разом із Bot API 10.4. Відтепер користувач може взаємодіяти з опитуванням, мінігрою або іншими елементами інтерфейсу, не відкриваючи окремий Mini App чи браузер.

Новий формат також підтримує запити на TON-транзакції через вбудований гаманець. Для розробників ботів, маркетологів і performance-команд це відкриває можливість створювати короткі інтерактивні сценарії прямо в чаті. Однак повноцінного запуску для всіх типів повідомлень ще немає: наразі віджети працюють у продакшені лише в особистих чатах із ботами.

Key Takeaways

• 9 листопада Telegram Bot API 10.4 отримав метод sendWidget для надсилання інтерактивних HTML-повідомлень.
• Один віджет може містити до 32 КБ HTML, CSS і JavaScript, але після стиснення його розмір не повинен перевищувати 4 КБ.
• Віджети виконуються в ізольованому середовищі QuickJS без прямого доступу до мережі.
• Підтримуються інтерактивні кнопки, графіки, опитування, ігри та запити до бота.
• TON-транзакції можливі через вбудований гаманець із підтвердженням користувача.
• У робочому середовищі доступні лише приватні чати з ботами; групи, пересилання та inline-режим поки залишаються на тестовому сервері.

Що таке Telegram Widgets і як вони працюють

Telegram Widgets — це невеликі інтерактивні HTML-документи, які відображаються як частина звичайного повідомлення. На відміну від кнопки, що запускає вебзастосунок, віджет одразу показує свій інтерфейс у стрічці чату.

Код віджета може містити HTML-розмітку, CSS-стилі та JavaScript. Telegram стискає його перед передаванням, а клієнтський застосунок відображає інтерфейс відповідно до власних правил безпеки й оформлення.

Офіційна документація наводить кілька прикладів використання: інтерактивне голосування, графік ціни, настільна гра для двох учасників або промокод, який можна скопіювати натисканням.

Важлива особливість — код віджета залишається незмінним після надсилання. Оновлювати можна його стан: наприклад, результати голосування або дані, отримані від бота. Якщо потрібно змінити сам інтерфейс, доведеться створити новий віджет.

Чому ліміт 4 КБ не означає повноцінний сайт у повідомленні

Telegram встановив два обмеження на розмір одного віджета: до 32 768 байтів вихідного HTML-документа та до 4096 байтів після стиснення алгоритмом zlib. До документа входять вбудовані стилі й JavaScript.

Це дозволяє створювати компактні інтерфейси без завантаження зовнішніх ресурсів. Водночас формат не призначений для запуску повноцінних сайтів із великими бібліотеками, відеоплеєрами чи складними формами.

Віджети працюють у QuickJS, а не у звичайному браузерному WebView. Telegram забороняє прямі мережеві запити через fetch, XMLHttpRequest і WebSocket. Зовнішні скрипти, стилі, шрифти та зображення також не завантажуються.

Крім того, підтримуються не всі HTML-елементи. Зокрема, стандартні поля input, textarea та select недоступні. Тому складні анкети або форми введення даних потрібно реалізовувати іншими засобами чи переносити в Mini App.

Як віджет обмінюється даними з ботом

Попри відсутність прямого доступу до інтернету, інтерактивні повідомлення можуть взаємодіяти із серверною логікою бота.

Для цього використовується метод TelegramWidget.request(). Коли користувач натискає кнопку, віджет надсилає запит через інфраструктуру Telegram. Бот отримує подію widget_query, обробляє її на своєму сервері та повертає відповідь.

Наприклад, користувач обирає один із варіантів у квізі. Віджет передає вибір боту, той перевіряє відповідь і повертає результат. Після цього інтерфейс може показати наступний етап без відкриття нового вікна.

Для синхронізації передбачені два типи стану: chat_data, прив’язаний до конкретного повідомлення в чаті, та public_data, який може використовуватися кількома екземплярами спільного віджета.

Це створює технічну основу для голосувань, багатокористувацьких сценаріїв і віджетів із даними, що оновлюються. Але можливість використовувати такі сценарії в групах і пересланих повідомленнях поки обмежена тестовим середовищем.

TON-платежі всередині повідомлень: що підтримується

Одна з найцікавіших функцій Telegram Widgets — інтеграція з вбудованим TON-гаманцем. Віджет може ініціювати запит на криптовалютну транзакцію або підпис даних, використовуючи формати TON Connect.

Сценарій платежу передбачає кілька етапів. Користувач натискає кнопку, віджет звертається до бота, бот формує параметри транзакції, а Telegram відкриває вікно гаманця з інформацією про суму й отримувача.

Транзакція потребує підтвердження користувача. Після її надсилання бот має перевірити результат у блокчейні, зокрема адресу відправника, отримувача та суму. Самого повідомлення про надсилання недостатньо для підтвердження успішної оплати.

При цьому API гаманця доступний не завжди. Він може бути відсутнім у старих версіях застосунку, у країнах без підтримки відповідного гаманця або в режимах, де віджету заборонено надсилати запити.

Отже, Telegram справді дозволяє ініціювати TON-платежі з інтерактивного повідомлення. Але це не універсальний платіжний шлюз для будь-яких товарів і способів оплати. Саме підтвердження операції відбувається в окремому захищеному інтерфейсі гаманця.

Telegram Widgets проти Mini Apps: у чому різниця

Telegram окремо наголошує, що Widgets не є зменшеною версією Mini Apps. Це два різні інструменти для різних сценаріїв взаємодії.

• Розміщення: Widgets відображаються всередині повідомлення, а Mini Apps запускаються в окремому WebView.
• Розмір: віджети мають суворий ліміт коду, тоді як Mini Apps можуть використовувати повноцінні вебінтерфейси.
• Мережа: Widgets не мають прямого доступу до інтернету, а Mini Apps можуть працювати із зовнішніми серверами.
• Взаємодія: віджети підтримують натискання, утримання та горизонтальні жести, але не стандартне введення тексту.
• Платежі: Widgets мають API для взаємодії з TON-гаманцем, а Mini Apps підтримують ширшу платіжну інфраструктуру.
• Складність: віджети підходять для коротких інтерактивних дій, а Mini Apps — для каталогів, особистих кабінетів і багатокрокових сервісів.

Раніше UAGEEK уже розбирав цю технологію на етапі тестування в матеріалі про HTMLBubbles, інтерактивні ігри та TON у Telegram. Тепер головна зміна полягає в появі офіційного Bot API й документації для розробників.

Чи можна використовувати Telegram Widgets для арбітражу трафіку

Для affiliate-маркетингу найцікавіша можливість — перенести частину взаємодії з користувачем із зовнішньої сторінки безпосередньо в повідомлення бота.

Наприклад, замість звичайного тексту з посиланням бот може показати інтерактивний вибір пропозиції, короткий квіз або демонстрацію продукту. Користувач одразу виконує дію, а бот отримує сигнал для наступного етапу сценарію.

Потенційні сценарії використання:

• Інтерактивний прелендинг: короткий сценарій із вибором варіантів і переходом до відповідної пропозиції.
• Квізи та гейміфікація: залучення користувача через просту гру або послідовність запитань.
• Промокоди: показ персоналізованої пропозиції з можливістю скопіювати код.
• Товарні картки: компактний інтерфейс із ціною, умовами та кнопкою подальшої дії.
• TON-сценарії: запит на транзакцію через підтримуваний гаманець із підтвердженням користувача.

Однак це потенційні сценарії, а не підтверджені результати рекламних кампаній. Наразі немає достатніх публічних даних, щоб стверджувати, що віджети підвищують CTR, конверсію або прибутковість порівняно зі звичайними повідомленнями чи Mini Apps.

Важливо й те, що нова функція Bot API не означає автоматичного дозволу розміщувати такі блоки в Telegram Ads. Рекламні оголошення платформи мають власні формати та правила модерації.

Головне обмеження: віджети поки не можна поширювати в усіх чатах

Станом на 13 листопада 2026 року офіційна документація Telegram описує поетапне розгортання Widgets.

У робочому середовищі боти можуть надсилати інтерактивні повідомлення лише в приватні чати з користувачами. Такі повідомлення автоматично захищені від пересилання.

Підтримка віджетів у групах, inline-режимі та пересланих повідомленнях уже реалізована на тестовому сервері, але ще не доступна для звичайного використання.

Це суттєво обмежує вірусне поширення інтерактивного контенту. Зараз не можна просто створити віджет і розраховувати, що користувачі масово пересилатимуть його між групами та каналами.

Крім того, користувачі застарілих клієнтів Telegram можуть бачити повідомлення як непідтримуваний медіаформат із текстовим підписом. Для комерційних сценаріїв це означає необхідність передбачити альтернативний спосіб взаємодії.

Що варто зробити розробникам і маркетологам

Поява офіційного API вже дозволяє починати розробку й тестування віджетів. Але переносити на них повноцінні воронки продажів поки зарано.

1. Перевірити підтримку Bot API 10.4 у власній інфраструктурі та бібліотеках для Telegram-ботів.
2. Створити невеликий тестовий віджет із кнопками, коротким квізом або промокодом.
3. Перевірити обмеження HTML, JavaScript і розміру стисненого коду.
4. Реалізувати обробку widget_query на сервері бота й перевірити оновлення стану.
5. Для TON-платежів передбачити підтвердження користувача, перевірку транзакції та обробку помилок.
6. Зберегти альтернативний сценарій через звичайне повідомлення або Mini App для непідтримуваних клієнтів.

Для performance-команд доцільно почати з тестування окремих етапів воронки: залучення, взаємодії з квізом, натискання на пропозицію та завершення цільової дії. Так можна оцінити, чи справді віджет скорочує втрати користувачів, а не просто додає новий інтерактивний елемент.

Що далі з Telegram Widgets

Telegram перейшов від експериментів з HTMLBubbles до документованого інструменту для ботів. Розробники вже отримали можливість створювати компактні інтерфейси, які працюють безпосередньо в повідомленнях, обмінюються даними з ботом і підтримують взаємодію з TON-гаманцем.

Наступний важливий етап — розширення доступності віджетів на групи, inline-режим і пересилання. Саме ці можливості можуть зробити формат значно цікавішим для поширення інтерактивного контенту.

Поки що Telegram Widgets варто розглядати як новий інструмент для ботів і коротких сценаріїв взаємодії, а не повноцінну заміну прелендингам або Mini Apps. Їхня практична цінність для маркетингу залежатиме від подальшого розгортання та реальних результатів тестування.

Джерела для перевірки

Джерела для перевірки

Telegram — Widgets. Офіційна технічна документація: розмір коду, QuickJS, мережеві обмеження, робота зі станом, TON-гаманець та етапи розгортання.
Документація Telegram Widgets

Telegram — Bot API. Оновлення Bot API 10.4 від 9 листопада 2026 року, методи sendWidget і sendSharedWidget та нові типи подій.
Історія оновлень Telegram Bot API

Telegram — Mini Apps. Офіційний опис платформи Mini Apps, її можливостей і способів запуску для порівняння з Widgets.
Документація Telegram Mini Apps

Павло Дуров — повідомлення в X. Публічне повідомлення про появу інтерактивних застосунків усередині повідомлень Telegram.
Оригінальна публікація Павла Дурова

UAGEEK — Telegram тестує HTMLBubbles: ігри та TON прямо в чатах. Попередній етап розвитку технології до появи офіційного Bot API.
Матеріал про тестування HTMLBubbles