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

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

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

Если вы используете наше более продвинутое решение с проксированием ссылок через MiniApp, то нужно действовать несколько иначе:

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>

Вы также можете передать telegram_id в дополнительное поле через лендинг на GetCourse — по аналогии со способом, реализованным через мини-приложение.

Для этого в GetCourse создайте дополнительное поле у пользователя (см. инструкцию «Вариант 1»). Затем в форму на лендинге добавьте «Поле пользователя», укажите CSS класс элемента (telegram_id и hidden) и вставьте в блок «HTML» следующий код:

<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>

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

Теперь, чтобы значение telegram_id записалось в дополнительное поле, необходимо выдать пользователю через бота ссылку типа https://[ваш_аккаунт].getcourse.ru/[ссылка_на_лендинг]?telegram_id=#{platform_id} или https://[ваш_домен]/[ссылка_на_лендинг]?telegram_id=#{platform_id}

Материал находится на редакции.

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

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

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

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

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

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

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. Наш процесс готов. Осталось его протестировать и запустить.