Если у вас еще нет контента для MiniApp, создайте его по этой инструкции.

Для того, чтобы работала автоматическая авторизация телеграм-пользователя и события в воронке по нему, необходимо подготовить специальную ссылку. Для этого вам понадобится настроенный блок в воронке - WebApp и привязанный к сценарию бот.

Перейдите в настройки блока "WebApp" и разверните пункт Ссылки для Telegram MiniApp. Затем в карточке нужного бота нажмите кнопку "Сгенерировать". Обратите внимание! У каждого бота своя уникальная ссылка. Нельзя использовать ссылку предназначенную для другого бота.

В карточке появятся дополнительные настройки.

• При запуске расширить область видимости.(1) По умолчанию телеграм открывает MiniApp не на весь экран. В мобильном приложении есть возможность сразу развернуть приложение на всю высоту. За это как раз отвечает данный параметр.
• Запросить разрешение на отправку.(2) Если у бота еще нет разрешения на отправку сообщений, он запросит это разрешение сразу при запуске приложения.

При изменении этих настроек не забудьте "применить изменения". Обратите внимание. Эти настройки обновляют состояние приложения в реальном времени, даже если ссылка уже установлена. Повторно переустанавливать ссылку не нужно.

Установка ссылки

Есть 2 способа установки ссылки для MiniApp:

• Установка в меню бота
• Создание мини-приложения через BotFather

Установка в меню бота

Это самый простой способ, не требующий никаких доп настроек. Позволяет установить приложение в вашего бота в 2 клика. Для этого просто нажмите кнопку "Установить в меню бота" и укажите название кнопки во всплывающем окне.

После этого, в левом нижнем углу Вашего бота появится кнопка.

Создание мини-приложения через BotFather

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

BotFather - это системный бот Telegram, который используется для управления своими ботами и мини-приложениями.

1. Перейдите в BotFather и напишите команду /newapp
2. Выберите бота, к которому будет привязано ваше мини-приложение. Важно! Выбирайте того же бота, для которого формировали ссылку в воронке.
3. Укажите название приложения. Оно будет отображаться в виджете, генерируемом для ссылки в чатах.
4. Укажите короткое описание приложения. Оно также будет отображаться в виджете для ссылки.
5. Отправьте изображение или иконку для Вашего приложения. Важно! Изображение должно иметь размер 640x360px в формате jpg или png. Отправлять нужно как фото (не как файл).
6. Опционально отправьте gif демонстрирующее работу приложения или пропустите шаг, отправив /empty
7. Самый важный шаг! Отправьте боту ссылку, которую сформировали вначале этой инструкции.

8. Укажите адрес для приложения используя латинские символы, цифры и знак _. Например my_app1.

Готово! Бот отправит вам ссылку на ваше приложение вида t.me/имя_бота/имя_приложения. Теперь можете делиться этой ссылкой любым способом. При переходе, у пользователей будет запускаться ваше мини-приложение.

При отправке ссылки в чатах телеграм, к ней прикрепляется виджет с настройками, которые вы задавали на 3-5 шагах инструкции.