Подключение
1 Добавьте сервис в Vakas-Tools
В Vakas-Tools перейдите в Сервисы → Добавить сервис → SOHO.LMS.
2 Укажите название
Укажите название подключения (произвольное, для вашего удобства).
3 Введите API токен
Введите API токен от SOHO LMS.
4 Сохраните
Нажмите «Добавить сервис».
API-токен можно получить в настройках вашего аккаунта SOHO LMS.
Важно: телефон — главный идентификатор
В SOHO LMS основной идентификатор контакта — телефон, а не email. Без телефона найти или создать клиента невозможно. Убедитесь, что телефон передаётся в данных.
В меню слева перейдите в «Базы». В нужной базе нажмите на «+ Сервис» и выберете SOHO.LMS
Как работает интеграция — общая схема
Передача данных настраивается через правила. На странице сервиса есть три вкладки: Регистрации, Отчёты, Заказы. На каждой вкладке — свой список правил.
Схема работы:
- Правило — определяет, при каких условиях передавать данные.
- Условия (внутри правила) — фильтруют, какие лиды попадут под это правило. Например:
Название тарифа—содержит—VIP. - Действия (кнопка напротив правила) — определяют, какое действие совершить и что именно передать в сервис.
Частая ошибка: если вы выбрали «содержит», но оставили поле значения пустым — правило не выполнится. Пустое поле значения = ошибка передачи.
Значок ⧉ — множественное добавление
Рядом с названием некоторых действий отображается зелёный значок ⧉ (два квадрата). Он означает, что это действие можно добавить несколько раз с разными настройками. При срабатывании триггера выполнятся все добавленные блоки.
Действия без этого значка можно добавить только один раз.
То есть если добавишь два блока:
- Блок 1: «Оплатил курс А»
- Блок 2: «Промокод: SALE2025»
Сработает триггер → в МойКласс к ученику добавятся два отдельных примечания.
Добавить правило
Правила настраиваются одинаково для всех сервисов. Подробная инструкция по созданию правил и настройке условий описана в отдельном разделе.
В рамках интеграции с SohoLMS отличаются только доступные действия, которые выполняются при срабатывании правила.
Действия SOHO LMS
Пользователь добавить/изменить
Ищет клиента по телефону. Если найден — обновляет данные. Если нет — создаёт нового.
Пропишите нужные переменные, которые хотите передать: например Имя → Базовые → выберите нужный шорткод - {#name#}
Если вы передаёте не стандартные данные (например: Фамилия, Отчество, дополнительное поле формы и т.д.), необходимо использовать шорткоды из фактически полученных данных регистрации.
Где их найти:
1 Перейдите в Базы
2 Откройте нужную базу
3 Нажмите кнопку «Контакты»
4 Откройте любой контакт
5 Нажмите «Посмотреть все данные с регистрации»
В таблице вы увидите: готовый шорткод (в синем блоке)
Пример: Фамилия → {#reg_field_last_name#} Отчество → {#reg_field_middle_name#}
Именно этот шорткод нужно вставлять в настройках действий.
| Поле | Обязательное | Описание |
|---|---|---|
| Имя | Нет | Имя клиента |
| Фамилия | Нет | Фамилия клиента |
| Отчество | Нет | Отчество клиента |
| Телефон | Да | Основной идентификатор клиента |
| Нет | Email клиента | |
| Город | Нет | Город клиента |
| Метки через запятую | Нет | Теги для клиента (через запятую) |
Логика обновления: обновляются только пустые поля. Если у клиента уже есть имя — оно не перезапишется.
Добавить заказ
Создаёт заказ в SOHO LMS для найденного/созданного клиента. Убедитесь, что продукт заранее создан в Soho → Продажи → Продукты
В выпадающем списке выберите продукт. Укажите цену. При необходимости укажите комментарий. Сохраните действие.
| Поле | Обязательное | Описание |
|---|---|---|
| Продукт | Да | Выбирается из списка продуктов SOHO LMS |
| Цена | Нет | Если пусто — берётся цена из настроек продукта |
| Комментарий | Нет | Произвольный комментарий к заказу |
Обратите внимание, что если вы задаете несколько условий, то для выполнения одного правила все условия должны быть выполнены. При необходимости используйте функцию: «После выполнения не выполнять другие правила» — завершает обработку других правил для данного лида.
Настройка по типам интеграций
Регистрации
Когда пользователь регистрируется (например, через GetCourse, Bizon365, форму на сайте), данные передаются в SOHO LMS.
Доступные шорткоды для регистраций:
| Шорткод | Описание |
|---|---|
{#name#} |
Имя |
{#email#} |
|
{#phone#} |
Телефон |
{#vebinar_time#} |
Дата и время вебинара |
{#vebinar_time_hi#} |
Время вебинара (чч:мм) |
{#vebinar_time_date#} |
Дата вебинара |
{#bizon_url#} |
Индивидуальная ссылка Bizon365 |
{#utm_source#}, {#utm_medium#}, {#utm_campaign#} |
UTM-метки |
{#reg_field_ИМЯ_ПОЛЯ#} |
Произвольное поле регистрации |
Пример настройки:
- Действие: Пользователь добавить/изменить
- Имя:
{#name#} - Телефон:
{#phone#} - Email:
{#email#}
- Имя:
Отчёты (вебинары)
Когда приходит отчёт о посещении вебинара (Bizon365, др.), данные о поведении зрителя передаются в SOHO LMS.
Доступные шорткоды для отчётов:
| Шорткод | Описание |
|---|---|
{#name#} |
Имя |
{#email#} |
|
{#phone#} |
Телефон |
{#city#} |
Город |
{#vizit_vebinar#} |
Был на вебинаре (да/нет) |
{#bil_minut#} |
Сколько минут был на вебинаре |
{#finished#} |
Присутствовал до конца |
{#clickFile#} |
Кликал по кнопке |
{#clickBanner#} |
Кликал по баннеру |
{#but_text#} |
Текст на кнопке |
{#comments#} |
Комментарии на вебинаре |
{#webinarId#} |
ID вебинарной комнаты |
{#view_date_data#} |
Дата вебинара |
{#view_date_data_hi#} |
Время вебинара |
{#view#} / {#viewTill#} |
Смотрел с / досмотрел до (Unix) |
{#view_date#} / {#viewTill_date#} |
Смотрел с / досмотрел до (текст) |
{#web_p1#}, {#web_p2#}, {#web_p3#} |
Параметры Bizon365 |
{#comments_tag#} |
Тег: с комментарием |
{#clickFile_tag#} |
Тег: нажал кнопку |
{#clickBanner_tag#} |
Тег: нажал баннер |
{#finished_tag#} |
Тег: досмотрел до конца |
{#report_field_ИМЯ_ПОЛЯ#} |
Произвольное поле отчёта |
Пример настройки (обновление клиента + метки по поведению):
- Действие: Пользователь добавить/изменить
- Телефон:
{#phone#} - Город:
{#city#} - Метки:
вебинар, {#webinarId#}, {#finished_tag#}, {#clickFile_tag#}
- Телефон:
Оплаты
Когда приходит информация об оплате или заказе, данные передаются в SOHO LMS для создания клиента и/или заказа.
Доступные шорткоды для оплат:
| Шорткод | Описание |
|---|---|
{#name#} |
Имя |
{#email#} |
|
{#phone#} |
Телефон |
{#payment_number#} |
Номер заказа |
{#positions#} |
Название тарифа/продукта |
{#costMoney#} |
Стоимость тарифа |
{#leftCostMoney#} |
Осталось оплатить |
{#payedMoney#} |
Оплачено |
{#payment_status#} |
Статус платежа |
{#paymentLink#} |
Ссылка на оплату |
{#utm_source#}, {#utm_medium#}, {#utm_campaign#} |
UTM-метки |
{#pay_field_ИМЯ_ПОЛЯ#} |
Произвольное поле оплаты |
Пример настройки (клиент + заказ):
- Действие 1: Пользователь добавить/изменить
- Имя:
{#name#} - Телефон:
{#phone#} - Email:
{#email#}
- Имя:
- Действие 2: Добавить заказ
- Продукт: выбрать из списка
- Цена:
{#costMoney#} - Комментарий:
Заказ #{#payment_number#}, статус: {#payment_status#}
Типичные сценарии
Регистрация → создание клиента
Тип: Регистрации
| Действие | Поля |
|---|---|
| Пользователь добавить/изменить | Имя: {#name#}, Телефон: {#phone#}, Email: {#email#} |
Вебинар → обновление клиента с метками
Тип: Отчёты
| Действие | Поля |
|---|---|
| Пользователь добавить/изменить | Телефон: {#phone#}, Город: {#city#}, Метки: вебинар, {#finished_tag#}, {#clickFile_tag#} |
Оплата → клиент + заказ
Тип: Оплаты
| Действие | Поля |
|---|---|
| Пользователь добавить/изменить | Имя: {#name#}, Телефон: {#phone#}, Email: {#email#} |
| Добавить заказ | Продукт: выбрать, Цена: {#costMoney#}, Комментарий: Оплата через Vakas-Tools |
Оплата → только заказ (клиент уже есть)
Тип: Оплаты
| Действие | Поля |
|---|---|
| Пользователь добавить/изменить | Телефон: {#phone#} (только для поиска) |
| Добавить заказ | Продукт: выбрать, Цена: {#costMoney#} |
Действие «Пользователь» обязательно даже если клиент существует — оно находит клиента для привязки заказа.