Запуск мини-приложения в Telegram: настройка бота и кнопки меню

Мини-приложение в Telegram всегда связано с ботом: именно бот открывает веб-интерфейс внутри мессенджера и передаёт ему данные пользователя. Когда приложение разработано и размещено на сервере с HTTPS, нужно настроить способы его запуска. Их несколько, и правильный выбор влияет на то, сколько пользователей вообще дойдут до приложения.

Что нужно до настройки

• Бот, созданный в @BotFather на аккаунте компании
• Адрес приложения с действующим SSL-сертификатом
• Серверная проверка данных запуска
• Тестовый бот и тестовая версия приложения

Кнопка меню

Самый заметный способ. Слева от поля ввода в чате с ботом появляется кнопка, которая открывает приложение. Её настраивают в @BotFather в настройках бота: указывают текст кнопки и адрес приложения. Кнопку можно задавать и программно через Bot API, в том числе разную для разных пользователей. Пользователь, открыв чат с ботом, сразу видит, куда нажать. Текст кнопки должен быть коротким и понятным: «Каталог», «Записаться», «Меню», а не название компании.

Основное мини-приложение бота

В настройках бота можно включить основное мини-приложение. Тогда в профиле бота появляется кнопка его запуска, а приложение может отображаться в разделах поиска и рекомендаций Telegram. Для этого заполняются описание, изображения и демонстрационные материалы. Набор требований меняется, поэтому сверяйтесь с актуальными подсказками BotFather.

Прямая ссылка

Командой /newapp в BotFather создаётся мини-приложение со своим коротким именем. После этого его можно открыть по прямой ссылке вида t.me/имя_бота/имя_приложения. Такую ссылку удобно размещать на сайте, в соцсетях, в QR-кодах, в рекламе: человек переходит и сразу попадает в приложение.

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

Кнопки в сообщениях

Бот может отправить сообщение с инлайн-кнопкой, которая открывает приложение. Например, после команды /start бот приветствует пользователя и предлагает кнопку «Открыть каталог». Или в уведомлении о заказе — кнопку «Посмотреть заказ», которая открывает нужный экран. Кнопки обычной клавиатуры тоже могут запускать приложение.

Первый экран и приветствие

Пользователь, открывший бота впервые, видит описание бота до нажатия «Старт». Напишите в нём, что даёт приложение. После старта бот отправляет короткое приветствие с кнопкой запуска. Не заставляйте пользователя искать, как открыть приложение.

Тестирование перед публикацией

1. Откройте приложение всеми способами: кнопка меню, прямая ссылка, кнопка в сообщении
2. Проверьте на Android, iPhone, в настольном приложении и веб-версии Telegram
3. Проверьте светлую и тёмную тему
4. Проверьте медленный интернет
5. Проверьте ссылки с параметрами запуска
6. Убедитесь, что авторизация работает у новых пользователей, которые раньше не запускали бота

Продвижение

Ссылка на приложение в описании канала компании, закреплённое сообщение, QR-код на кассе и упаковке, кнопка на сайте. Сотрудники должны знать, как открыть приложение, чтобы помочь клиенту. Используйте разные ссылки с параметрами для каждого канала: так через неделю будет видно, откуда приходят пользователи.

Типичные ошибки

Разные адреса в кнопке меню и прямой ссылке после обновления. Приложение без приветствия и описания бота. Отсутствие проверки на старых телефонах. Запуск рекламы до того, как приложение проверено на нагрузку.