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

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

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

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

Этап 1. Сохранение Telegram ID в дополнительное поле GetCourse

1.Вариант В1: воронка в Telegram построена в процессах на стандартном конструкторе GetCourse. 

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

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

2.Вариант 2: Ссайт упакован в MiniApp.MiniApp

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

1.

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

  
  




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

  В

  Камк настроить передачу Telegram ID в достп. поле GetCourse:

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

  Переходим в Ученики ➡️ Пользователи ➡️ Дополнительные поля

  

  

  Далее добавляем доп. поле:
  •    Тип – число
  •    Заголовок – telegram_id

  Сохраняем.

  

  Далее добавляем поле в форму на лендинге.

  Переходим в раздел Сайт ➡️ Страницы. В настройках формы добавляем «Поле пользователя». Обязательно указываем CSS класс элемента:
  •    telegram_id
  •    hidden – скрываем поле
  

  

  Добавляем блок «HTML». В него вставляем код:

  <script>
  function parseTelegramData() {
         if (window.Telegram?.WebApp?.initDataUnsafe?.user) {
          const user = window.Telegram.WebApp.initDataUnsafe.user;
          return {
              id: user.id || ''
          };
      }
       const hash = window.location.hash.substring(1);
      if (!hash) {
          return null;
      }
      const params = new URLSearchParams(hash);
      const tgWebAppData = params.get('tgWebAppData');
      if (!tgWebAppData) {
          return null;
      }
      try {
          const decodedData = decodeURIComponent(tgWebAppData);
          const tgParams = new URLSearchParams(decodedData);
          const userStr = tgParams.get('user');
          if (userStr) {
              const user = JSON.parse(userStr);
              return {
                  id: user.id || ''
              };
          }
      } catch (e) {
          console.error('Failed to parse tgWebAppData:', e);
      }
      return null;
  }
  const telegramData = parseTelegramData();
  if (telegramData) {
      const telegramIdWrappers = document.querySelectorAll('.telegram_id');
      telegramIdWrappers.forEach(function (wrapper) {
          const input = wrapper.querySelector('input');
          if (input) {
              input.value = telegramData.id;
          }
      });
  }
  </script>

  Сохраняем и опубликовываем страницу.

  Теперь при заполнении формы через MiniApp Telegram ID пользователя будет автоматически записываться в дополнительное поле.

  Настройка передачи Telegram ID в дополнительное поле заказа осуществляется аналогичным образом. Для этого перейдите в раздел Продажи ➡️ Список заказов ➡️ Дополнительные поля и создайте поле telegram_id. При создании поля в настройках формы выберите тип «Поле заказа» вместо «Поле пользователя» — данные из Telegram будут подставляться в указанное поле заказа.

  Вариант 3: связка GetCourse и Salebot

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

  Для этого в GetCourse создайте дополнительное поле у пользователя или у заказа (см. инструкцию выше). Затем в форму на лендинге добавиьть доп метку. В самой форме д«Побавить скрытоле доп. пользователя» (или «Поле заказа»), укажите 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>

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

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

  
  

ОВажно отмечутить, что способ с передачейа telegram_id через MiniApp самый— наиболее надеёжный способ,. При его использовании идентак ификатор Telegram фиксируется в такомGetCourse случае за 100% пользователей, оставивших заявку.
В фсравненики с этируетсям, tg_id в геткурсе.  Ппервый способ соприводитяжён кс потереями: от 2020% до 40% tg_id, пользоватак как просто даелекой не вспе преховаливаюдятся в тгTelegram бота насо страницеы благодарности после регистрации на бесплатник. 

• Теперь, когда вы решили вопрос с TG_ID,й продукт, и их telegram_id в сисхтему не попадиает.
  я с

  Этандартнаяп о2. Отправка GET запроса в VORTEX.
  
  VORTEX

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

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

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

  Где нажав найти кнопку копирования.

Процесс

Типо пользоватыелям:

https://app.vortex.pro/api/sales/auto-collectors/webhook/add-sale?key=1d80de0716ef4dfd86e18b8dc216444f&telegram_id={object.chat_ID}&username={object.Telegram}&purchase_price=123&purchase_name=тест

Процесс по заказам:

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

!Список типичных ошибоки при передаче данных:

 через вебхук