GetCourse – Как загружать клиентов через Webhook

Если ваша воронка в Telegram собрана в GetCourse, вы можете «вытащить» telegram_id прямо из системы.

Недавно появилась официальное расширение от GetCourse, которое позволяет автоматически сохранять user_id и username в дополнительные поля. Это удобное и проверенное решение стоит всего 500 рублей в месяц. 

Если вы используете наше более продвинутое решение с проксированием ссылок через MiniApp, то нужно действовать несколько иначе. В Vortex реализована технология автоматической передачи Telegram ID в UTM-метку при переходе пользователя по ссылке. Вам остаётся лишь передать значение в дополнительное поле пользователя в GetCourse — для дальнейшей интеграции с Vortex.

1. При настройках прокси-ссылки (MiniApp) необходимо указать передачу сервисных UTM-меток.

Метка telegram_id по умолчанию включается при установке соответствующей галочки – её значение будет подставляться динамически.
Кроме telegram_id, в UTM-метках можно передавать и другие служебные параметры: username, ФИО пользователя, наличие Telegram Premium. Если в вашей системе уже используется поле для сбора Telegram ID (например, tg_id, telegram, user_id и другие), просто укажите его название в соответствующее поле.

2. Далее необходимо записать telegram_id из UTM-метки в дополнительное поле GetCourse. Для большинства технических специалистов эта задача является стандартной и несложной. Во многих образовательных проектах уже используется скрипт, автоматически сохраняющий UTM-метки в дополнительные поля пользователя.

<script>
function getParam(name) {
  const params = new URLSearchParams(window.location.search);
  return params.get(name) || '';
}
document.addEventListener('DOMContentLoaded', function () {
  const telegramId = getParam('telegram_id');
  const wrappers = document.querySelectorAll('.telegram_id');
  wrappers.forEach(function (wrapper) {
    const input = wrapper.querySelector('input');
    if (input) input.value = telegramId;
  });
});
</script>

<script type="text/javascript" src="https://app.vortex.pro/static/webapp_integration.js"></script>

Видео-инструкция

Как работать с прокси-ссылками

Если ваша воронка построена на Salebot, вы можете динамически передать telegram_id в дополнительное поле пользователя GetCourse. Для этого необходимо выполнить следующие шаги:

1. Настроить интеграцию Salebot и GetCourse

Как настроить интеграцию Salebot и GetCourse

2. Получить прокси-ссылку на Telegram для запуска воронки в Telegram-боте

3. Далее нужно связать пользователя Salebot с пользователем GetCourse. Для этого передадим email пользователя GetCourse в Salebot.

Добавим в полученную ссылку переменную email:

Пример ссылки:
https://sbsite.pro//ab123a12aa1a1a1a1ab12345a1ab1a12_1?email={email}

Именно эту ссылку необходимо вставить на страницу благодарности.

Так как в кнопке переменные пользователя не подставляются, ссылку можно «вшить» в текст и поставить галочку «Заменять переменные пользователя».

Если вы хотите использовать именно кнопку, можно создать форму с единственным полем – email, и скрыть это поле с помощью CSS-класса hidden.

В обработчике формы указать переадресацию на прокси-ссылку на Telegram-бот с переменной email и поставить галочку «Заменять переменные в URL».

При переходе по ссылке – вшитой в текст или через кнопку – в Salebot будет передан email пользователя.

4. Теперь необходимо передать telegram_id из Salebot в дополнительное поле пользователя GetCourse.

Для этого сначала нужно создать дополнительное поле пользователя на стороне GetCourse.

После этого можно реализовать передачу Telegram ID.

Это делается с помощью функций в так называемом «Калькуляторе» в Salebot.
Калькулятор – это поле в редакторе блока, где можно выполнять логические и арифметические действия, а также вызывать API-запросы к конструктору и подключённым интеграциям.

Добавим в первый блок воронки функцию. В поле «Калькулятора» вставим следующее:

result=getcourse_add_user(1, email, '', '', '{"addfields":{"telegram_id": #{platform_id}}}')

Сохраняем.

5. Остаётся только протестировать процесс, пройдя по пути клиента. При успешном выполнении функция возвращает True, а в переменную сделки getcourse_user в Salebot записывается ответ сервера:

Если произошла ошибка (например, в GetCourse нет активной подписки), в переменную result запишется сообщение об ошибке:
This method in Getcourse only works on paid Getcourse plans. During the test period - no.

Если ваша воронка построена таким образом, что пользовтель переходит из бота на сайт с формой, а не наоборот, то вы также можете передать telegram_id в дополнительное поле пользователя GetCourse через лендинг – по аналогии со способом, реализованным через мини-приложение.

<script>
function getParam(name) {
    const params = new URLSearchParams(window.location.search);
    return params.get(name) || '';
}
document.addEventListener('DOMContentLoaded', function () {
    const telegramId = getParam('telegram_id');
    const telegramWrappers = document.querySelectorAll('.telegram_id');
    telegramWrappers.forEach(function (wrapper) {
        const input = wrapper.querySelector('input');
        if (input) {
            input.value = telegramId;
        }
    });
});
</script>

Видео-инструкция

Как настроить интеграцию Salebot и GetCourse

Подробнее о группах конверсий вы можете прочитать в этой статье.

1. Перейдите в Продажи ➡️ Управление конверсиями. Укажите название группы и нажмите «Создать»

2. Добавьте вебхук в качестве источника, нажав на значок «+» в столбце «Действия». Укажите название связки и нажмите «Добавить». 

3. Перед вами откроется окно настройки вебхука. Здесь вы можете скопировать или перегенерировать ключ, а также указать название и сумму покупки по умолчанию. Если при передаче заказа не будут переданы название и сумма, в Vortex автоматически подставятся значения по умолчанию. Таким образом, приоритет всегда отдается данным, переданным через вебхук.

Вы также можете установить часовой пояс в настройках.

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

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

Пример ссылки, в которой передаются Telegram ID пользователя, стоимость, название и UTM-метки заказа: 
https://proxy.vortex.pro/webhooks/sale?key=a1234b5c6789012d34e56789f01g2345?telegram_id={object.user.telegram_id}&purchase_priсe={object.cost_money_value}&purchase_name={object.positions}&utm_source={object.create_session.utm_source}&utm_medium={object.create_session.utm_medium}&utm_campaign={object.create_session.utm_campaign}&utm_content={object.create_session.utm_content}&utm_term={object.create_session.utm_term}

1. Ключ вебхука. Ссылка для запроса с необходимым ключом копируется напрямую из нашего сервиса – вносить в неё изменения не требуется. При успешном копировании у вас всплывёт уведомление «Ключ веб-хука скопирован».

2. Переменные. Так как мы передаем в Vortex данные заказа, то и процесс нужно выстраивать по заказам. При этом в процессах по заказам используются переменные по:

• заказу,
• пользователю, которому принадлежит заказ.

Чтобы использовать переменные по заказу, нужно добавить к ним приставку object. Таким образом мы можем передать состав заказа (название предложения), его стоимость, дату создания/оплаты, UTM-метки.
Пример: {object.cost_money_value} – стоимость заказа.

Чтобы в процессе по заказу использовать переменные по пользователю, нужно добавить приставки object и user. Так как мы записываем telegram_id в дополнительное поле пользователя, то и используем переменную по пользователю. Пример: {object.user.telegram_id}

Важно!
Если вы используете собственное обозначение для Telegram ID (например, chat_id, tg_id и т.п.), убедитесь, что именно это значение передаётся в переменной. 
Критически важно, чтобы название дополнительного поля в GetCourse, UTM-метка с Telegram_ID перешедшего в Vortex (при использовании MiniApp) и переменная в ссылке были полностью идентичны.

Это обязательный параметр запроса – без него сервис не сможет корректно добавить конверсию.

Подробные инструкции:

• Как настроить вебхук в GetCourse
• Как правильно использовать переменные в процессе

Процессы в GetCourse бывают разного типа. Нам необходим процесс по заказам.

1. Перейдем в раздел «CRM» ➡️ «Процессы»

2. Создадим новый процесс с типом объекта «Заказы»

3. В настройках выберите пункт «Периодическая проверка» и укажите правило вхождения объекта — то есть конкретное предложение или тип заказа, который нужно передавать в Vortex. В нашем примере — это бесплатный тестовый заказ.

На этом этапе вы также можете задать дополнительные параметры заказа: его статус (оплачен/не оплачен), дату создания и другие необходимые данные.

4. Сохраняем и переходим во вкладку «Процесс». Добавляем блок «Операция» ➡️ «Заказ» ➡️ «Вызвать url»

5. Здесь мы используем GET-запрос и в поле «URL» вставляем ту ссылку, которую мы получили на предыдущем этапе. Сохраняем.

6. Добавляем блок «Завершение процесса» и соединяем

7. Наш процесс готов. Осталось его протестировать и запустить.

Шаг 1. Настройка интеграции между GetCourse и BotHelp

Прежде всего, необходимо подключить интеграцию GetCourse и BotHelp. Подробная инструкция доступна здесь:
https://help.bothelp.io/integracziya-s-getcourse/

Шаг 2. Связывание подписчика BotHelp с пользователем GetCourse

Для корректной работы интеграции важно, чтобы система понимала, кто есть кто. Для этого нужно связать профиль пользователя в GetCourse с подписчиком в BotHelp.

Ключевым элементом связи является уникальный ID подписчика в BotHelp – CUID (или CUser ID). Его необходимо передать в GetCourse и сохранить в пользовательском поле bothelp_id.

Как это сделать – подробно описано в статье:
https://help.bothelp.io/integracziya-s-getcourse-na-storonnih-konstruktorah-sajtov/

После того как вы настроили передачу CUID через ссылку и создали скрытое поле bothelp_id в форме GetCourse, можно переходить к следующему шагу.

Шаг 3. Создание пользовательских полей в BotHelp

Теперь нужно подготовить поля в BotHelp, куда будут записываться данные о заказе.

Перейдите в раздел «Настройки» ➡️ «Настраиваемые поля»

Создайте три новых текстовых поля:

• purchase_name – для названия заказа
• purchase_price – для стоимости заказа
• purchase_at – для даты и времени создания или оплаты заказа

Шаг 4. Настройка процесса в GetCourse

В GetCourse создайте новый процесс по заказам. 

Правило вхождения объекта: выберите «Периодическая проверка» и укажите нужное предложение, по которому должны фиксироваться заказы. Если хотите передавать только оплаченные заказы, то укажите через оператор «И» условие «Оплачен».

Так как данные передаются в пользовательские поля BotHelp, а не в системные, а вебхук позволяет отправить только одно поле за раз, потребуется создать три отдельных вебхука – по одному для каждого параметра. Плюс четвёртый вебхук для запуска бота и передачи данных в Vortex.

Важно!

{Ваш домен в Bothelp} = название кабинета Bothelp
{Ваш SecretKey из кабинета BotHelp} = Ключ BotHelp SecretKey в разделе «Настройки», «Интеграции», блок с GetCourse

Значения переменных записываются без скобок { }.
Данные переменные будут использоваться в вебхуках.

Вебхук 1. Передача названия заказа

Добавьте блок «Операция» ➡️ «Вызов URL». Метод – POST.

Вставьте ссылку, заменив выделенные переменные на свои:

https://gc.bothelp.io/callback?domain_name={Ваш домен в Bothelp}&token={Ваш SecretKey из кабинета BotHelp}&idBotHelp={object.user.bothelp_id}&actions[set_field]=purchase_name&actions[set_field_value]={object.positions}

Пример готовой ссылки:
https://gc.bothelp.io/callback?domain_name=testosh&token=aad03d44cbd13a57770d4344e56bb227e3f7bebe268c7fb9ag7f329948371438&idBotHelp={object.user.bothelp_id}&actions[set_field]=purchase_name&actions[set_field_value]={object.positions}

Вебхук 2. Передача стоимости заказа

Добавьте еще один блок «Операция» ➡️ «Вызов URL». Метод – POST.

Вставьте ссылку, заменив выделенные переменные на свои:

https://gc.bothelp.io/callback?domain_name={Ваш домен в Bothelp}&token={Ваш SecretKey из кабинета BotHelp}&idBotHelp={object.user.bothelp_id}&actions[set_field]=purchase_price&actions[set_field_value]={object.cost_money_value}

Пример готовой ссылки:
https://gc.bothelp.io/callback?domain_name=testosh&token=aad03d44cbd13a57770d4344e56bb227e3f7bebe268c7fb9ag7f329948371438&idBotHelp={object.user.bothelp_id}&actions[set_field]=purchase_price&actions[set_field_value]={object.cost_money_value}

Вебхук 3. Передача даты и времени создания или оплаты заказа

Добавьте третий вебхук (блок «Операция» ➡️ «Вызов URL». Метод – POST). Вы можете выбрать передачу времени создания заказа или времени его оплаты.
Замените выделенные переменные на свои.

Вариант А. Время создания заказа:

https://gc.bothelp.io/callback?domain_name={Ваш домен в Bothelp}&token={Ваш SecretKey из кабинета BotHelp}&idBotHelp={object.user.bothelp_id}&actions[set_field]=purchase_at&actions[set_field_value]={object.created_at format='d.m.Y H:i'}

Вариант Б. Время оплаты заказа:

https://gc.bothelp.io/callback?domain_name={Ваш домен в Bothelp}&token={Ваш SecretKey из кабинета BotHelp}&idBotHelp={object.user.bothelp_id}&actions[set_field]=purchase_at&actions[set_field_value]={object.payed_at format='d.m.Y H:i'}

Пример (время создания):
https://gc.bothelp.io/callback?domain_name=testosh&token=aad03d44cbd13a57770d4344e56bb227e3f7bebe268c7fb9ag7f329948371438&idBotHelp={object.user.bothelp_id}&actions[set_field]=purchase_at&actions[set_field_value]={object.created_at format='d.m.Y H:i'}

Вебхук 4. Запуск бота и передача данных в Vortex

Этот шаг нужен, чтобы активировать бота и отправить данные в Vortex.

Подготовка:

1. В Vortex создайте новую группу конверсий и выберите в качестве источника – вебхук. Скопируйте предоставленный вебхук ➡️ Инструкция

2. В BotHelp создайте нового бота. Добавьте блок «Действия» ➡️ «Отправить данные подписчика через Webhook» и вставьте скопированный из Vortex вебхук.

3. Перейдите в настройки бота:

• Нажмите на значок шестерёнки ➡️ «Настройки»

• Раскройте «Дополнительные настройки»
• Найдите поле «Ref бота» и скопируйте его значение

Настройка вебхука в GetCourse:

Добавьте блок «Операция» ➡️ «Вызов URL». Метод – POST.

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

https://gc.bothelp.io/callback?domain_name={Ваш домен в Bothelp}&token={Ваш SecretKey из кабинета BotHelp}&idBotHelp={object.user.bothelp_id}&actions[run_bot]={Ref вашего бота}

Пример готовой ссылки:
https://gc.bothelp.io/callback?domain_name=testosh&token=aad03d44cbd13a57770d4344e56bb227e3f7bebe268c7fb9ag7f329948371438&idBotHelp={object.user.bothelp_id}&actions[run_bot]=c1757845236982

Соедините блоки и запустите процесс.

Готово! Осталось только протестировать.

1. Отправьте себе через бота ссылку на лендинг (через который передается bothelp_id) с параметром sid={%cuid%}
Например: https://test.getcourse.ru/page27?sid={%cuid%}
В обработчике формы должно быть указано создание заказа (по предложению, которое вы выбрали в качестве условия запуска процесса)

2. Перейдите по ссылке и заполните форму. Убедитесь, что в GetCourse поле bothelp_id заполнилось значением поля CUser ID.

3. После обработки заказа процесс автоматически сработает.

4. Через некоторое время вы увидите нового пользователя в списке конверсий Vortex, с указанием:

• Названия заказа
• Даты и времени
• Стоимости (если заказ платный) 

В параметрах вебхука указано имя поля с ошибками – например, содержатся пробелы, точки или другие недопустимые символы. Убедитесь, что имя поля соответствует формату, ожидаемому системой (латиница, без пробелов и специальных символов). 

Попытка отправить тестовую конверсию без указания telegram_id или username. Для корректной обработки необходимо передавать хотя бы один из этих идентификаторов.

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

GetCourse может некорректно интерпретировать данные, если тип поля (текстовое/числовое) не совпадает с передаваемым значением. Например, telegram_id лучше указывать как числовое поле. При настройке рекомендуется проверить и при необходимости изменить тип поля.

Иногда одно из полей передаётся как строка «0», что может интерпретироваться как пустое или некорректное значение.
Рекомендация: начните с минимального набора параметров (например, только telegram_id), а затем постепенно добавляйте остальные, чтобы выявить проблемное поле.

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