Skip to main content

Prodamus XL

image.png

Интеграция с Prodamus XL позволяет автоматически передавать данные о регистрациях и оплатах в Vortex по вебхуку. Реализуется это через Сценарии в чат-боте.

Как настроить

Шаг 1. Создание связки и получение Webhook-ключа

Перед настройкой в Prodamus XL необходимо получить ключ вебхука на стороне в Vortex. Скопировать его можно во вкладке «Продажи» ➡️ «Управление конверсиями» в настройках вебхука.

Чтобы получить вебхук, нужно создать группу конверсий на вкладке «Продажи» и выбрать «Вебхук» в качестве источника.
Как это сделать описано в этой инструкции.

Шаг 2. Подключение Telegram-бота к Prodamus XL 

Если у вас уже есть подключенный бот, то перейдите к шагу 3.

Как подключить Telegram-бота к Prodamus XL

1. Перейдите в «Общение» ➡️ «Каналы чата» и нажмите кнопку «+ Создать канал». В выпадающем списке выберите Telegram

Снимок экрана 2025-12-08 163852.png

2. Введите название канала, токен бота из @BotFather и нажмите «+ Создать»

Снимок экрана 2025-12-08 164622.png

Если вы хотите использовать уже существующего бота, то его ранние настройки перестанут действовать. Поэтому рекомендуем создать именно нового бота. 

  1. Создайте нового бота в @BotFather с помощью команды /newbot.
  2. После успешного создания бота, скопируйте токен и вставьте в соответствующее поле в Prodamus XL

Готово. Бот подключен.

Шаг 3. Настройка блока вебхука в Prodamus XL

1. Перейдите в «Общение» ➡️ «Чат-боты» и выберите нужного чат-бота (или создайте нового и настройте цепочку сообщений).

2. Откройте вкладку «Сценарий» и в нужном месте (например, после оплаты или регистрации) добавьте блок «Веб-хук».

Снимок экрана 2025-12-08 170033.png

3. Перейдите в настройки веб-хука. Укажите название узла (например, передача данных в Vortex), выберите метод GET и вставьте URL вебхука.

Снимок экрана 2025-12-08 174551.png

URL вебхука состоит из ключа вебхука и переменных. Чтобы данные корректно передались в Vortex, необходимо указать Telegram ID пользователя. Telegram ID передается в переменной #Chat.Id(ID канала)#.

Где взять ID канала?

1. Перейдите в «Общение» ➡️ «Каналы чата»

2. Найдите нужный канал и скопируйте значение ID

Снимок экрана 2025-12-08 171024.png

Таким образом, ссылка будет иметь следующий вид:

ключ_вебхука&telegram_id=#Chat.Id(ID канала)#

Пример: https://proxy.vortex.pro/webhooks/sale?key=a1b123456c1234d123456789efg1hi1j&telegram_id=#Chat.Id(8456656196)#

В ссылке вы также можете передать название конверсии, ее стоимость и UTM-метки.

Описание всех доступных переменных
Особенность Параметр Описание
*обязательный telegram_id 

integer (целое число), Telegram ID покупателя
*обязательный username  string (строка), Telegram Username покупателя

Для отправки вебхука необходимо указать либо telegram_id, либо username – достаточно передать хотя бы один из этих параметров.

Если вы передаёте telegram_id, отправка username не требуется.
/опциональное purchase_price 

float (число), цена конверсии
/опциональное purchase_name 

string (строка), название конверсии
/опциональное purchased_at 

datetime (дата и время), время совершения конверсии

Можно не указывать. В этом случае подставится время отправки webhook.
Если отсутствует – подставится дата отправки настоящего запроса.
/опциональное

utm_source

utm_medium

utm_campaign

utm_content

utm_term

string (строка), значения UTM-меток

 

Можно передать как одну из UTM-меток, так и все сразу.

Важно: названия UTM-меток должны точно соответствовать установленным стандартам – любое отклонение может привести к некорректному сбору данных.

Пример полной ссылки с Telegram ID, названием и ценой конверсии и UTM-метками

https://proxy.vortex.pro/webhooks/sale?key=a1b123456c1234d123456789efg1hi1j&telegram_id=#Chat.Id(8456656196)#&purchase_name=Название_конверсии&purchase_price=12345&utm_source=source&utm_medium=medium&utm_campaign=campaign&utm_content=content&utm_term=term

Интеграция готова к работе.

После отправки запроса:

  • Конверсия появится в выбранной группе клиентов
  • Данные можно просмотреть во вкладке «Продажи»
  • Также доступна детальная выгрузка

Автоматический запуск Сценариев при открытии прокси-ссылки или переходе на страницу конверсии

Для онлайн-школ и проектов, использующих Prodamus XL, появилась возможность запускать Сценарии напрямую через прокси-ссылки Vortex.

Возможности интеграции

1. Автоматический запуск Сценариев при открытии прокси-ссылки или переходе на страницу конверсии.

image.png

2. Передача UTM-меток и URL-адресов:

  • startURL – стартовая страница
  • conversionURL – страница, куда перешёл пользователь

3. Работает с любым Telegram-ботом, подключённым к Prodamus XL.

Инструкция по подключению

Настройка в Prodamus XL

Шаг 1. Перейдите в раздел «Настройки» и сформируйте API-ключ с правами
  • Запуск Сценария
  • Управление каналами чата

Сохраните и скопируйте ключ – он понадобится в Vortex.

image.png

Шаг 2. Проверьте подключение Telegram-бота

Убедитесь, что нужный бот добавлен в разделе «Каналы чата».

Если его нет – подключите.

image.png

Шаг 3. Создайте пользовательские атрибуты

Откройте карточку любого контакта ➡️ «Управление пользовательскими атрибутами» ➡️ создайте два дополнительных поля.

Важно: ключ должен быть указан точно как указано ниже:

  • Стартовая страница – startURL
  • Страница конверсии – conversionURL

Ошибка в значении ключа нарушит работу интеграции!

image.png

Шаг 4. Создайте Сценарий

1. Перейдите во вкладку «Настройки» ➡️ «Сценарии».

2. Создайте нужный сценарий.

3. Убедитесь, что он включён.

4. Скопируйте ID сценария – он будет использоваться в Vortex.

Сценарии из других вкладок не поддерживаются. Используйте только те, что находятся в разделе «Настройки» – они работают глобально.

image.png

Настройка в Vortex

image.png

0. Выберите тип интеграции

При создании прокси-ссылки выберите «Собственный бот»

Убедитесь, что это тот же бот, который подключён к Prodamus XL.

1. Вставьте API-токен

В поле «API-ключ Prodamus XL» вставьте скопированный ранее токен.

2. Настройте запуск Сценариев

Вы можете запустить до двух сценариев по разным условиям:

  • При открытии WebApp
  • После перехода на страницу конверсии

Для каждого укажите:

  • ID сценария
  • Задержку (в секундах), через которую он запустится

Пример:

  • Если пользователь не перешёл на страницу благодарности в течении X секунд после открытия webapp ➡️ запустить сценарий №123 через 10 секунд
  • Через X секунд после перехода пользователя на страницу благодарности ➡️ запустить сценарий №456 через 5 секунд

Готово! Интеграция настроена.

Передача UTM-меток

Чтобы передавать UTM-метки:

  • Укажите их внутри URL при создании прокси-ссылки, или
  • Добавьте снаружи, используя формат:
    t.me/ваш_бот/приложение?startapp=ID__utm_source=telegram__utm_medium=post

image.png

Поддерживаются стандартные метки:

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

Проверка подключения

Используйте кнопку «Обновить статус подключения» в интерфейсе Vortex.

Она покажет, установлена ли связь между Vortex и Prodamus XL.

Рекомендуем самостоятельно проверить, что данные приходят корректно:

• Откройте прокси-ссылку
• Пройдите путь клиента
• Проверьте карточку контакта в Prodamus XL

Как данные приходят в Prodamus XL

После конверсии в карточке контакта вы увидите:

  • Поле startURL – с главной страницы
  • Поле conversionURL – куда перешёл пользователь

image.png

А также последние UTM-метки в разделе «Источник»:

image.png

image.png

Если возникли трудности – напишите в техподдержку: @televortex_support_bot

Back to top