Skip to main content

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

Это самый продвинутый вариант для автоматизации загрузки клиентов.

Благодаря этому, вы можете передавать клиентов разных сегментов вашей воронки с конструкторов ботов в Телеграм (Salebot / BotHelp) или даже напрямую из Геткурс с некоторыми нюансами, в случае, если ваша воронка Телеграм собрана на стандартном конструкторе геткурса.

Какие этапы? Например: зарегистрировался/ вошел в бот - прошел квалификацию - открыл лид магнит - купил трипваер - купил основной продукт.

1. Указать название связки «Веб-хука»

При выборе связки «Веб-хук» вам так же как и в других вариантах нужно указать название связки.

Откроется окно настройки вебхука.



2.Окно настройки и генерации WebHook

image.png



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

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

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

WebHook - может принимать запросы двух разных видов. POST и GET. В большинстве случаев при интеграции с ботами вы будете использовать POST запрос. Но так как GetCourse адекватно не дружит с POST запросами, здесь данные придется передавать через GET.

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


Для добавления продажи нужно отправить POST запрос на метод: 
https://proxy.vortex.pro/webhooks/sale

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

https://proxy.vortex.pro/webhooks/sale?key=xxxxxxxxxxxxxxxxxxxx

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

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

{
        "telegram_id": 0,
        "username": "string",
        "purchase_price": 0,
        "purchase_name": "string",
        "purchased_at": "2024-04-25T19:33:32.539Z" / "25.04.2024"
                            }
Особенность Параметр Описание
* обязательный telegram_id  integer (целое число), телеграм айди покупателя 
* обязательный username  string (строка) , телеграм юзернейм покупателя
Для отправки webhook нужно отправить либо telegram_id либо username  (хотя бы 1 из 2х параметров)
/опциональное purchase_price  float (число), цена конверсии
/опциональное purchase_name  string (строка), название конверсии
/опциональное purchased_at  !можно не указывать. Проставится время отправки webhook
datetime (дата и время), время совершения конверсии.
Если отсутствует - проставится дата отправки настоящего запроса
Значения для параметров цены и наименования можно задать по умолчанию. Если при заданных параметрах по умолчанию в веб-хуке будет содержаться другая цена и наименование - то внесены будут те, что пришли по веб-хуку.

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

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

Ответ (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
      }
 }

Ответ главным образом состоит из 2 частей: 

detail - Статус отправки вебхука. Здесь будет указано успешно был отправлен вебхук или произошла ошибка
data - Информация о конверсии, которая была добавлена а так же информация о клиенте, который фигурирует в конверсии.

!Можно отключить информативную часть ответа data   с помощью указания параметра запроса:

response_with_data=false

А весь запрос вместе с ключом может выглядеть следующим образом:

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

 

Back to top