GetCourse
Подключение интеграции
На странице интеграций нажмите кнопку "Добавить интеграцию", затем выберите GetCourse
Для того, чтобы успешно заполнить поля, перейдите в вашем геткурсе на эту страницу: http://вашдомен/saas/account/api
На открывшейся странице нам нужны поля Account name и «Ваш секретный ключ». (фото ниже)
Если у вас нет ключа, нажмите на кнопку "Сгенерировать секретный ключ"
В форме интеграции в поле «Название аккаунта» укажите значение Account name. А в поле «Секретный ключ» укажите ваш секретный ключ.
В поле «Название» можно написать любое удобное название.
В GetCourse
Нужно добавить дополнительное поле для сохранения channel_id пользователя.
Вид поля: {channel}_uid
Примеры:
VK: vk_uid
Telegram: tg_uid
Instagram: ig_uid
Одноклассники: ok_uid
Объясню, если вы собрали бота для канала VK, то создавайте поле vk_uid. Если для Telegram: tg_uid. Вы можете добавить все поля сразу, чтобы потом о них не вспоминать.
Далее будем рассматривать на примере канала VK.
Выбираем тип поля «Строка» и в поле «Заголовок» пишем vk_uid. Остальные поля не обязательны к заполнению
На всякий случай инструкция по доп. полям от GetCourse тут — https://getcourse.ru/blog/276068
А у нас уже всё
Готово к работе!
Работа методов
ВНИМАНИЕ: поля email или телефон обязательны для заполнения.
Блок действий с интеграцией находится в Действие - Действия с интеграцией - выберите вашу интеграцию GetCourse
На данный момент доступно добавление пользователя и добавление заказа. Рассмотрим подробнее:
Добавление нового пользователя
Принцип работы: добавляет или перезаписывает (если уже имеется) информацию о пользователе — имя, фамилия, группы (в которые его нужно поместить), телефон, email.
Добавление нового заказа
Добавляет заказ и создает нового пользователя (или перезаписывает старое значение).
В примере показан типовой вариант использования. После успешного добавления мы получаем ссылку на оплату заказа.
Пример использования:
Здесь, в блоке сообщения вставлена переменная {%payment_link%}, она же "Ссылка на оплату". Добавить её можно, нажав на кнопку "Переменные" в блоке сообщения
Дополнительно
Добавление доп. полей
Во вкладке «Дополнительные настройки» можно указать несколько дополнительных полей пользователя и задать им значения.
На данный момент доступно полей под запись: 5 (channel_uid не считаем за доп. поле. Оно задается автоматически вне этой настройки)
Для того, чтобы верно указать значение для Вашего дополнительного поля, нужно правильно указать Заголовок из GetCourse
Примеры заголовков
Пример заполнения
Как получить информацию об оплаченном заказе из GetCourse
Нам нужно сделать так, чтобы GetCourse отправлял информацию
для этого нужно составить такую ссылку:
Для типа процесса "Заказы" и "Покупки":
https://smm.targethunter.ru/api/bots/addUser?channel=CHANNEL&bot_id=BOT_ID&uid={object.user.CHANNEL_UID}&api_key=API_KEY&payload[email]={object.user.email}&payload[phone]={object.user.phone}
Для типа процесса "Пользователи":
https://smm.targethunter.ru/api/bots/addUser?channel=CHANNEL&bot_id=BOT_ID&uid={object.CHANNEL_UID}&api_key=API_KEY&payload[email]={object.email}&payload[phone]={object.phone}
где:
API_KEY - ключ api вашего кабинета
BOT_ID - id бота, который нужно запускать после получения информации
CHANNEL_UID - замените на название поля, в котором сохранен id пользователя в соц. сети (например, которое вы указывали в самом начале интеграции)
CHANNEL - канал.
Далее на стороне GetCourse нужно создать процесс типа «Заказы».
Далее нужно выбрать нужный вариант проверки (если планируете постоянно получать уведомления об оплаченных заказах, то рекомендую «Периодическая проверка») и другие условия.
В процессе указываем блок операция — «Вызвать url». В поле url указываем нашу ссылку, которую создали чуть выше.
Пример
В настройках бота, ID которого вы указали в ссылке выше, должен быть включен пункт "Сохранять входные параметры". Туда будут попадать email и телефон пользователя (если они есть).
Всё. Таким образом вы будете автоматически получать информацию из GetCourse по вашим заказам.
Last updated
