---
title: "Интеграция GetCourse: пользователи, сделки и группы обучения"
nav_title: "GetCourse"
url: https://docs.tuk-tuk.online/integrations/getcourse
markdown: https://docs.tuk-tuk.online/integrations/getcourse.md
section: "Интеграции"
description: "Как подключить GetCourse к tuk-tuk.online по API Secret Key: выгрузка пользователей, сделок и групп, создание пользователей и заказов из мессенджеров, асинхронный экспорт с опросом статуса."
keywords: ["GetCourse интеграция", "GetCourse API", "GetCourse Telegram бот", "GetCourse подключить", "GetCourse вебхук", "онлайн-курсы автоматизация", "GetCourse пользователи", "GetCourse сделки", "инфобизнес автоматизация"]
lang: ru
product: tuk-tuk.online
app: https://lk.tuk-tuk.online
api_base: https://back.tuk-tuk.online
---

> [!AI] Кратко
> Интеграция GetCourse подключается по имени аккаунта и API Secret Key: выгрузка пользователей, сделок и групп обучения, создание пользователей и сделок из мессенджеров и AI-ассистентов.
>
> - Где: «Интеграции» → GetCourse → «Подключить»; поля «Имя аккаунта» (поддомен без .getcourse.ru) и «API Secret Key».
> - Предусловие: тариф GetCourse с доступом к API, секретный ключ из «Настройки» → «Профиль» → «API».
> - API: POST https://{аккаунт}.getcourse.ru/pl/api/{путь}, тело application/x-www-form-urlencoded (key, action, params).
> - Экспорт асинхронный: account/users, account/deals, account/groups, опрос account/exports/{id} каждые 5 с, до 6 попыток (30 с).
> - Создание: users add с refresh_if_exists=1 (email, имя, фамилия, телефон, группа); deals add с offer_code, deal_cost, deal_comment, addToGroup.
> - Одна интеграция = один аккаунт GetCourse.
>
> Связанные страницы: https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/ai/lead-converter, https://docs.tuk-tuk.online/chains/blocks/webhook, https://docs.tuk-tuk.online/integrations/webhooks, https://docs.tuk-tuk.online/dialogs/import-export

# Интеграция GetCourse

Интеграция связывает школу на GetCourse с мессенджерами. Человек пишет боту «хочу на курс», AI-ассистент проверяет группы обучения в GetCourse и создаёт пользователя и заказ по коду предложения, без ручной регистрации.

Подключение требует только имя аккаунта и секретный ключ API.

## Что синхронизируется

| Данные GetCourse | Чтение | Запись |
|---|---|---|
| Пользователи | Выгрузка списка, поиск по email и имени | Создание или обновление пользователя: email, имя, фамилия, телефон, группа |
| Сделки (заказы) | Выгрузка списка | Создание сделки: email пользователя, код предложения, стоимость, комментарий, добавление в группу |
| Группы обучения | Выгрузка списка групп, курсов и потоков | Нет |

## Что нужно на стороне GetCourse

- Тариф GetCourse с доступом к API.
- Секретный ключ API из настроек аккаунта.
- Имя аккаунта (поддомен), например `myschool` из `myschool.getcourse.ru`.

## Как подключить


![Подключение GetCourse](https://docs.tuk-tuk.online/assets/screens/integrations/getcourse.webp)

1. Имя аккаунта GetCourse.
2. API Secret Key.
3. Кнопка подключения.

1. Откройте GetCourse → «Настройки» → «Профиль» → «API» и скопируйте секретный ключ (Secret Key).
2. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите GetCourse и нажмите «Подключить»: появится форма с двумя полями.
3. В поле «Имя аккаунта» введите поддомен без `.getcourse.ru`, в поле «API Secret Key» вставьте ключ.
4. Нажмите «Подключить»: платформа запросит выгрузку пользователей и при успехе отметит карточку «Интеграция подключена».

> [!WARNING] Секретный ключ даёт доступ ко всем данным аккаунта GetCourse. Не пересылайте его в чатах и не храните в открытых документах.

## Проверить, что работает

1. Нажмите «Управлять» и откройте страницу GetCourse в кабинете: во вкладке пользователей появится список из GetCourse (выгрузка занимает 5–30 секунд).
2. Найдите пользователя по email через поле «Поиск по email»: карточка найдётся.
3. Создайте тестового пользователя в форме (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 отдаёт списки асинхронно: мгновенной выдачи нет, потому что в аккаунте могут быть тысячи пользователей.

1. Платформа отправляет запрос на экспорт и получает `export_id`.
2. Каждые 5 секунд платформа опрашивает `account/exports/{export_id}`.
3. Когда статус становится `exported`, платформа забирает данные. Максимум 6 попыток, то есть до 30 секунд ожидания.

```text
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 |