Интеграция связывает школу на GetCourse с мессенджерами. Человек пишет боту «хочу на курс», AI-ассистент проверяет группы обучения в GetCourse и создаёт пользователя и заказ по коду предложения, без ручной регистрации.
Подключение требует только имя аккаунта и секретный ключ API.
#Что синхронизируется
| Данные GetCourse | Чтение | Запись |
|---|---|---|
| Пользователи | Выгрузка списка, поиск по email и имени | Создание или обновление пользователя: email, имя, фамилия, телефон, группа |
| Сделки (заказы) | Выгрузка списка | Создание сделки: email пользователя, код предложения, стоимость, комментарий, добавление в группу |
| Группы обучения | Выгрузка списка групп, курсов и потоков | Нет |
#Что нужно на стороне GetCourse
- Тариф GetCourse с доступом к API.
- Секретный ключ API из настроек аккаунта.
- Имя аккаунта (поддомен), например
myschoolизmyschool.getcourse.ru.
#Как подключить
Имя аккаунта GetCourse.
API Secret Key.
Кнопка подключения.
Откройте GetCourse → «Настройки» → «Профиль» → «API» и скопируйте секретный ключ (Secret Key).
Откройте раздел Интеграции, выберите GetCourse и нажмите «Подключить»: появится форма с двумя полями.
В поле «Имя аккаунта» введите поддомен без
.getcourse.ru, в поле «API Secret Key» вставьте ключ.Нажмите «Подключить»: платформа запросит выгрузку пользователей и при успехе отметит карточку «Интеграция подключена».
#Проверить, что работает
- Нажмите «Управлять» и откройте страницу GetCourse в кабинете: во вкладке пользователей появится список из GetCourse (выгрузка занимает 5–30 секунд).
- Найдите пользователя по email через поле «Поиск по email»: карточка найдётся.
- Создайте тестового пользователя в форме (email, имя, фамилия, телефон, группа): он появится в GetCourse, а если email уже есть, данные обновятся.
#Что происходит после подключения
| Действие | Вызов GetCourse |
|---|---|
| Выгрузка пользователей | POST /pl/api/account/users, затем опрос account/exports/{id} |
| Выгрузка сделок | POST /pl/api/account/deals, затем опрос экспорта |
| Выгрузка групп | POST /pl/api/account/groups, затем опрос экспорта |
| Создание пользователя | POST /pl/api/users с action=add и refresh_if_exists=1 |
| Создание сделки | POST /pl/api/deals с action=add, offer_code, deal_cost, deal_comment, addToGroup |
#Как устроен экспорт
GetCourse отдаёт списки асинхронно: мгновенной выдачи нет, потому что в аккаунте могут быть тысячи пользователей.
- Платформа отправляет запрос на экспорт и получает
export_id. - Каждые 5 секунд платформа опрашивает
account/exports/{export_id}. - Когда статус становится
exported, платформа забирает данные. Максимум 6 попыток, то есть до 30 секунд ожидания.
tuk-tuk.online -> POST https://myschool.getcourse.ru/pl/api/account/users (запуск экспорта, ответ: export_id)
tuk-tuk.online -> POST https://myschool.getcourse.ru/pl/api/account/exports/{export_id} (опрос статуса, каждые 5 с)
tuk-tuk.online <- JSON с данными (status: exported)#Ограничения
- API GetCourse принимает только
POSTс теломapplication/x-www-form-urlencoded: поляkey,action,params(JSON-строка). - Экспорт списка занимает до 30 секунд (6 опросов по 5 секунд); при превышении возвращается пустой список.
- Один ключ = один аккаунт GetCourse; одна интеграция = один аккаунт.
- Пользователь с существующим email обновляется, а не дублируется (
refresh_if_exists=1).
#Частые проблемы
| Проблема | Что делать |
|---|---|
| Нет доступа к API | Проверьте, что API включён в настройках GetCourse и тариф его поддерживает |
| Ошибка экспорта | Сверьте имя аккаунта: только поддомен, без https:// и .getcourse.ru |
| Пользователь не создаётся | Убедитесь, что указан email, а ключ выдан для аккаунта с правом записи |
| Экспорт вернул пустой список | GetCourse не успел подготовить выгрузку за 30 секунд: повторите запрос |
| Сделка создаётся без предложения | Укажите действующий код предложения (offer_code) из GetCourse |