Salebot + GetCourse + Vortex

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

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

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

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

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

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

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

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

Решение: использовать кастомное (пользовательское) название поля

Чтобы обойти эту проблему, рекомендуется переименовать поле, через которое передаётся Telegram ID, на уникальное (например, tgid).

Для этого необходимо внести изменения на всех этапах цепочки передачи данных:

1. Заголовок дополнительного поля GetCourse

2. CSS-класс элемента в форме, с помощью которой собираются Telegram ID

3. Переменная в скрипте для передачи telegram_id

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

5. В настройках Vortex: перейдите в Продажи ➡️ Прокси-ссылки ➡️ Откройте настройки ➡️ В поле «UTM-метка с Telegram_ID перешедшего» укажите новое имя

Протестируйте: 

1) Заполните форму, открыв сайт через MiniApp (прокси-ссылку).

2) Проверьте, записался ли Telegram ID в обновленное поле в GetCourse.

Если Telegram ID НЕ записался, то проблема может быть в скрипте. Проверьте, что скрипт написан верно.

3) Если Telegram ID записался, проверьте, отработал ли процесс и отправились ли данные по вебхуку.

Перейдите в Процессы ➡️ Выберите нужный процесс ➡️ Перейдите в задачи ➡️ Нажмите на ID нужной задачи ➡️ Разверните историю полностью ➡️ Проверьте ответ от сервера. Successfully added sale указывает на то, что конверсия была успешно передана в Vortex. В противном случае проверьте правильность ссылки.

4) Проверьте, добавилась ли конверсия в Vortex. Перейдите в Продажи ➡️ Выберите нужную группу клиентов ➡️ Перейдите в Клиенты ➡️ Проверьте, добавились ли новые конверсии.