Telegram Mini App: что это, когда нужно бизнесу и какие правила у Telegram

Мини-приложение в Telegram (Telegram Mini App, раньше Web App) — обычная веб-страница, которую бот открывает внутри мессенджера. Страница получает от Telegram тему оформления, кнопки и данные о пользователе, поэтому для человека она выглядит как часть Telegram. В этой статье Datamill разбирает, когда такое приложение оправдано и какие правила при этом действуют. Факты о возможностях и условиях берём из официальной документации Telegram, ссылки — в конце.

Что конкретно умеет мини-приложение для записи клиентов, мы уже разобрали в статье «Бот для записи клиентов в Telegram». Здесь — общая картина: зачем, как запускают и что обязательно.

Бот, мини-приложение или сайт

У бота есть сообщения и кнопки. Пока сценарий укладывается в два-три шага, этого хватает: напомнить о записи, подтвердить, ответить на вопрос. Когда шагов больше — анкета из десяти полей, выбор даты в календаре, корзина, — переписка становится неудобной, и тут нужно мини-приложение.

Сайт нужен, когда клиенты приходят из поиска и Telegram у них может не быть. Если же клиенты уже пишут вам в Telegram, мини-приложение убирает лишний переход в браузер, а бот может присылать подтверждения и напоминания.

Признаки того, что пора делать мини-приложение:

• в боте больше пяти-шести шагов подряд;
• человеку нужно что-то выбрать из списка, календаря или каталога;
• нужен личный кабинет: история заказов, записи, статусы;
• нужно принимать оплату с понятной корзиной.

Как мини-приложение запускают

По документации Telegram мини-приложение открывается несколькими способами:

• кнопка меню бота — рядом с полем ввода сообщения;
• кнопка в сообщении или клавиатуре бота — например, «Записаться» под приветствием;
• прямая ссылка вида t.me/имя_бота/имя_приложения — её можно поставить в канал, на сайт или превратить в QR-код;
• главное приложение бота — кнопка в профиле бота, настраивается через @BotFather;
• инлайн-режим — приложение открывается из поля ввода в любом чате;
• меню вложений — этот способ Telegram открывает не всем ботам.

Для бизнеса обычно хватает первых трёх: кнопка в боте для тех, кто уже подписан, и ссылка или QR-код для всех остальных.

Что мини-приложение получает от Telegram

Страница подключает скрипт Telegram и получает объект Telegram.WebApp. Через него доступны тема оформления, размеры окна, главная кнопка внизу экрана, кнопка «Назад», вибрация, всплывающие окна, полноэкранный режим и ярлык на главный экран — последние два добавлены в Bot API 8.0. Есть хранилища данных на устройстве и в облаке Telegram, запрос номера телефона и геолокации — только с согласия человека.

Подробный список с примерами для записи клиентов — в разделе «Что умеет мини-приложение» соседней статьи. Список меняется с каждой версией Bot API, поэтому перед проектом мы сверяем его с журналом изменений.

Проверка данных пользователя

При запуске Telegram передаёт странице строку initData: кто открыл приложение, когда (auth_date) и подпись hash. Документация прямо говорит: этим данным можно верить только после проверки на сервере. Сервер считает секретный ключ как HMAC-SHA256 от токена бота с ключом WebAppData, затем подпись строки данных этим ключом, и сравнивает с hash. Дату auth_date тоже проверяют, чтобы старую строку нельзя было использовать повторно.

Без такой проверки любой может подставить чужой идентификатор пользователя. Токен бота при этом остаётся только на сервере: в коде страницы его быть не должно. Это первое, о чём стоит спросить подрядчика.

Какие правила у Telegram

У Telegram есть общие условия для разработчиков ботов и отдельные условия для мини-приложений (telegram.org/tos/mini-apps). Коротко о том, что из них следует для бизнеса. Это наш пересказ, точные формулировки — в тексте условий по ссылкам ниже.

• Политика конфиденциальности. Telegram требует, чтобы пользователь мог узнать, какие данные собирает бот и приложение. Если своей политики нет, действует стандартная политика Telegram для ботов, но для бизнеса лучше иметь свою.
• Только нужные данные. Собирать можно то, что нужно для работы сервиса, и использовать данные только для него.
• Оплата цифровых товаров — в Telegram Stars. Физические товары и услуги оплачиваются через подключённого к боту платёжного провайдера.
• Telegram может ограничить или удалить бота за нарушение условий.

Отдельно от правил Telegram действует российский закон. Если приложение собирает имена, телефоны или анкеты, это персональные данные, и их нужно хранить на сервере в России. Почему анкету нельзя собирать в чате с ботом, мы разбирали в статье «Бот для записи клиентов в Telegram» и в кейсе с набором массовки: там бот только рассылает приглашения, а анкета открывается в мини-приложении и сохраняется на сервере агентства.

Как сделать мини-приложение

1. Создать бота через @BotFather и получить токен.
2. Сделать страницу — на любом фреймворке, она должна открываться по HTTPS.
3. Сделать сервер: проверка initData, база, отправка уведомлений через бота.
4. Подключить запуск: кнопку меню, кнопку в сообщении или прямую ссылку через @BotFather.
5. Написать политику конфиденциальности и указать её в настройках бота.

Конструкторы закрывают типовые сценарии — витрину или запись. Свою логику, выгрузки и сервер в России проще сделать отдельно. Когда задача — заменить ручную работу сотрудников, полезно посмотреть и на автоматизацию с ИИ: иногда часть сценария закрывает она.

Как это делаем мы

Мы делаем Telegram-ботов и мини-приложения под задачу бизнеса: запись, анкеты, заявки, личный кабинет. Сервер и данные остаются у вас, проверка initData и политика конфиденциальности входят в работу. Готового прайса нет: цену и срок называем после короткого описания задачи.

Частые вопросы

Мини-приложение и бот — это одно и то же?

Нет. Бот работает сообщениями и кнопками в чате. Мини-приложение — веб-страница, которую бот открывает внутри Telegram. На практике они идут вместе: бот запускает приложение и присылает уведомления, а формы и выбор живут в приложении.

Нужно ли пользователю что-то устанавливать?

Нет. Мини-приложение открывается в самом Telegram, на телефоне и на компьютере. Ярлык на главный экран телефона пользователь может добавить сам, если приложение это предложит.

Можно ли принимать оплату в мини-приложении?

Можно. Физические товары и услуги оплачивают через платёжного провайдера, подключённого к боту. Цифровые товары и услуги по правилам Telegram продаются только за Telegram Stars.

Где хранятся данные, которые человек вводит в мини-приложении?

На сервере владельца приложения: страницу и сервер делает разработчик, Telegram их не хранит. Поэтому сервер выбирают с учётом 152-ФЗ, если приложение собирает персональные данные россиян.

Подойдёт ли конструктор мини-приложений?

Для типовой витрины или записи — иногда да. Ограничения конструктора проявляются, когда нужна своя логика, своя база или сервер в России. Это мы проверяем до начала работ.

Источники

• Telegram Mini Apps, документация — core.telegram.org/bots/webapps
• Mini Apps, клиентская часть и способы запуска — core.telegram.org/api/bots/webapps
• Журнал изменений Bot API, версия 8.0 (полноэкранный режим, ярлык на главный экран) — core.telegram.org/bots/api-changelog
• Возможности ботов — core.telegram.org/bots/features
• Платежи в ботах и Telegram Stars — core.telegram.org/bots/payments-stars
• Условия для мини-приложений — telegram.org/tos/mini-apps
• Условия для разработчиков ботов — telegram.org/tos/bot-developers
• Наш проект: набор массовки через Telegram