Как работать с прокси-ссылками

Прокси-ссылки в Vortex – это инструмент для создания мини-приложений Telegram (WebApp), которые позволяют отслеживать путь пользователя от канала до сайта и обратно, сохраняя его Telegram ID для сквозной аналитики.

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

1. Где рнаходятсположеныя прокси -ссылки.

Окно с управлениемя прокси-ссылками доступнаходится во вкладке «Продажи».

Перейдите втуда это окно.

Внутри вы увидите:

т

• Таблицу, в которой будут Ваши ссылки, а так уже кнопку для созданнымия прокси-ссылками
• Кновпку «Сой.здать прокси-ссылку»

 

Нажмите на эту кнопку, чтобы начать настроздание Вашейку первой прокси ссылки.

Общее описание вариантов создания бота

2. Выбор вартиантпа настройки

При создании прокси -ссылки док

ступны

- Бот Vortex -два варианта:

для

• Бот Vortex – быстроый настаройт без технически
  х сложностей

Выберирайте этот вариант, если:

у

В
• У вас нет плансвов сегобирать базу клиентов в собственном бота
• Не (или у Вас в принципе его нет). Вам будут доступны все основные преимущества webapp оболочки, а ненужную техническую часть мы берем на себя.

  Для начала работы достаточно только ссылки, которую вы хотите обернуть в webapp.

  - Собственный бот - контролируйте каждый аспект самостоятельно

  Выбирайте этот вариант, если у Вас есть собственный функционирующий Telegram бот или Вы планируете собирать базу клиентов внутри бота

• Хотите быстро запустить аналитику

Что нужно: просто указать ссылку на сайт или бота, для котогрую хотите чтобернуть.

• Собственный бот – полный контроль и гибкость

Выберите, если:

• У вас уже есть Telegram-бот
• Планируете использовать её вго дальнейшем.

  Для нсборач балазы, рассылок или интеграций

• Нужна глуботыкая анеобходалимо провести первонкачальную настройку, а так же пол этапам вороныйки
д

Что нужно:

• Доступ к Telegramвашему боту.
• Создание мини-приложения через BotFather
• Настройка интеграции

3. Основные параметры Web-AppWebApp

Сервисный бот Vortex

-

Параметры прокси ссылки при выборе сервисного бота Vortex

3.1 Если выбран «Собственный бот:»

1. Ссылка на приложение. 

Необходимо уУказажитье ссылку на ваше мини-приложение, в котфорое и будут оборачивматься все :
t.me/ваш_бот/название_приложения

ссылки через Vortex.

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

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

Как создать MiniApp: MiniApp

Создание

1. мини-приложения (WebApp) в Telegram – ключевой шаг для работы с прокси-ссылками в Vortex. Следуйте инструкции ниже, чтобы настроить его за 5 минут.

   1. Перейдите в Telegram

2. Откро

   2. Найдите @BotFather (ссылка: https://t.me/BotFather) 
   Это официальный сервисбот Telegram для управления ботами и создания мини-приложений.

   3. Создайте бота или используйте существ

ующий
• Если у выас ещё не создавали Telegramт бота, то– создайте его с помощью команды /newbot и следуйте инструкциям. 
• Если у васбот уже есть Telegram– бперейдите к следующему шагу.

4. Запустите сотздание - оMiniApp
Отправьте в диалог команду :
/newapp

5.BotFather BotFatherотреагирует и предложит вам выбрать одного из ужеваших существующих ботов, на базе которого будет создано Miniмини-приложение.

App

5. Выберите бота
Выберите бота из списка. Мини-приложение будет привязано к нему.

6. Укажите название WebApp
Введите название  - (заголовок), для web-app. Онкоторое будет отображаться каждый раз при открытии приложения. 

Пример, как это будет выглядеть

Пример, где нНазвание testapp:

7. ВДобаведиьте короткое описание для Web-App.
 Описано так жие будет видно каждый раз, когда приложение будприкрет расположено в качестве вложения в сообщениию. 

 

Пример как это будет выглядеть

Пример, где testapp это название сверху и описание снизу:

8. Отправьте картинобложку, кприложения
Загрузите изобраяжение (JPEG или PNG) – оно будет использована вться качк прествеью обложкпри для того же вложения в чате.
Размер: 640x360 px.

9. (Опционально) Добавьте анимацию (GIF). Ваы м предложеноте загрузить GIF кGIF-артнинкумацию, которая будет потобркажзываться впри мзапуске приложениаппя. ЭЕсли не хотите использовать анимацию, то необязательное требование, просто ажмите на /empty. 

 empty.

10. ВведУкажите WebApp URL.URL ЭТО– ВАЖНЫЙсамый ЭТАПважный шаг! 

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

Где взять ссылку:

1) В интерфейсе Vortex перейдите в раздел «Продажи» ➡️ «Прокнси-ссылки».

2) Нажмите с«Созданиять прокси -ссылку».

3) Выберите тип «Собственный Vortexбот».

вас

4) вВ "блоке «Уникальный скрипт для BotFather".BotFather» Бскопирудьйте внимательны, ссылку.

5) Вставьте эту ссылку в диалогенерирует ся уBotFather.

Вникмальная дие!
Для каждого приложения: генерируется уникальная ссылка!

11. Выберите, какимя будетля выглядеть ссылка на Вашего приложениея.
Задайте Экороткое какимя tg_username для обычновашего аккауминта и-пользователя риложения.

для бота. Исходить нуж

Оно избудет частью ссылки:
t.me/ваш_бобственных п/имя_предпилочтжений.я

Пример: t.me/mycourse_bot/get_lead

12. УГотово! Получите ссылку на MiniApp.

BotFather отпра! Вы создалви миниприложение и Botfather показывает вам готовашую ссылку на мини-приложение. Именно эта ссылка, например:

t.me/mycourse_bot/app

Сохраните нужеё – она понадобится для завершения настройки в Vortex!Vortex.

13. СкопируйВставьте эту ссылку в Vortex

Веёрнитесь в и вставьнтерфейс еVortex:

1) В окне всоздания прокси-ссылки найдите поле «Ссылка на приложение».

2) Вставьте туда ссылку, полученную от BotFather.

14. Можно переходить к основным настройкам прокси -ссылоки. 

2. URL страницы / бота, для обёрткоторую вы планируете "упаковать" в мини - приложение

Просто вВведите здесь ссылку, котораяую дхолжна бытьите обернутаь в WebWebApp. App. СсылкаЭто может быть совершенносылка на любой ваш сайт.

:) 

3. Использовать ссылку как базовую дссыля вашего мини - приложения. ку

Что это знакоечит?

б

• Базовая ссылка?:
  t.me/ваш_бот/приложение

  Э– открывает указанную вами страницу без параметров

• Дополнительные ссылки: t.me/ва, кш_бот/приложение?startapp=xxx – открываются по параметрую
вы

в итоге создали в Botfather вида "t.me/moibot/app". 

Вы можете создать только одну базовую ссылку. 

ЧЗачем она отличается от других ссылок?

У других ссылок будет будет вид t.me/moibot/app?startapp=324fn53. Ээто назвается ссылка "с параметром". Именужно по этому параметру Vortex понимает какую именно ссылку внутри мини-приложения вы хотите открыть. ?

Это

по
• Длезная опция, если вы хотите запускать рекламу на такое приложениеы в Telegram ADS,ADS так как длребуется модерации важно, чтобы была активна именноя основная ссылка приложения и смотрит именно на нее.

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

бе
• Баз повараметра (t.me/moibot/app)

  - А по другим прокси -я ссылкам "с параметром" (t.me/moibot/app?startapp=324fn53) - будует овесткри на главныватьсяй любендинг, а остальные д– на ругиазные дэтапы воругонки

• Все ссылки что вы создадите в других прокси ссылках для этого приложения. 

  Они прекрасно работают вмпараллестельно и не конфликтуют:)

4. Дополнительная настройка: Ппредлагаожить посетившему разрешить писать боту

УЭта опция:

• Повеличивышает конверсию в попадание в базу бота на 10% и более
• Через несколько секунд после открытия показывает пользователю стандартное окно Telegram: «Разрешить писать боту?»

Важно: чтобы функция работала корректно, необходимо установить на сайт скрипт:

<script type="text/javascript" src="https://app.vortex.pro/static/webapp_integration.js"></script>

Убедитесь, что он:
• Вставлен в HEAD страницы
• Присутствует только один раз
• Не обрезан и не содержит ошибок

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

Фу5. Сохранкцение и использование

После заполнения првсех необходлагаетимых послетй нажмителям «Сохранить».

Ваша прокси-ссылкиа через несколько секунд после её готова крытия разрешить писать боту, тем самым повысив % конверсий. Выглядит это для пользователя следующим образом:

Обратите внимание, чтобы эта функция работала исправно, необходимо, чтобы у вас был доступ к сайту и чтобы вы добавили в HEAD сайта небольшой скрипт: 

4. Базовая настройка прокси ссылки окончена. Уже сейчас вы можете сохранить окно и ваша ссылка будет работатью! 

Таблица прокси-ссылок. Г– главное меню

В таблице потобредажаютставленыя все созданные вамши прокси -ссылки с осноключевной информацией:

• Название
• Создатель
• Подключенный бот (сервисный или собственный)
• Количество переходов

Здесь же вы можете:

• Выгрузить

  Сотрокачет по посещениска вям прокси-ссылки. Он придет вам в бота @SibLead_stats_bot в формате XLSX.

• Скопировать прокси-ссылку.
• Перейти к настройкам конкретной прокси-ссылки.

Поиск по прокси-ссылках. Поиск нужной ссылким

Вы можете искать нужныеую прокси-ссылкиу по следующим параметрам:

• name —– название ссылки
  
• link —– исходная (основная) ссылка
   (открывается с помощью прокси-ссылки)
• proxy_link —– сама прокси-ссылка (например: "https://t.me/telegram_bot/telegram_app?startapp=Yl1GXKYH"XXXXXXXX)
  
• created_by_user.name —– имя пользователя, который создал ссылку

---

Готово! Теперь вы можете:

• Размещать прокси-ссылки в ботах, постах, рекламе
• Отслеживать переходы и конверсии
  
• Для
   тестирования пройдите путь клиента и проверьте, появился ли он в разделе «Продажи» ➡️ «Клиенты».

Если

возникли

вопросы

Материал– нахпишите в подитсядержку: на редакции.@televortex_support_bot