Документация / Интеграция с LMS-сервисами / Интеграция с Skillspace

Интеграция с Skillspace

skillspaceскилспэйс
Содержание

Для чего нужна интеграция

Вместо ручного добавления каждого ученика на курс, система делает это сама при наступлении нужного события: оплата, регистрация, завершение вебинара и т.д.

Что можно автоматизировать:

  • Выдача доступа к курсу — ученик оплатил → автоматически получил доступ к курсу и группе.
  • Обновление данных — изменились данные ученика → они обновятся в SkillSpace.
  • Отзыв доступа — возврат оплаты или окончание подписки → ученик удаляется с курса.

Подключение SkillSpace

1 Перейдите в раздел добавления сервиса

В Vakas-tools перейдите в Сервисы → Добавить сервис → SkillSpace.

2 Укажите название подключения

Укажите Название подключения (произвольное).

3 Введите домен

Введите Домен — полный URL вашей школы, обязательно с https://. Например: https://myschool.skillspace.ru.

4 Введите API-ключ

Введите API-ключ.

5 Сохраните подключение

Нажмите «Добавить сервис».

Где взять API-ключ: в SkillSpace перейдите в Настройки школы → API (/school/settings/api). Скопируйте ключ.

Важно: домен обязательно указывать с https://. Без протокола подключение не будет работать.

После успешного подключения сервис появится в списке и станут доступны триггеры. И в базах уже добавьте сервис именно к базе с помощью кнопки [+Сервис].

Подключение SkillSpace
Добавление сервиса SkillSpace к базе

Добавить правило

Правила настраиваются одинаково для всех сервисов. Подробная инструкция по созданию правил и настройке условий описана в отдельном разделе.

В рамках интеграции с SkillSpace отличаются только доступные действия, которые выполняются при срабатывании правила.

Добавить правило
Настройка правила

Настройка действий триггера

Передача данных в SkillSpace настраивается через действия триггера. Нажмите кнопку «Действия» напротив нужного триггера — откроется конструктор действий.

Настройка действий триггера

Доступные действия:

Действие Описание
Добавить ученика на курс Приглашает ученика на один или несколько курсов с указанием группы.
Обновление ученика Обновляет данные существующего ученика (имя, email, комментарий).
Удаление ученика с курса Удаляет (отзывает) ученика с указанного курса.

Добавление ученика на курс

Цель: при оплате, регистрации или другом событии автоматически добавить ученика на курс в SkillSpace.

Добавление ученика на курс

1 Создайте триггер

  1. Создайте триггер с нужным условием (например, по событию оплаты или регистрации).
  2. Нажмите «Действия» напротив триггера.

2 Добавьте действие «Добавить ученика на курс»

Нажмите «Добавить действие» → Добавить ученика на курс. Заполните поля:

3 Сохраните настройки

Нажмите «Сохранить». Теперь при срабатывании триггера ученик будет добавлен на указанные курсы в SkillSpace.

Поле Описание Пример
Email Email ученика. Поддерживает шорткоды. {#email#}
Имя Имя ученика. Поддерживает шорткоды. {#name#}
Комментарий Произвольный комментарий к приглашению. Поддерживает шорткоды. Оплата тарифа {#positions#}
Курс — Группа Левая колонка: ID курса. Правая колонка: ID группы. Можно добавить несколько строк. 12345 — 67890

Нажмите иконку {--} рядом с полем, чтобы увидеть список доступных шорткодов.

Как работает:

  1. Система формирует приглашение с указанными данными.
  2. Для каждой пары «Курс — Группа» ученик добавляется на соответствующий курс.
  3. Если группа не указана — ученик добавляется на курс без группы.

Важно: ID курсов и групп можно найти в интерфейсе SkillSpace в настройках курса.

Обновление данных ученика

Цель: обновить имя, комментарий или другие данные существующего ученика в SkillSpace.

Обновление данных ученика

1 Добавьте действие «Обновление ученика»

Нажмите «Добавить действие» → Обновление ученика. Заполните поля:

2 Сохраните настройки

Нажмите «Сохранить».

Поле Описание Пример
Email Email ученика (для поиска). Поддерживает шорткоды. {#email#}
Имя Новое имя ученика. Поддерживает шорткоды. {#name#}
Комментарий Комментарий. Поддерживает шорткоды. Обновлено после вебинара {#webinarId#}

Как работает:

  1. Система находит ученика в SkillSpace по email.
  2. Обновляет указанные поля. Пустые поля пропускаются — старые данные сохраняются.

Важно: email является идентификатором ученика. Если ученик с таким email не найден — обновление не произойдёт.

Удаление ученика с курса

Цель: отозвать доступ ученика к курсу — например, при возврате оплаты или завершении подписки.

Удаление ученика с курса

1 Добавьте действие «Удаление ученика с курса»

Нажмите «Добавить действие» → Удаление ученика с курса. Заполните поля:

2 Сохраните настройки

Нажмите «Сохранить».

Поле Описание Пример
Email Email ученика. Поддерживает шорткоды. {#email#}
Курс ID курса, с которого нужно удалить ученика. Поддерживает шорткоды. 12345

Как работает:

  1. Система находит ученика по email.
  2. Удаляет его с указанного курса.

Важно: email должен совпадать с зарегистрированным в SkillSpace. Ученик должен быть записан на указанный курс.

Типичные сценарии настройки

Сценарий 1. Оплата → добавление на курс

Добавьте в триггер одно действие:

  1. Добавить ученика на курс — email: {#email#}, имя: {#name#}, курс: 12345, группа: 67890.

Сценарий 2. Оплата → добавление на несколько курсов

Добавьте в триггер одно действие:

  1. Добавить ученика на курс — email: {#email#}, имя: {#name#}, несколько строк в поле «Курс — Группа»:
  • Курс 111 — Группа 222
  • Курс 333 — Группа 444

Сценарий 3. Возврат оплаты → удаление с курса

Добавьте в триггер одно действие:

  1. Удаление ученика с курса — email: {#email#}, курс: 12345.

Сценарий 4. Обновление данных после регистрации

Добавьте в триггер одно действие:

  1. Обновление ученика — email: {#email#}, имя: {#name#}, комментарий: Регистрация через вебинар {#webinarId#}.

Сценарий 5. Разные тарифы → разные курсы

Создайте несколько триггеров с разными условиями:

  • Триггер 1: тариф «Базовый» → Добавить ученика на курс 111, группа 222.
  • Триггер 2: тариф «Про» → Добавить ученика на курс 333, группа 444.

Шорткоды

В текстовых полях действий можно использовать шорткоды — подстановки данных из входящего события. Нажмите иконку {--} рядом с полем, чтобы увидеть список доступных шорткодов.

Часто используемые шорткоды:

Шорткод Данные
{#name#} Имя
{#email#} Email
{#phone#} Телефон

Частые вопросы

Ошибка подключения
Проверьте, что домен указан с https:// (например, https://myschool.skillspace.ru) и API-ключ верный. Ключ можно получить в настройках школы SkillSpace → API.
Ученик не добавляется на курс
Проверьте: указан ли email, указана ли хотя бы одна пара «Курс — Группа», существуют ли ID курса и группы в SkillSpace. Если ученик с таким email уже есть на курсе — SkillSpace может вернуть ошибку.
Не знаю ID курса или группы
ID курсов и групп можно найти в интерфейсе SkillSpace в настройках курса.
Ученик не удаляется с курса
Проверьте, что email совпадает с зарегистрированным в SkillSpace, ID курса указан правильно и ученик действительно записан на этот курс.
Данные ученика не обновляются
Email должен совпадать с существующим учеником. Пустые поля пропускаются — заполните хотя бы одно поле для обновления.
Нет кнопки «Общие настройки»
Это нормально. У SkillSpace нет общих настроек — все параметры задаются непосредственно в действиях триггера.
Можно ли добавить ученика на несколько курсов одним действием?
Да. В действии «Добавить ученика на курс» добавьте несколько строк в поле «Курс — Группа». Каждая строка — отдельная пара ID курса и ID группы.
×