Skip to main content

Алгоритм загрузки клиентов через Webhook

Это наиболее продвинутый и гибкий способ автоматической передачи данных о клиентах в Vortex. Подходит для интеграции с конструкторами ботов (например, Salebot, BotHelp) и системами вроде GetCourse – особенно если ваша воронка построена на стандартных возможностях платформы.

С его помощью вы можете передавать данные на любом этапе воронки:

  • Регистрация / вход в бот

  • Прохождение квалификации

  • Получение лид-магнита

  • Покупка трипвейра

  • Оплата основного продукта

Выбор связки «Вебхук»

При выборе типа подключения «Вебхук» укажите понятное название связки (например: «Основной продукт», «Трипваер», «Лид-магнит»).

После этого откроется окно настройки вебхука.

Снимок экрана 2025-09-16 111739.png

Окно настройки и генерации Webhook

Снимок экрана 2025-09-16 111909.png

В этом окне вы можете:

  • Скопировать текущий URL вебхука
  • Перегенерировать ключ вебхука
  • Задать параметры по умолчанию
  • Установить часовой пояс
  • Установить защиту от дублирования

Параметры по умолчанию:

  • Название покупки
  • Сумма покупки

Если при запросе не передаются purchase_name или purchase_price, система подставит значения по умолчанию.

Приоритет всегда у данных, пришедших в самом запросе.

Часовой пояс

Важно учитывать, что время в Telegram фиксируется в формате UTC, тогда как в системах вроде GetCourse оно отображается по московскому времени (UTC+3). Из-за этой разницы при прямой передаче данных могут возникать несоответствия. Чтобы избежать путаницы, Vortex нормализует время к единому стандарту – UTC. Это позволяет корректно сопоставлять события, зафиксированные в разных системах.

Защита от дублирования

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

  • Защита отключена – все заходы считаются
  • Все дубли запрещены
  • Количество времени, после которого разрешены дубли (секунды) – повторная конверсия возможна только через указанное время (например, 180 секунд)

Принцип работы: POST и GET-запросы

Webhook поддерживает оба типа запросов:

  • POST – используется при работе с большинством ботов (Salebot, BotHelper и др.)
  • GET – используется, когда платформа корректно не поддерживает POST (например, GetCourse)

Как отправить данные

Отправьте POST-запрос на адрес:

https://proxy.vortex.pro/webhooks/sale?key=ваш_уникальный_ключ

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

Параметры запроса

В теле POST-запроса или в строке GET-запроса можно передать следующие поля:

{
  "telegram_id": 0,
  "username": "string",
  "purchase_price": 0,
  "purchase_name": "string",
  "purchased_at": "2024-04-25T19:33:32.539Z" / "25.04.2024",
  "utm_source" : "string",
  "utm_medium" : "string",
  "utm_campaign" : "string",
  "utm_content" : "string",
  "utm_term" : "string"
}
Описание полей
Особенность Параметр Описание
*обязательно telegram_id  integer (целое число), Telegram ID покупателя 
*обязательно username  string (строка), Telegram Username покупателя
Для отправки webhook достаточно указать хотя бы один из двух параметров (telegram_idилиusername)
/опционально purchase_price  float (число), цена конверсии
/опционально purchase_name  string (строка), название конверсии
/опционально purchased_at 

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

 

Если не указано – автоматически ставится время получения запроса
/опционально

utm_source

utm_medium

utm_campaign

utm_content

utm_term

string (строка), UTM-метки

 

Название каждой из меток должно точно соответствовать стандартному. 

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

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

Пример:

  • Выставлено по умолчанию: 1000 ₽, «Трипваер»
  • В запросе передано: 2990 ₽, «VIP-доступ»

В группу конверсий попадёт: 2990 ₽, «VIP-доступ»

Если в запросе нет цены и названия – применяются значения по умолчанию.

Все параметры можно передать и через GET-запрос, прописав их через разделитель «&» после URL вебхука. Подходит для GetCourse и других систем, которые корректно не поддерживают POST.

Пример GET-запроса

https://proxy.vortex.pro/webhooks/sale?key=xxx&telegram_id=123&purchase_name=Трипваер&purchase_price=1990&utm_source=tg_ads&utm_medium=cpc

После отправки запроса конверсия будет добавлена в ту группу, для которой был создан вебхук, по аналогии с добавлением конверсий вручную или через шаблон.

Данные о клиентах и конверсиях можно найти в разделе «Продажи» во вкладке «Клиенты»

photo_2025-09-16_11-51-16.jpg

Ответ сервиса (Response)

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

{
'detail': 'Successfully added sale',
'data': {
  'telegram_id': 12321312,
  'first_name': None,
  'last_name': None,
  'username': None,
  'has_premium': None,
  'register_date': None,
  'joined_at': None,
  'left_at': None,
  'purchased_at': '2025-07-02T08:45:48',
  'purchase_name': None,
  'purchase_price': None,
  'seconds_until_purchase': None,
  'time_until_purchase_humanreadable': None,
    'source': {
      'is_tgads': False,
      'name': 'Не найдены в базе'
      },
      'audience': None,
      'creative': None,
      'is_bot': None
      }
  'utm_tags': {
  'utm_source': 'test', 
  'utm_medium': 'test',
  'utm_campaign': 'test',
  'utm_content': 'test',
  'utm_term': 'test'
  }
 }

Ответ состоит из 2 частей: 

detail – статус обработки запроса
data – информация о добавленной конверсии и клиенте

Можно отключить детальный ответ data . Если вам не нужна подробная обратная связь, добавьте параметр:

response_with_data=false

Пример полного URL:

https://proxy.vortex.pro/webhooks/sale?key=xxxxxx&response_with_data=false

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

Этот метод позволяет полностью автоматизировать учёт продаж и получить точную привязку конверсий к источнику трафика.

Back to top