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://app.vortex.pro/api/sales/auto-collectors/webhook/add-sale
В параметрах запроса нужно указать уникальный ключ:
https://app.vortex.pro/api/sales/auto-collectors/webhook/add-sale?key=xxxxxxxxxxxxxxxx
Скопировать ссылку с ключом можно в параметрах веб-хука

В теле запроса можно указать следующие параметры:
        "telegram_id": 0,
        "username": "string",
        "purchase_price": 0,
        "purchase_name": "string",
        "purchased_at": "2024-04-25T19:33:32.539Z"
                            
где telegram_id - integer, телеграм айди покупателя (важное поле)
username - string, юзернейм покупателя (важное поле)
(!) В теле запроса обязательно должен присутствовать либо telegram_id, либо username
purchase_price - float, цена покупки (руб) (опциональное поле)
purchase_name - string, название покупки (опциональное поле)
purchased_at - datetime, время покупки (опциональное поле). Если отсутствует - проставится дата отправки настоящего запроса

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

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

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