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

emdesellтариф базы

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

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

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

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

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

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

Введите Домен — адрес вашей школы в формате вашашкола.emdesell.ru.

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

Введите Ключ API.

5 Добавьте сервис

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

Где взять ключ API: в Emdesell перейдите в Настройки → Api → +API КЛЮЧ. Создайте новый ключ и скопируйте его.

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

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

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

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

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

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

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

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

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

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

Действие Описание
Добавить контакт Ищет аккаунт по email. Если не найден — создаёт нового студента. Если найден — обновляет данные.
Присвоение доступа аккаунту Выдаёт аккаунту доступ к выбранному курсу на указанное количество дней.
Создание ссылки авторизации Генерирует одноразовую ссылку для входа в школу без пароля.
Доступные действия

Создание аккаунта студента в Emdesell

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

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

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

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

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

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

Нажмите «Сохранить». Теперь при срабатывании триггера аккаунт будет создан или обновлён в Emdesell.
Добавить контакт
Поле Описание Пример
Имя Имя студента. Поддерживает шорткоды. {#name#}
Фамилия Фамилия студента. Поддерживает шорткоды. {#last_name#}
Отчество Отчество студента. Поддерживает шорткоды. {#patronymic#}
Признак подтверждения email Подтверждён или Не подтверждён. Подтверждён
Отправить email при создании аккаунта Отправить — студент получит письмо. Не отправлять — без письма. Не отправлять

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

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

  1. Система ищет аккаунт в Emdesell по email.
  2. Если аккаунт найден — обновляет данные (имя, фамилию, телефон).
  3. Если аккаунт не найден — создаёт нового студента с указанными данными. Пароль генерируется автоматически (15 случайных символов). Роль — всегда «Студент».

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

Выдача доступа к курсу

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

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

Перед выдачей доступа аккаунт должен существовать. Добавьте действие «Добавить контакт» (см. раздел выше), если оно ещё не добавлено.

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

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

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

Нажмите «Сохранить». Теперь при срабатывании триггера студент получит доступ к выбранному курсу.
Присвоение доступа аккаунту
Поле Описание Пример
Курс Выберите курс из списка. Список загружается из вашего аккаунта Emdesell. Базовый курс
Длительность в днях Количество дней доступа. 0 — бессрочный доступ. 365

Важно: действие «Присвоение доступа» не создаёт аккаунт. Если действие «Добавить контакт» не добавлено — вернётся ошибка «аккаунт не был найден».

Генерация ссылки авторизации

Цель: создать одноразовую ссылку для входа студента в школу без пароля.

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

Аккаунт должен существовать. Добавьте действие «Добавить контакт», если оно ещё не добавлено.

2 Добавьте действие «Создание ссылки авторизации»

Нажмите «Добавить действие» → Создание ссылки авторизации. Заполните:

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

Нажмите «Сохранить». Система сгенерирует ссылку для входа без пароля.
Создание ссылки авторизации
Поле Описание Пример
Длительность Лимит использований ссылки. 0 — без ограничений. 1

Обратите внимание: в этом действии «Длительность» — это количество использований ссылки, а не количество дней.

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

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

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

  1. Добавить контакт — имя: {#name#}, email подтверждён: Подтверждён, отправить email: Не отправлять.
  2. Присвоение доступа аккаунту — курс: выбранный курс, длительность: 365.

Сценарий 2. Регистрация → аккаунт + бесплатный курс

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

  1. Добавить контакт — имя: {#name#}, email подтверждён: Не подтверждён, отправить email: Отправить.
  2. Присвоение доступа аккаунту — курс: «Бесплатный вводный», длительность: 0 (бессрочно).

Сценарий 3. Генерация ссылки для входа

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

  1. Добавить контакт — имя: {#name#}.
  2. Создание ссылки авторизации — длительность: 1 (одноразовая ссылка).

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

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

  • Триггер 1: тариф «Базовый» → Добавить контакт + Присвоение доступа (курс «Базовый», 180 дней).
  • Триггер 2: тариф «Про» → Добавить контакт + Присвоение доступа (курс «Про», 365 дней).

Шорткоды

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

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

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

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

Ошибка авторизации при подключении
Проверьте домен (формат: вашашкола.emdesell.ru) и ключ API. Убедитесь, что ключ скопирован полностью, без лишних пробелов. Ключ создаётся в Emdesell → Настройки → Api.
Аккаунт не создаётся
Email — обязательное поле. Emdesell ищет и создаёт аккаунт по email. Если email не передаётся — создание не сработает.
Аккаунт обновляется вместо создания
Это нормальное поведение. Если аккаунт с таким email уже существует — система обновляет его данные (имя, фамилию, телефон), а не создаёт новый.
Доступ к курсу не выдаётся
Аккаунт должен существовать. Убедитесь, что действие «Добавить контакт» стоит перед «Присвоением доступа». Проверьте, что курс выбран в настройках действия.
Пароль студента
При создании нового аккаунта пароль генерируется автоматически (15 случайных символов). Студент может войти через ссылку авторизации или сбросить пароль через форму восстановления на сайте школы.
Нет кнопки «Общие настройки»
Это нормально. У Emdesell нет общих настроек — все параметры задаются непосредственно в действиях триггера.
Можно ли изменить роль студента?
Нет. В текущей версии интеграции роль всегда «Студент». Изменить роль можно только вручную в интерфейсе Emdesell.
×