Ссылки на мини-приложение Telegram: прямые ссылки и параметры запуска

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

Способы открыть мини-приложение

1. Кнопка меню бота — постоянная кнопка рядом с полем ввода
2. Inline-кнопка в сообщении — бот отправляет сообщение с кнопкой, открывающей приложение
3. Кнопка клавиатуры — кнопка в обычной клавиатуре бота
4. Прямая ссылка — адрес в формате t.me, который можно разместить где угодно
5. Главное мини-приложение бота — открывается из профиля бота

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

Прямые ссылки

Прямая ссылка ведёт на мини-приложение, зарегистрированное в боте. Формат: адрес бота в t.me и короткое имя приложения, которое задаётся при создании в BotFather. Если у бота настроено главное мини-приложение, его можно открыть ссылкой на бота с параметром запуска приложения.

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

Параметр запуска

В ссылку можно добавить параметр startapp со значением. Приложение получает это значение при запуске в данных инициализации и может использовать его:

• открыть конкретный товар: параметр содержит идентификатор товара
• открыть раздел каталога или акцию
• определить источник: какой канал, пост или реклама привели пользователя
• применить промокод партнёра
• зафиксировать реферала в программе «приведи друга»

Значение параметра ограничено по длине и допустимым символам — латинские буквы, цифры, дефис и подчёркивание. Для сложных данных используйте короткий код, а расшифровку храните на сервере.

Примеры использования

Пост в канале о новом товаре. Ссылка открывает приложение сразу на карточке этого товара. Покупатель не ищет его в каталоге.

Реклама у блогера. Каждому блогеру — свой параметр. В аналитике видно, сколько пользователей и заказов привёл каждый.

QR-код в магазине. Покупатель сканирует код на ценнике и видит товар в приложении с отзывами и наличием в других размерах.

Реферальная программа. Каждый пользователь получает ссылку со своим кодом и приглашает друзей.

Как приложение получает параметр

При запуске мини-приложение получает данные инициализации от Telegram, включая параметр запуска. Важно: данные инициализации нужно проверять на сервере по подписи, чтобы убедиться, что они пришли от Telegram и не подделаны. Это особенно важно, если параметр влияет на бонусы или скидки.

Отслеживание источников

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

Проверка ссылок

Перед публикацией проверьте:

• открывается ли приложение на Android, iOS и в настольной версии Telegram
• правильно ли обрабатывается параметр
• что происходит, если параметр неверный или товар удалён — нужен понятный экран, а не ошибка
• что видит пользователь, открывший ссылку впервые

Частые ошибки

• Использование ссылки на бота без параметра запуска — пользователь попадает в чат и не понимает, что нажать
• Длинные или содержащие запрещённые символы параметры — ссылка не работает
• Отсутствие проверки данных инициализации на сервере
• Одна ссылка для всех каналов — невозможно оценить эффективность

Если нужно мини-приложение с продуманной системой ссылок и аналитикой источников, напишите — разработаем под ваш бизнес.