Skip to main content

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

Это наиболее продвинутый и гибкий способ автоматической передачи данных о клиентах в Vortex. Подходит для интеграции с конструкторами ботов (например, Salebot, BotHelp) и системами вроде GetCourse – особенно если ваша воронка построена на стандартных возможностях платформы.
С его помощью вы можете передавать данные на любом этапе воронки:
  • Регистрация / вход в бот
  • Прохождение квалификации
  • Получение лид-магнита
  • Покупка трипвейра
  • Оплата основного продукта
1.

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

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

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



2.

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

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

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

image.png

В


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

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

Параметсяры этим вебхуком.

Ппо умолчанию:

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

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

Т.е п

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

3. Общий принцип: POST / GETмом запросе.

Принцип работы

WebHook: -POST ми GET-запросы

Webhook поддерживает оба типринимать запросыов:

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

Канные придется передавать через GET.

Инструкция для отправки Webhook


Для добавления продажи нужно отправить данные

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

https://proxy.vortex.pro/webhooks/sale

В параметрах запроса нужно указать уникальный ключ:

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

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

.

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

В теле 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  (хотя бы 1один из 2хдвух параметров (telegram_idилиusername)
/опциональное purchase_price  float (число), цена конверсии
/опциональное purchase_name  string (строка), название конверсии
/опциональное purchased_at  !можно не указывать. Проставится время отправки webhook

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

 

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

utm_source

utm_medium

utm_campaign

utm_content

utm_term

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

 

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

Каждая из utm меток будет присвоена к конкретной конверсии, вместе с которой отправляются.

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

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

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

Праимер:

  • Выстрахвлено по умолчанию: 1000 ₽, «Трипв веб-хуке будет содаерж»
  • В заться другая цена и наименование - то внесены будут те, что пришли по веб-хуку.

Все перечдано: 2990 ₽, «VIP-доступ»

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

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

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

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

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


Пример:
По умолчанию выставлены параметры: 1000 рублей и “название 1”. Если через веб-хук отправить только обязательные параметры, то будут использованы параметры по умолчанию. Если через веб-хук отправить поля “2000 рублей” и “название 2”, то в продажи занесётся то, что пришло с веб-хука.

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

Посмотчерез шаблон.

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

в

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

общей выгрузке.

Ответ сервиса (Response) при отправке webhook

После успешной отправки вебхука на сервис вы получите следующий ответ:

{
'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"false

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

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

Back to top