GetCourse
На странице интеграций нажмите кнопку "Добавить интеграцию", затем выберите GetCourse
Для того, чтобы успешно заполнить поля, перейдите в вашем геткурсе на эту страницу: http://вашдомен/saas/account/api
На открывшейся странице нам нужны поля Account name и «Ваш секретный ключ». (фото ниже)
Если у вас нет ключа, нажмите на кнопку "Сгенерировать секретный ключ"
В форме интеграции в поле «Название аккаунта» укажите значение Account name. А в поле «Секретный ключ» укажите ваш секретный ключ.
В поле «Название» можно написать любое удобное название.
Вид поля: {channel}_uid
Примеры:
VK: vk_uid
Telegram: tg_uid
MAX: max_uid
Одноклассники: ok_uid
Объясню, если вы собрали бота для канала VK, то создавайте поле vk_uid. Если для Telegram: tg_uid. Вы можете добавить все поля сразу, чтобы потом о них не вспоминать.
Далее будем рассматривать на примере канала VK.
Выбираем тип поля «Строка» и в поле «Заголовок» пишем vk_uid. Остальные поля не обязательны к заполнению
На всякий случай инструкция по доп. полям от GetCourse тут — https://getcourse.ru/blog/276068
А у нас уже всё
ВНИМАНИЕ: поля email или телефон обязательны для заполнения.
Блок действий с интеграцией находится в Действие - Действия с интеграцией - выберите вашу интеграцию GetCourse
На данный момент доступно добавление пользователя и добавление заказа. Рассмотрим подробнее:
Принцип работы: добавляет или перезаписывает (если уже имеется) информацию о пользователе — имя, фамилия, группы (в которые его нужно поместить), телефон, email.
Добавляет заказ и создает нового пользователя (или перезаписывает старое значение).
В примере показан типовой вариант использования. После успешного добавления мы получаем ссылку на оплату заказа.
Пример использования:
Здесь, в блоке сообщения вставлена переменная {%paymentlink%}, она же "Ссылка на оплату". Добавить её можно, нажав на кнопку "Переменные" в блоке сообщения
Добавление доп. полей
Во вкладке «Дополнительные настройки» можно указать несколько дополнительных полей пользователя и задать им значения.
На данный момент доступно полей под запись: 5 (channel_uid не считаем за доп. поле. Оно задается автоматически вне этой настройки)
Для того, чтобы верно указать значение для Вашего дополнительного поля, нужно правильно указать Заголовок из GetCourse
Примеры заголовков
Нам нужно сделать так, чтобы GetCourse отправлял информацию
для этого нужно составить такую ссылку:
Для типа процесса "Заказы" и "Покупки":
https://bot.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://bot.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 - канал.
Далее нужно выбрать нужный вариант проверки (если планируете постоянно получать уведомления об оплаченных заказах, то рекомендую «Периодическая проверка») и другие условия.
В процессе указываем блок операция — « Вызвать url».
В поле url указываем нашу ссылку, которую создали чуть выше.
Пример
В настройках бота, ID которого вы указали в ссылке выше, должен быть включен пункт "Сохранять входные параметры". Туда будут попадать email и телефон пользователя (если они есть).