Интеграция Zenclass с другими сервисами

Что умеет интеграция Zenclass

Интеграция не выполняет полную синхронизацию всех данных платформы. Она работает с конкретным набором входящих событий и действий.

События из Zenclass

Zenclass может отправить в Vakas-tools HTTP-уведомление, когда:

• ученик подписался на продукт;
• оплата принята;
• урок завершён;
• задание отправлено на проверку;
• задание принято;
• изменился статус банковского кредита или рассрочки.

Технические имена этих событий:

• product_user_subscribed;
• payment_accepted;
• lesson_completed;
• lesson_task_submitted_for_review;
• lesson_task_accepted;
• bank_credit_status_changed.

После получения события правило может передать его данные в CRM, таблицу, мессенджер или другой подключённый сервис, если в целевом коннекторе есть подходящее действие.

Действия в Zenclass

В действиях Vakas-tools ученик определяется по email. Поэтому адрес должен быть одинаковым в исходном сервисе и в профиле Zenclass.

Как работает связка

Из Zenclass во внешний сервис:

Событие в Zenclass → HTTP-уведомление → Vakas-tools → действие в CRM, таблице, мессенджере или другом подключённом сервисе

Из внешнего сервиса в Zenclass:

Событие в исходном сервисе → правило Vakas-tools → API Zenclass → профиль ученика или доступ к курсу

Это два независимых направления с конечными наборами событий и действий. Можно использовать только одно направление или собрать последовательность из нескольких правил под конкретный процесс.

Что потребуется для подключения

Для действий в Zenclass

1. Выпустите отдельный API-токен в настройках школы Zenclass.
2. Выдайте токену разрешения, которые показывает форма подключения Vakas-tools.
3. Подготовьте email ученика для поиска или создания профиля.
4. Укажите ID курса, если правило управляет доступом.
5. Создайте правило с одним из четырёх действий Zenclass.

Zenclass рекомендует выпускать отдельный токен для каждой интеграции. Храните его как пароль: обладатель токена с нужными разрешениями может изменять данные в кабинете школы.

Для событий из Zenclass

1. Скопируйте URL webhook, созданный в Vakas-tools.
2. Создайте процесс в разделе автоматизации Zenclass.
3. Выберите нужный триггер и действие «Отправить HTTP-уведомление».
4. Вставьте URL Vakas-tools и сохраните процесс.
5. Передайте секретный ключ webhook для проверки подписи запроса.

Секретный ключ подтверждает, что запрос отправил Zenclass, а не посторонний источник. Его нельзя публиковать в инструкции, открытом коде или скриншоте.

Пошаговые материалы по настройке находятся в документации Vakas-tools. Другие сервисы для правила можно выбрать в каталоге интеграций.

Примеры сценариев

Оплата во внешнем сервисе → ученик и доступ к курсу

После подтверждения платежа первое правило создаёт профиль ученика по email, а следующее открывает доступ к нужному курсу по его ID. Если профиль уже существует, сценарий нужно настроить так, чтобы повторное событие не создавало лишнюю запись.

Изменение данных в CRM → профиль ученика

Когда менеджер исправляет имя, телефон или другое поддерживаемое поле, правило обновляет профиль ученика в Zenclass. Email используется для поиска профиля и должен быть передан без расхождений.

Оплата в Zenclass → запись в CRM

Zenclass отправляет событие payment_accepted, Vakas-tools проверяет webhook и запускает действие в подключённой CRM. Набор передаваемых полей зависит от события Zenclass и возможностей выбранного CRM-коннектора.

Ученик завершил урок → уведомление или следующее действие

Событие lesson_completed может запустить сообщение ответственному сотруднику, запись в таблицу или другое доступное действие. Условие и направление задаются в правиле Vakas-tools.

У Zenclass есть собственная коробочная интеграция с amoCRM. Vakas-tools имеет смысл, если в сценарии участвуют другие сервисы, нужны дополнительные условия или одно событие должно запускать несколько действий.

Если вы только выбираете LMS, сначала изучите обзор платформ для онлайн-школ. Эта страница посвящена интеграции уже используемого Zenclass, а не сравнению тарифов и возможностей обучения.

Встроенная автоматизация Zenclass или Vakas-tools

Если нужный процесс уже закрывает встроенная автоматизация, дополнительный сервис не требуется. Vakas-tools нужен там, где событие должно выйти за пределы Zenclass или внешний сервис должен управлять профилем и доступом ученика.

Как проверить интеграцию

1. Проверьте API-токен или URL webhook и выбранное направление.
2. Выполните тестовое событие на отдельном ученике без реальных персональных данных на скриншотах.
3. Сверьте email ученика и ID курса.
4. Проверьте выполнение правила в журнале Vakas-tools.
5. Убедитесь, что профиль или доступ изменился в Zenclass либо действие выполнилось в целевом сервисе.
6. Для webhook проверьте подпись запроса и поведение сценария при повторном событии.

Ограничения интеграции

• Действия ищут ученика по email, а не по произвольному полю.
• Для открытия и закрытия доступа нужен ID курса из Zenclass.
• Коннектор не подставляет списки всех учеников и курсов для выбора.
• Обновлять можно только поля профиля, поддерживаемые текущим действием.
• Повторное webhook-событие не должно создавать дубли или повторять необратимое действие.
• Состав событий и полей может меняться на стороне Zenclass, поэтому перед обновлением сценария нужно сверять документацию.

Актуальные требования описаны в официальных материалах Zenclass: API и токены, HTTP-уведомления и встроенная автоматизация.