Игры в Telegram: Games API или Mini App — как это работает
Основы3 минРедакция Innovialabs
Коротко
Games API — простой старый способ запустить HTML5-игру с таблицей рекордов в чате, а Mini App даёт полноэкранный режим, данные пользователя, оплату в Stars и шаринг; для новых проектов почти всегда выбирают Mini App.
Коротко: два способа сделать игру в Telegram
В Telegram есть два механизма для игр, и оба запускают обычную HTML5-игру внутри приложения.
- Games API — платформа, появившаяся раньше Mini Apps. Бот отправляет в чат карточку игры с кнопкой «Играть», игра открывается во встроенном браузере, а очки попадают в общую таблицу рекордов.
- Mini App — веб-приложение внутри Telegram с доступом к данным пользователя, полноэкранным режимом, платежам в Stars и функциям шаринга. Игра здесь — просто один из видов Mini App.
Для нового проекта в большинстве случаев выбирают Mini App. Games API имеет смысл для простых игр, где важна именно таблица рекордов внутри группового чата.
Как работает Games API
- В BotFather командой
/newgameсоздаётся игра: название, описание, картинка, short name. - Бот вызывает
sendGameс этим short name. В чате появляется карточка с кнопкой запуска. - При нажатии бот получает
callback_queryсgame_short_nameи отвечаетanswerCallbackQueryс URL игры. - Игра открывается, по окончании ваш сервер вызывает
setGameScore, аgetGameHighScoresвозвращает рейтинг игроков этого чата. - Через inline-режим пользователь может отправить игру в любой чат и вызвать друзей.
Ограничение: странице игры Telegram почти ничего не передаёт. Кто играет, вы определяете сами — например, подписанным параметром в URL, который формирует бот.
Как работает игра в Mini App
Mini App получает initData с подписью, по которой сервер проверяет пользователя. Дальше доступно то, чего нет в Games API:
- полноэкранный режим и управление ориентацией экрана;
- оплата в Stars прямо внутри игры;
- облачное хранилище для небольших данных игрока;
- вибрация, кнопки интерфейса Telegram, ярлык на главный экран;
- шаринг: подготовленные сообщения для отправки в чаты, публикация в истории, ссылки с параметром для реферальной механики.
Сравнение
| Критерий | Games API | Mini App |
|---|---|---|
| Запуск | Карточка игры в чате | Кнопка меню, ссылка, кнопка в сообщении |
| Данные пользователя | Передаёте сами через URL | initData с подписью |
| Таблица рекордов | Встроенная, по чату | Делаете сами на сервере |
| Платежи | Только через бота отдельно | Stars внутри игры |
| Экран | Встроенный браузер | В том числе полноэкранный режим |
| Развитие платформы | Без заметных изменений | Активно развивается |
Монетизация
- Stars. Для цифровых товаров и услуг внутри Mini App Telegram требует использовать Stars. Это могут быть дополнительные жизни, скины, уровни, отключение рекламы.
- Реклама. Для Mini Apps существуют сторонние рекламные сети: баннеры, полноэкранные вставки, видео с наградой. Важно, чтобы реклама не ломала игровой цикл.
- Не только деньги. Для бренда игра чаще окупается не продажами внутри неё, а подписками на канал, лидами, промокодами и узнаваемостью.
Вирусные механики
- Реферальные ссылки. Ссылка с параметром
startappпоказывает, кто пригласил игрока; за приглашение даётся бонус. - Вызов друга. Игрок отправляет результат в чат готовым сообщением с кнопкой «Сыграть».
- Рейтинги среди друзей и в группе — сильный стимул вернуться.
- Истории. Публикация результата в историю приводит новых игроков из контактов.
Следите, чтобы механики не превращались в спам: правила Telegram и самих пользователей это не прощают.
Что реально может сделать бизнес
- Промо-игра к запуску продукта или сезонной акции с призами в виде промокодов.
- Квиз о продукте или бренде с результатом, которым хочется поделиться.
- Геймифицированная программа лояльности: баллы за покупки, уровни, ежедневные задания.
- Игровой онбординг для сложного продукта.
Если в игре разыгрываются призы, заранее проверьте требования законодательства к стимулирующим акциям и лотереям в вашей стране.