Как создать прокси-ссылку (MiniApp приложение)
Прокси-ссылки в Vortex – это инструмент для создания мини-приложений Telegram (WebApp), которые позволяют отслеживать путь пользователя от канала до сайта и обратно, сохраняя его Telegram ID для сквозной аналитики.
Видеоинструкция: как работать с прокси-ссылками
1. Где находятся прокси-ссылки
Окно управления прокси-ссылками доступно во вкладке «Продажи».
Перейдите туда и вы увидите:
- Таблицу с уже созданными прокси-ссылками
- Кнопку «Создать прокси-ссылку»
Нажмите на кнопку, чтобы начать настройку первой ссылки.
2. Выбор типа настройки
При создании прокси-ссылки доступны два варианта:
- Бот Vortex – быстрый старт без технических сложностей
Выберите этот вариант, если:
- У вас нет своего бота
- Не планируете собирать базу клиентов внутри бота
- Хотите быстро запустить аналитику
Что нужно: просто указать ссылку на сайт или бота, которую хотите обернуть.
- Собственный бот – полный контроль и гибкость
Выберите, если:
- У вас уже есть Telegram-бот
- Планируете использовать его для сбора базы, рассылок или интеграций
- Нужна глубокая аналитика по этапам воронки
Что нужно:
- Доступ к вашему боту
- Создание мини-приложения через BotFather
- Настройка интеграции
3. Основные параметры WebApp
Сервисный бот Vortex
URL Страницы, которая будет открываться с помощью прокси-ссылки
Укажите ссылку на вашу страницу, которую нужно открывать с помощью прокси-ссылки. Это может быть ссылка на любой ваш сайт.
Предлагать посетившему разрешить писать боту
Эта опция:
- Повышает конверсию в попадание в базу бота на 10% и более
- Через несколько секунд после открытия показывает пользователю стандартное окно Telegram: «Разрешить писать боту?»
Важно: чтобы функция работала корректно, необходимо установить на сайт скрипт:
<script type="text/javascript" src="https://app.vortex.pro/static/webapp_integration.js"></script>
Убедитесь, что он:
• Вставлен в HEAD страницы
• Присутствует только один раз
• Не обрезан и не содержит ошибок
Если пользователь отклонил предложение писать боту в самый первый запуск мини-приложения, то есть возможность отправить его ещё раз.
Открывать miniapp в полноэкранном режиме
При активации сайт в мобильном приложении будет открываться на полный экран.
Редиректить в браузер на платежных страницах
Если активировать, то страница оплаты откроется в браузере.
Например: пользователь открыл страницу в MiniApp, заполнил форму и нажал «Оплатить». При включенной функции страница оплаты откроется не в MiniApp, а в браузере.
Это необходимо для того, чтобы пользователя корректно перенаправляло в приложение банка для оплаты.
Мини-приложение – это изолированная среда, из которой не представляется возможности перенаправить пользователя в другое приложение. Именно поэтому мы создали функцию редиректа в браузер на платежных страницах.
Укажите полный или частичный URL платежной страницы.
Выберите режим совпадения:
- Полное совпадение – URL должен полностью совпадать (включая
https://)
Пример: https://yoursite.com/sales/shop/dealPay/id/12345678 – сработает только на точный адрес.
- Частичное совпадение – URL содержит указанную часть
Пример: sales– сработает на yoursite.com/sales/shop/dealPay/id/12345678, yoursite.com/sales/shop/dealPay/id/, yoursite.com/sales
Приоритет у полного совпадения. Система сначала проверяет его, затем – частичное.
Примеры:
- Пользователь перешёл на:
https://shop.com/product2
- Правило с полным совпадением
shop.com/product → ❌ не сработает
- Правило с частичным совпадением
product → ✅ сработает
При выборе «Собственный бот»
URL Страницы, которая будет открываться с помощью прокси-ссылки
Укажите ссылку на вашу страницу, которую нужно открывать с помощью прокси-ссылки. Это может быть ссылка на любой ваш сайт.
Предлагать посетившему разрешить писать боту
Эта опция:
- Повышает конверсию в попадание в базу бота на 10% и более
- Через несколько секунд после открытия показывает пользователю стандартное окно Telegram: «Разрешить писать боту?»
Важно: чтобы функция работала корректно, необходимо установить на сайт скрипт:<script type="text/javascript" src="https://app.vortex.pro/static/webapp_integration.js"></script>
Убедитесь, что он:
• Вставлен в HEAD страницы
• Присутствует только один раз
• Не обрезан и не содержит ошибок
Если пользователь отклонил предложение писать боту в самый первый запуск мини-приложения, то есть возможность отправить его ещё раз.
Открывать miniapp в полноэкранном режиме
При активации сайт в мобильном приложении будет открываться на полный экран.
Редиректить в браузер на платежных страницах
Если активировать, то страница оплаты откроется в браузере.
Например: пользователь открыл страницу в MiniApp, заполнил форму и нажал «Оплатить». При включенной функции страница оплаты откроется не в MiniApp, а в браузере.
Это необходимо для того, чтобы пользователя корректно перенаправляло в приложение банка для оплаты.
Мини-приложение – это изолированная среда, из которой не представляется возможности перенаправить пользователя в другое приложение. Именно поэтому мы создали функцию редиректа в браузер на платежных страницах.
Укажите полный или частичный URL платежной страницы.
Выберите режим совпадения:
- Полное совпадение – URL должен полностью совпадать (включая
https://)
Пример:https://yoursite.com/sales/shop/dealPay/id/12345678– сработает только на точный адрес.
- Частичное совпадение – URL содержит указанную часть
Пример:sales– сработает наyoursite.com/sales/shop/dealPay/id/12345678,yoursite.com/sales/shop/dealPay/id/,yoursite.com/sales
Приоритет у полного совпадения. Система сначала проверяет его, затем – частичное.
Примеры:
- Пользователь перешёл на:
https://shop.com/product2 - Правило с полным совпадением
shop.com/product→ ❌ не сработает - Правило с частичным совпадением
product→ ✅ сработает
1.
Уникальный скрипт для BotFather
Ссылка на приложение
Укажите ссылку на ваше мини-приложение в формате:t.me/ваш_бот/название_приложения
Эту ссылку вы получаете после создания мини-приложения в BotFather за 3 минуты.
Только владелец бота может это сделать.
ВНИМАНИЕ!!!
При создании мини-приложения на этапе, когда BotFather запрашивает WebApp URL, вам нужно указать ссылку не на ваш лендинг, а уникальную ссылку, сгенерированную Vortex.
Как создать мини-приложение в BotFather
Как создать MiniApp
Создание мини-приложения (WebApp) в Telegram – ключевой шаг для работы с прокси-ссылками в Vortex. Следуйте инструкции ниже, чтобы настроить его за 5 минут.
1. Перейдите в Telegram
2. Найдите @BotFather
Это официальный бот Telegram для управления ботами и создания мини-приложений.
3. Создайте бота или используйте существующий
- Если у вас ещё нет бота – создайте его с помощью команды
/newbotи следуйте инструкциям. - Если бот уже есть – перейдите к следующему шагу.
4. Запустите создание MiniApp
Отправьте команду:/newapp
BotFather отреагирует и предложит выбрать одного из ваших существующих ботов, на базе которого будет создано мини-приложение.
5. Выберите бота
Выберите бота из списка. Мини-приложение будет привязано к нему.
6. Укажите название WebApp
Введите название (заголовок), которое будет отображаться при открытии приложения.
Пример
Название testapp:
7. Добавьте короткое описание
Описание будет видно, когда приложение прикреплено к сообщению.
Пример
Пример, где testapp это название сверху и описание снизу:
8. Отправьте обложку приложения
Загрузите изображение (JPEG или PNG) – оно будет использоваться как превью приложения в чате.
Размер: 640x360 px.
9. (Опционально) Добавьте анимацию (GIF). Вы можете загрузить GIF-анимацию, которая будет показываться при запуске приложения. Если не хотите использовать анимацию, то нажмите на /empty.
10. Укажите WebApp URL – самый важный шаг!
Теперь нужно вставить уникальную ссылку, сгенерированную Vortex.
Где взять ссылку:
1) В интерфейсе Vortex перейдите в раздел «Продажи» ➡️ «Прокси-ссылки».
2) Нажмите «Создать прокси-ссылку».
3) Выберите тип «Собственный бот».
4) В блоке «Уникальный скрипт для BotFather» скопируйте ссылку.
5) Вставьте эту ссылку в диалог с BotFather.
Внимание!
Для каждого приложения генерируется уникальная ссылка!
11. Выберите имя для вашего приложения.
Задайте короткое имя для вашего мини-приложения.
Оно будет частью ссылки:t.me/ваш_бот/имя_приложения
Пример: t.me/mycourse_bot/get_lead
12. Готово! Получите ссылку на MiniApp.
BotFather отправит вам готовую ссылку на мини-приложение, например:
t.me/mycourse_bot/app
Сохраните её – она понадобится для завершения настройки в Vortex.
13. Вставьте ссылку в Vortex
Вернитесь в интерфейс Vortex:
1) В окне создания прокси-ссылки найдите поле «Ссылка на приложение».
2) Вставьте туда ссылку, полученную от BotFather.
14. Можно переходить к основным настройкам прокси-ссылки.
2.
URL сСтраницы, /которая будет открыва длться с побёмощью пртокси-ссылки
Введите ссылку, которую хотите обернуть в WebApp. Это может быть ссылка на любой ваш сайт.
3.Использовать базовую ссылку
Что это значит?
- Базовая ссылка:
t.me/ваш_бот/приложение– открывает указанную вами страницу без параметров - Дополнительные ссылки:
t.me/ваш_бот/приложение?startapp=xxx– открываются по параметру
Вы можете создать только одну базовую ссылку.
Зачем это нужно?
- Для рекламы в Telegram ADS требуется активная основная ссылка на приложение
- Базовая ссылка будет вести на главный лендинг, а остальные – на разные этапы воронки
- Все ссылки работают параллельно и не конфликтуют
4.
Дополнительная
настройка:
пПредл
ожиагать посетившему разрешить писать боту
Эта опция:
- Повышает конверсию в попадание в базу бота на 10% и более
- Через несколько секунд после открытия показывает пользователю стандартное окно Telegram: «Разрешить писать боту?»
Важно: чтобы функция работала корректно, необходимо установить на сайт скрипт:<script type="text/javascript" src="https://app.vortex.pro/static/webapp_integration.js"></script>
Убедитесь, что он:
• Вставлен в HEAD страницы
• Присутствует только один раз
• Не обрезан и не содержит ошибок
Если пользователь отклонил предложение писать боту в самый первый запуск мини-приложения, то есть возможность отправить его ещё раз.
Открывать miniapp в полноэкранном режиме
При активации сайт в мобильном приложении будет открываться на полный экран.
Редиректить в браузер на платежных страницах
Если активировать, то страница оплаты откроется в браузере.
Например: пользователь открыл страницу в MiniApp, заполнил форму и нажал «Оплатить». При включенной функции страница оплаты откроется не в MiniApp, а в браузере.
Это необходимо для того, чтобы пользователя корректно перенаправляло в приложение банка для оплаты.
Мини-приложение – это изолированная среда, из которой не представляется возможности перенаправить пользователя в другое приложение. Именно поэтому мы создали функцию редиректа в браузер на платежных страницах.
Укажите 5.полный или частичный URL платежной страницы.
Выберите режим совпадения:
- Полное совпадение – URL должен полностью совпадать (включая
https://)
Пример:https://yoursite.com/sales/shop/dealPay/id/12345678– сработает только на точный адрес.
- Частичное совпадение – URL содержит указанную часть
Пример:sales– сработает наyoursite.com/sales/shop/dealPay/id/12345678,yoursite.com/sales/shop/dealPay/id/,yoursite.com/sales
Приоритет у полного совпадения. Система сначала проверяет его, затем – частичное.
Примеры:
- Пользователь перешёл на:
https://shop.com/product2 - Правило с полным совпадением
shop.com/product→ ❌ не сработает - Правило с частичным совпадением
product→ ✅ сработает
Сохранение и использование
После заполнения всех необходимых полей нажмите «Сохранить».
Ваша прокси-ссылка готова к использованию!
Теперь вы можете:
Размещать прокси-ссылки в ботах, постах, рекламеОтслеживать переходы и конверсии- Для тестирования пройдите путь клиента и проверьте, появился ли он в разделе «Продажи» ➡️ «Клиенты».
Если возникли вопросы – напишите в поддержку: @televortex_support_bot