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

Для проектов, в которых воронки в Telegram построены на стандартном конструкторе GetCourse, данные о пользователях можно передавать GET запросами прямо из GetCource.

ВАЖНО! Чтобы вы могли создать процесс в GetCource и передать telegram_id через веб-хук, сначала необходимо научить GetCource записывать telegram_id каждого пользователя в дополнительное поле.

GetCource по умолчанию этого делать НЕ умеет.

Этап 1. Сохранение 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 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>

<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 через мини-приложение (вариант 2) — наиболее надёжный способ. При его использовании идентификатор Telegram фиксируется в GetCourse у 100% пользователей, оставивших заявку.
В сравнении с этим, остальные способы сопряжены с потерями: от 20% до 40% пользователей не переходят в Telegram-бота со страницы благодарности после регистрации на бесплатный продукт, и их telegram_id в систему не попадает.

Этап 2. Передача заказа в Vortex

Отправка и пример корректного GET запроса из GetCourse в Vortex.

1. Получение ссылки для отправки GET запроса в сервисе. 

Ключ веб-хука можно скопировать прямо в сервисе.

Для отправки веб-хука из GetCourse в VORTEX необходимо создать процесс. Процесс может быть как по заказам, так и по пользователям. Исходя из типа объекта, переменные в ссылке будут отличаться.

Если процесс по пользователям:

Используется переменная object
Пример ссылки:
https://proxy.vortex.pro/webhooks/sale?key=a1234b5c6789012d34e56789f01g2345?telegram_id={object.telegram_ID}&purchase_prise=1234&purchase_name=тест

Если процесс по заказам:

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

Описание параметров, которые можно передать в ссылке:

Пример ссылки для передачи GET запроса с данными о КОНВЕРСИИ из процесса GetCource, в которой передаётся Telegram ID, цена и название конверсии:

https://app.vortex.pro/api/sales/auto-collectors/webhook/add-sale?key=API_KEY&telegram_id={object.user.TG_ID}&purchase_name={object.positions}&purchase_price={object.cost_money_value}

Обратите внимание:

1. Ссылка для запроса с необходимым ключом копируется напрямую из нашего сервиса — вносить в неё изменения не требуется. API_KEY — это уникальный ключ, сгенерированный Vortex.
2. &telegram_id={object.user.TG_ID}
Вместо TG_ID подставьте название переменной (по умолчанию telegram_id), которую вы указали в дополнительном поле заказа для передачи telegram_id. Это обязательный параметр запроса — без него сервис не сможет корректно добавить конверсию.
3. &purchase_name={object.positions}
positions — стандартное поле в GetCourse, содержащее название конверсии. Этот параметр является необязательным. Если вы не планируете передавать наименование конверсии, просто удалите его из запроса.
4. &purchase_price={object.cost_money_value}
cost_money_value — стандартное поле в GetCourse, в котором указывается сумма, оплаченная клиентом в рамках конверсии. Этот параметр является необязательным. Если передача суммы не требуется, вы можете удалить его из запроса.

2. Отправка GET запроса из GetCourse в VORTEX через процесс.

Подробная инструкция как отправлять запросы содержится в документации GetCourse. 

Процесс может быть по пользователям или по заказам. Сделаем на примере заказа.

Для начала создадим процесс. Перейдем в раздел CRM ➡️ Процессы.

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

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

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

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

Как проверить успешность отправки вебхука на сервис:

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

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

Ответ состоит в основном из двух частей:

• detail — статус отправки вебхука. Указывает, была ли отправка успешной или произошла ошибка.
• data — информация о добавленной конверсии, а также данные о клиенте, связанном с этой конверсией.
  

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

В этом случае вы получите только информацию detail со статусом.

Видео-объяснение с примером:

Типовые ошибки при передаче данных через вебхук

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

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

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

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

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

6. Не включена опция «Выполнять действия по настоящему» в GetCourse
Эта галочка обязательна для активации реальной обработки вебхука. Если она не установлена, действия не будут выполняться, даже если запрос технически успешен.