Для чего нужна интеграция
Вместо ручного добавления каждого ученика на курс, система делает это сама при наступлении нужного события: оплата, регистрация, завершение вебинара и т.д.
Что можно автоматизировать:
- Выдача доступа к курсу — ученик оплатил → автоматически получил доступ к курсу и группе.
- Обновление данных — изменились данные ученика → они обновятся в SkillSpace.
- Отзыв доступа — возврат или отмена оплаты → ученик удаляется с курса. Окончание подписки тоже сработает, если сервис, где она ведётся, сообщит об этом событием: сменой этапа в CRM или статуса заказа.
- Приём событий из Skillspace: ученик приглашён на курс, закончил курс, сдал тест, изменился статус платежа. По каждому событию можно запустить правило: отправить письмо или СМС, передать данные в CRM, добавить ученика на следующий курс.
Подключение 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 настраивается через действия правила. Нажмите кнопку «Действия» напротив нужного правила — откроется конструктор действий.
Доступные действия:
| Действие | Описание |
|---|---|
| Добавить ученика на курс | Приглашает ученика на один или несколько курсов с указанием группы. |
| Обновление ученика | Обновляет данные существующего ученика (имя, email, комментарий). |
| Удаление ученика с курса | Удаляет (отзывает) ученика с указанного курса. |
Добавление ученика на курс
Цель: при оплате, регистрации или другом событии автоматически добавить ученика на курс в SkillSpace.
1 Создайте правило
- Создайте правило с нужным условием (например, по событию оплаты или регистрации).
- Нажмите «Действия» напротив правила.
2 Добавьте действие «Добавить ученика на курс»
Нажмите «Добавить действие» → Добавить ученика на курс. Заполните поля:
3 Сохраните настройки
Нажмите «Сохранить». Теперь при срабатывании правила ученик будет добавлен на указанные курсы в SkillSpace.
| Поле | Описание | Пример |
|---|---|---|
| Email ученика. Поддерживает шорткоды. | {#email#} |
|
| Имя | Имя ученика. Поддерживает шорткоды. | {#name#} |
| Комментарий | Произвольный комментарий к приглашению. Поддерживает шорткоды. | Оплата тарифа {#positions#} |
| Курс — Группа | Левая колонка: ID курса. Правая колонка: ID группы. Можно добавить несколько строк. | 12345 — 67890 |
Нажмите иконку {--} рядом с полем, чтобы увидеть список доступных шорткодов.
Как работает:
- Система формирует приглашение с указанными данными.
- Для каждой пары «Курс — Группа» ученик добавляется на соответствующий курс.
- Если группа не указана — ученик добавляется на курс без группы.
Важно: ID курсов и групп можно найти в интерфейсе SkillSpace в настройках курса.
Обновление данных ученика
Цель: обновить имя, комментарий или другие данные существующего ученика в SkillSpace.
1 Добавьте действие «Обновление ученика»
Нажмите «Добавить действие» → Обновление ученика. Заполните поля:
2 Сохраните настройки
Нажмите «Сохранить».
| Поле | Описание | Пример |
|---|---|---|
| Email ученика (для поиска). Поддерживает шорткоды. | {#email#} |
|
| Имя | Новое имя ученика. Поддерживает шорткоды. | {#name#} |
| Комментарий | Комментарий. Поддерживает шорткоды. | Обновлено после вебинара {#webinarId#} |
Как работает:
- Система находит ученика в SkillSpace по email.
- Обновляет указанные поля. Пустые поля пропускаются — старые данные сохраняются.
Важно: email является идентификатором ученика. Если ученик с таким email не найден — обновление не произойдёт.
Удаление ученика с курса
Цель: отозвать доступ ученика к курсу — например, при возврате оплаты или завершении подписки.
1 Добавьте действие «Удаление ученика с курса»
Нажмите «Добавить действие» → Удаление ученика с курса. Заполните поля:
2 Сохраните настройки
Нажмите «Сохранить».
| Поле | Описание | Пример |
|---|---|---|
| Email ученика. Поддерживает шорткоды. | {#email#} |
|
| Курс | ID курса, с которого нужно удалить ученика. Поддерживает шорткоды. | 12345 |
Как работает:
- Система находит ученика по email.
- Удаляет его с указанного курса.
Важно: email должен совпадать с зарегистрированным в SkillSpace. Ученик должен быть записан на указанный курс.
Сценарии: передача в Skillspace
Готовые примеры правил с действиями Skillspace. Правило создаётся на вкладке «Оплаты» или «Регистрации», действием выбирается нужная операция в Skillspace.
Сценарий 1. Оплата → добавление на курс
На вкладке Оплаты создайте правило без условий: оно сработает на каждую оплату. Добавьте действие:
- Добавить ученика на курс — email:
{#email#}, имя:{#name#}, курс:12345, группа:67890.
Сценарий 2. Оплата → добавление на несколько курсов
На вкладке Оплаты создайте правило без условий. Добавьте действие:
- Добавить ученика на курс — email:
{#email#}, имя:{#name#}, несколько строк в поле «Курс — Группа»:
- Курс
111— Группа222 - Курс
333— Группа444
Сценарий 3. Возврат оплаты → удаление с курса
На вкладке Оплаты создайте правило с условием по полю Статус платежа: укажите значение возврата, которое присылает ваш платёжный сервис. Добавьте действие:
- Удаление ученика с курса — email:
{#email#}, курс:12345.
Сценарий 4. Обновление данных после регистрации
На вкладке Регистрации создайте правило без условий. Добавьте действие:
- Обновление ученика — email:
{#email#}, имя:{#name#}, комментарий:Регистрация через вебинар {#webinarId#}.
Сценарий 5. Разные тарифы → разные курсы
На вкладке Оплаты создайте два правила с условием по полю Название тарифа:
- Правило 1: тариф «Базовый» → Добавить ученика на курс
111, группа222. - Правило 2: тариф «Про» → Добавить ученика на курс
333, группа444.
Приём событий из Skillspace
Интеграция работает и в обратную сторону. Skillspace отправляет в Vakas-tools события по ученику: приглашён на курс, закончил курс, сдал домашнее задание или тест, изменился статус платежа. Событие попадает в базу как регистрация, и по нему можно запустить любое правило: отправить письмо или СМС, передать данные в CRM, добавить ученика на другой курс.
Для этого нужно один раз указать в Skillspace адрес приёма данных Vakas-tools.
Шаг 1. Скопируйте адрес вебхука в Vakas-tools
1 Откройте раздел «Базы»
В левом меню выберите Базы и найдите базу, в которую будут приходить события из Skillspace.
2 Откройте ссылки базы
На карточке базы нажмите Ссылки. Откроется страница «Ссылки для приёма данных».
3 Скопируйте адрес из блока «Webhook для Skillspace»
На вкладке «Для сбора регистраций (подписчиков)» найдите блок Webhook для Skillspace и нажмите Копировать. Адрес выглядит так: https://vakas-tools.ru/skillspace/sendform/ваш-код/номер-базы/.
Один адрес принимает все события Skillspace. Отдельные ссылки для каждого события создавать не нужно.
Шаг 2. Вставьте адрес в Skillspace
1 Откройте настройки школы
В Skillspace перейдите в Настройки школы → API: это тот же раздел, где вы брали API-ключ.
2 Укажите адрес вебхука
В поле адреса вебхука вставьте скопированную ссылку и сохраните настройки.
3 Отправьте тестовое событие
Нажмите в Skillspace кнопку отправки тестового вебхука. Через несколько секунд в базе Vakas-tools появится тестовый контакт. У тестовых событий к названию добавляется -test (например, course-end-test), поэтому правила с условием по точному названию события на них не сработают: это нормально.
Какие события приходят
Название события записывается в поле skillspace_event. По нему в правилах отличают одно событие от другого.
| Событие | Когда срабатывает | Значение skillspace_event |
|---|---|---|
| Ученик приглашён на курс | В момент приглашения ученика на курс | course-begin |
| Ученик закончил курс | Когда курс пройден на 100% | course-end |
| Ученик начал домашнее задание | При отправке первого ответа в домашнее задание | homework-begin |
| Домашнее задание проверено | Когда преподаватель поставил зачёт или незачёт, либо сработал автозачёт | homework-end |
| Ученик начал тест | При создании новой попытки прохождения теста | test-begin |
| Ученик закончил тест | В момент окончания теста | test-end |
| Ученик зашёл на платформу | При начале работы, если после прошлого визита прошло больше часа | session-begin |
| Ученик ушёл с платформы | Если ученик не был активен больше часа | session-end |
| Изменился статус платежа | При оплате, отмене или ошибке платежа в Skillspace | change-payment-status |
Какие данные приходят с событием
С любым событием всегда приходят email ученика, название события, его дата и время, а также дополнительные поля ученика, если они заполнены в Skillspace. Остальное зависит от события:
| Событие | Что приходит с ним |
|---|---|
Ученик приглашён на курс (course-begin) |
email, имя, курс, группа, ссылка для входа |
Ученик закончил курс (course-end) |
email, имя, курс, группа |
Ученик зашёл на платформу (session-begin) |
email, группа. Ни курса, ни имени |
Ученик ушёл с платформы (session-end) |
email, группа. Ни курса, ни имени |
Ученик начал домашнее задание (homework-begin) |
email, курс, группа, занятие |
Домашнее задание проверено (homework-end) |
email, курс, группа, занятие, email преподавателя, автозачёт или нет |
Ученик начал тест (test-begin) |
email, курс, группа, занятие |
Ученик закончил тест (test-end) |
email, имя, курс, группа, занятие, сдан или нет, верных ответов из общего числа, балл |
Изменился статус платежа (change-payment-status) |
email, имя, курс, группа, статус платежа, платёжный шлюз, причина ошибки |
Как эти данные называются в правилах
Все поля события сохраняются в данных регистрации контакта с приставкой skillspace_. Их можно использовать в условиях правил и подставлять в действия шорткодом {#reg_field_название_поля#}.
| Данные | Поле в правилах | Что содержит |
|---|---|---|
| Email и имя | email, name |
По email контакт находится или создаётся в базе |
| Название события | skillspace_event |
Значение из таблицы «Какие события приходят» |
| Дата и время | skillspace_date |
|
| Курс | skillspace_course_name |
|
| Группа | skillspace_group_name |
|
| Занятие | skillspace_lesson_name, skillspace_lesson_type |
Название и тип занятия |
| Ссылка для входа | skillspace_register_url |
По ней ученик заходит в Skillspace |
| Статус платежа | skillspace_payment_status |
CONFIRMED (оплачен) или canceled (отменён) |
| Платёжный шлюз | skillspace_gateway_name |
|
| Причина ошибки платежа | skillspace_error_reason_text |
Если ошибка была |
| Тест сдан или нет | skillspace_test_success |
true или false |
| Ответы в тесте | skillspace_test_answers_correct, skillspace_test_answers_total |
Сколько правильных и сколько всего |
| Балл за занятие | skillspace_lesson_score |
|
| Автозачёт домашнего задания | skillspace_homework_auto_accept |
true, если зачтено автоматически |
| Преподаватель | skillspace_teacher_email |
Кто проверил задание |
| Доп. поля ученика | skillspace_ + название поля |
Название пишется латиницей, как в Skillspace |
Важно знать: все события Skillspace, включая статус платежа, попадают во вкладку «Регистрации», а не в «Оплаты». Сумма платежа в событии не передаётся: только статус, шлюз и причина ошибки. Контакт определяется по email; телефон из Skillspace не приходит, а если он заведён как доп. поле ученика, то сохраняется как skillspace_telefon и телефоном контакта не становится.
Передача события дальше: правило
На этом приём закончен. Событие из Skillspace уже лежит в базе как регистрация контакта с полями skillspace_…, и само по себе оно ничего не делает. Дальше вы решаете, что с ним делать, и это настраивается правилом на вкладке Регистрации, так же как для любой другой регистрации: сначала условие (какое именно событие), потом действия (куда передать и что сделать).
Как запустить правило по событию
1 Дождитесь первого события
Отправьте из Skillspace тестовый вебхук или дождитесь реального события. В базе появится контакт с данными события.
2 Добавьте поля события в условия правил
Откройте карточку этого контакта в разделе Контакты, раскройте «Посмотреть все данные с регистрации» и нажмите «Скопировать структуру в правила». После этого поля skillspace_* появятся в списке условий.
3 Создайте правило на вкладке «Регистрации»
В базе откройте вкладку Регистрации и добавьте правило с условием. В списке условий поля события называются «Регистрация: skillspace_event», «Регистрация: skillspace_payment_status» и так далее. Например: Регистрация: skillspace_event равно course-end.
4 Настройте действия
Нажмите «Действия» напротив правила и добавьте нужные. В другом сервисе: письмо, СМС, сообщение в мессенджер, действие в CRM. В самом Skillspace: добавить ученика на другой курс. В текстах действий можно подставлять данные события, например {#reg_field_skillspace_course_name#} или {#reg_field_skillspace_register_url#}.
Обязательно ставьте условие по skillspace_event. Все девять событий приходят на один адрес, и правило без условия сработает на каждое из них: и на вход ученика на платформу, и на начало теста.
Сценарии: события из Skillspace
Готовые примеры правил на входящие события. Правило создаётся на вкладке «Регистрации» с условием по полю skillspace_event.
С какими сервисами работают эти сценарии
События Skillspace приходят на вкладку Регистрации, поэтому в правиле доступны все сервисы-получатели, подключённые к базе. По событиям из Skillspace обычно работают:
- CRM: amoCRM, Битрикс24, Kommo, Sendpulse CRM, ПланФикс, HubSpot, close.com. Создать или обновить контакт и сделку, сменить этап, поставить задачу.
- Письма: Unisender, Sendpulse, NotiSend, DashaMail, Mailopost, Unione, Selzy, Sendsay.
- СМС и звонки: SMSЦентр, sms.ru, SMSAero, SMS GOROD, P1SMS, SMSint, SMS-BOOM, Targetsms, Mobizon, Twilio; звонки через Звонопес, Zvonobot, Звонок.ком. Телефон должен уже быть в базе: Skillspace его не передаёт.
- Мессенджеры и чат-боты: Telegram, WhatsApp, MAX, Salebot, BotHelp, Senler.
- Обучение: сам Skillspace (следующий курс), GetCourse, SOHO.LMS, Emdesell, Zenclass.
- Таблицы и аналитика: Google-таблицы, Table-vakas, Яндекс Метрика, Google Analytics 4.
Сценарий 1. Ученик приглашён на курс → отправить ссылку для входа
На вкладке Регистрации создайте правило с условием Регистрация: skillspace_event равно course-begin. Добавьте действие:
- Письмо через Unisender, Sendpulse, NotiSend, DashaMail, Mailopost, Unione, Selzy или Sendsay, сообщение в Telegram, WhatsApp или MAX, либо СМС через SMSЦентр, sms.ru, SMSAero и другие СМС-сервисы. Текст: «Доступ к курсу
{#reg_field_skillspace_course_name#}открыт. Войти:{#reg_field_skillspace_register_url#}». Для СМС и звонка телефон должен уже быть в базе: Skillspace его не передаёт.
Сценарий 2. Оплата в Skillspace подтверждена → сделка в CRM
На вкладке Регистрации создайте правило с двумя условиями: Регистрация: skillspace_event равно change-payment-status и Регистрация: skillspace_payment_status равно CONFIRMED. Добавьте действие:
- Действие в amoCRM, Битрикс24, Kommo, Sendpulse CRM, ПланФикс, HubSpot или close.com: создать сделку или перевести её на этап «Оплачено», в название подставить
{#reg_field_skillspace_course_name#}. Тем же правилом можно добавить строку в Google-таблицы или Table-vakas для сверки оплат.
Сценарий 3. Курс пройден → добавить на следующий курс
На вкладке Регистрации создайте правило с условиями Регистрация: skillspace_event равно course-end и Регистрация: skillspace_course_name равно названию первого курса. Добавьте действие:
- Добавить ученика на курс в Skillspace: email
{#email#}, имя{#name#}, курс и группа следующего уровня. Если следующий уровень идёт на другой платформе, тем же правилом можно добавить ученика в группу GetCourse или создать заказ в SOHO.LMS.
Шорткоды
В текстовых полях действий можно использовать шорткоды — подстановки данных из входящего события. Нажмите иконку {--} рядом с полем, чтобы увидеть список доступных шорткодов.
Часто используемые шорткоды:
| Шорткод | Данные |
|---|---|
{#name#} |
Имя |
{#email#} |
|
{#phone#} |
Телефон |
Частые вопросы
https:// (например, https://myschool.skillspace.ru) и API-ключ верный. Ключ можно получить в настройках школы SkillSpace → API.Другие варианты обмена данными собраны на странице интеграций Skillspace с другими сервисами.