Документация / Интеграция c ProdamusXL / Интеграция с Prodamus XL (AXL) (выгрузка регистраций, отчетов и оплат)

Интеграция с Prodamus XL (AXL) (выгрузка регистраций, отчетов и оплат)

prodamusxlтариф базы

Выгрузка в LMS ProdamusXl. Настройка правил и условий, запуск сценариев с передачей контактов, групп, тегов и дополнительных атрибутов.

Подключение Prodamus XL

1 Перейдите в раздел подключения

В Vakas-tools перейдите в Доступы и сервисы → Добавить сервис → AXL (Prodamus XL).

2 Заполните форму

  • Название — произвольное имя подключения (например, «AXL — основной аккаунт»).
  • Домен — выберите платформу:
    • accelonline.io — для аккаунтов AccelOnline.
    • app.xl.ru — для аккаунтов XL.
  • API-ключ — секретный ключ из личного кабинета платформы.

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

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

4 Проверка подключения

Система проверит подключение, при успехе сервис появится в списке.

5 Добавить в базах

В меню слева перейдите в «Базы». В нужной базе нажмите на «+ Сервис» и выберете Prodamus XL.

Где взять API-ключ

  • AccelOnline: личный кабинет → настройки интеграции (или раздел API).
  • XL: личный кабинет → настройки → раздел API.

Обновление ключа

Если ключ изменился — нажмите на подключение в списке сервисов, введите новый ключ и нажмите «Обновить».

Как работает интеграция — общая схема

Передача данных настраивается через правила. На странице сервиса есть три вкладки: Регистрации, Отчёты, Заказы. На каждой вкладке — свой список правил.

Вкладки правил интеграции
Интерфейс правил: Регистрации, Отчёты, Заказы

Схема работы:

  1. Правило — определяет, при каких условиях передавать данные.
  2. Условия (внутри правила) — фильтруют, какие лиды попадут под это правило.
  3. Действия (кнопка напротив правила) — определяют, какое действие совершить и что именно передать в сервис.

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

Создание правила

1 Перейдите на нужную вкладку

Регистрации, Отчёты или Заказы.

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

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

3 Заполните параметры

  • Правило активно — поставьте галочку, чтобы правило работало.
  • Название — задайте понятное имя (например, «Все лиды», «Кликнул по кнопке», «Оплатил»).
  • Порядок — число, определяющее очерёдность выполнения правил (1, 2, 3...). Правила выполняются от меньшего к большему.
  • После выполнения не выполнять другие правила — если включить эту галочку, при попадании лида под условия этого правила дальнейшие правила проверяться не будут.

4 Сохраните

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

Настройка условий

Условия определяют, какие лиды попадут под данное правило.

1 Добавьте условие

В окне редактирования правила нажмите «Добавить условие».

2 Заполните строку условия

  • Поле — выберите поле из базы (например: «был минут», «кликал ли по кнопке», «utm_source», «email»).
  • Условие — выберите оператор сравнения: =, , >, <, , , содержит, не содержит.
  • Значение — укажите значение для сравнения (например: 60, 1, yandex).

3 Добавьте ещё условия при необходимости

Все условия объединяются через И (все условия должны выполниться одновременно).

Примеры условий:

Поле Условие Значение Что означает
был минут > 60 Был на вебинаре больше 60 минут
кликал ли по кнопке = 1 Кликнул по кнопке на вебинаре
оплачено > 0 Есть оплата
был минут < 1 Не был на вебинаре
Название тарифа содержит VIP Название тарифа содержит слово VIP

Частая ошибка — пустое значение. Если вы выбрали оператор «содержит», но не написали ЧТО именно содержит (оставили поле пустым), правило не выполнится. Пустое поле значения = ошибка передачи.

Правило без условий

Правило может быть без условий — тогда оно сработает для всех лидов.

Рекомендация: первое правило оставляйте без условий, чтобы все лиды были обработаны. Если все правила будут с условиями, лиды, не подходящие ни под одно условие, не передадутся.

Несколько правил — порядок выполнения

Правила проверяются по порядку (по числу в поле «Порядок»). Для каждого лида система проходит правила одно за другим:

Более подробно про настройку правил описано на странице
  1. Проверяет условия правила.
  2. Если условия выполнены — выполняет действия этого правила.
  3. Если включена галочка «После выполнения не выполнять другие правила» — остальные правила пропускаются.
  4. Если галочка не включена — система переходит к следующему правилу.

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

После создания правила нажмите кнопку «Действия» напротив него в таблице. Откроется конструктор действий, где вы указываете, что должно произойти в AXL при срабатывании этого правила.

Запуск сценария

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

Поле Обязательное Что указать Пример
ID сценария Да Числовой ID сценария из AXL 123
Имя Нет Имя контакта {#name#} (по умолчанию)
Фамилия Нет Фамилия контакта {#last_name#}
Отчество Нет Отчество контакта
E-mail Да Email контакта {#email#} (по умолчанию)
Телефон Нет Телефон контакта {#phone#} (по умолчанию)
Группы через запятую Нет Названия групп Вебинар январь, Новые
Теги через запятую Нет Теги vt_reg, webinar
Идентификатор атрибута / Значение Нет Пары «ключ — значение» tariff{#positions#}

Важно: E-mail — обязательное поле. Без него контакт в AXL не создастся и сценарий не запустится.

Где взять ID сценария

1 Откройте личный кабинет AXL

AccelOnline или XL.

2 Перейдите в раздел «Сценарии»

3 Скопируйте ID

Найдите нужный сценарий и скопируйте его ID (числовой идентификатор).

Либо скопируйте его из адресной строки (между слэшами, в нашем случае начинается с t и заканчивается w).

Либо нажмите на иконку рядом со сценарием и скопируйте ID из всплывающего окна.

Вставьте скопированный ID сценария в соответствующее поле.

Сценарий должен быть активен. Черновики и остановленные сценарии не запускаются.

Группы и теги

  • В поле «Группы через запятую» перечислите названия групп. Например: Вебинар январь, Новые.
  • В поле «Теги через запятую» перечислите теги. Например: vt_reg, webinar.

Названия групп должны совпадать с существующими в AXL. Пробелы вокруг запятых обрезаются автоматически.

Дополнительные атрибуты

В поле «Идентификатор атрибута / Значение» добавьте пары «ключ — значение». Слева — ID или ключ атрибута из AXL, справа — значение или шорткод. Можно добавить несколько строк.

Пример — передача данных оплаты:

Идентификатор атрибута Значение
tariff {#positions#}
payment_sum {#costMoney#}

Пример — передача UTM-меток:

Идентификатор атрибута Значение
utm_source {#utm_source#}
utm_medium {#utm_medium#}
utm_campaign {#utm_campaign#}

Идентификаторы атрибутов должны совпадать с ключами, заданными в AXL. Если атрибут не существует — значение не сохранится.

Где взять «Идентификатор атрибута» в Prodamus

Переходим в Prodamus XL - CRM - Контакты

Найдите контакт, нажмите «Редактировать» пользовательские атрибуты.

Скопируйте идентификатор атрибута.

Вставьте его в поле «Идентификатор атрибута».

В значении в Vakas-tools используем

В значении используйте для стандартных полей «Базовые» или «Для регистрации» шорткоды.

Если в сервис пришло нестандартное поле, шорткод для него можно взять из раздела «Контакты». Выберите нужное поле из данных, которые пришли в Vakas-tools, и используйте его для передачи в другой сервис.

Передача регистраций в Prodamus XL

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

Шаг 1. Создайте правило для регистрации

1 Перейдите на вкладку «Регистрации»

2 Нажмите «Добавить правило»

3 Заполните параметры

Задайте название (например, «Все регистрации»), порядок 1, поставьте галочку «Правило активно».

4 Оставьте правило без условий

Чтобы все регистрации передавались.

5 Сохраните

Шаг 2. Настройте действия правила

Нажмите «Действия» напротив созданного правила.

1 Добавьте действие «Запуск сценария»

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

2 Заполните поля

  • ID сценария: 123 (ID из AXL)
  • Имя: {#name#}
  • E-mail: {#email#}
  • Телефон: {#phone#}

3 Сохраните

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

Правило готово — при регистрации данные контакта будут переданы в AXL и запустится указанный сценарий.

Передача отчётов в Prodamus XL

Цель: после вебинара передать данные об активности зрителей в AXL — запустить разные сценарии в зависимости от поведения (был на вебинаре, кликал по кнопке и т.д.).

Шаг 1. Создайте правила для отчётов

Перейдите на вкладку «Отчёты».

Правило 1 — Все лиды (без условий)

1 Нажмите «Добавить правило»

2 Заполните параметры

Название: Все лиды. Порядок: 1. Галочка «Правило активно».

3 Не добавляйте условий

Это правило будет обрабатывать всех лидов.

4 Сохраните

Правило 2 — По активности (с условиями)

1 Нажмите «Добавить правило»

2 Заполните параметры

Название: Кликнул по кнопке. Порядок: 2. Галочка «Правило активно».

3 Добавьте условия

Нажмите «Добавить условие» и укажите: Поле = кликал ли по кнопке, Условие = =, Значение = 1.

При необходимости добавьте ещё условие: Поле = был минут, Условие = >, Значение = 60.

4 Сохраните

Шаг 2. Настройте действия каждого правила

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

Для разных правил можно указать разные сценарии — например, для «Все лиды» запустить общий сценарий, а для «Кликнул по кнопке» — сценарий горячего лида.

Если хотите передавать данные по участию: в Prodamus CRM → Контакты → Управление пользовательскими атрибутами создайте нужные поля.

Например: «Был на вебинаре» (тип: флаг, т.е. будет проставляться галочка ✅) «Сколько минут был» (тип: число) «Клик по кнопке» (тип: флаг) и т.д.

Скопируйте их идентификаторы и добавьте в настройках правила в Vakas-tools:

Вставка в Vakas-tools:

Укажите, откуда из базы брать «Значение» — используйте шорткоды «Для отчетов» или «Базовые»:

Передача заказов и оплат в Prodamus XL

Цель: при оплате передать данные в AXL — запустить сценарий с информацией о заказе (тариф, сумма, UTM-метки).

Шаг 1. Создайте правило для заказов

1 Перейдите на вкладку «Заказы»

2 Нажмите «Добавить правило»

3 Заполните параметры

Задайте название (например, «Все заказы»), порядок 1, поставьте галочку «Правило активно».

4 Оставьте правило без условий

Чтобы все заказы передавались.

5 Сохраните

Пример: правило «Оплатил»

1 Нажмите «Добавить правило»

2 Заполните параметры

Название: Оплатил. Порядок: 2. Галочка «Правило активно».

3 Включите галочку «После выполнения не выполнять другие правила»

4 Добавьте условия

  • Поле: оплачено, условие: >, значение: 0.
  • Поле: осталось оплатить, условие: =, значение: 0.

5 Сохраните

Например:

Шаг 2. Настройте действия правила

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

  • ID сценария: 789 (ID из AXL)
  • E-mail: {#email#}
  • Дополнительные атрибуты:
Идентификатор атрибута Значение
tariff {#positions#}
payment_sum {#costMoney#}

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

Переходим в Prodamus XL: CRM → Контакты → Управление пользовательскими атрибутами. 

Создайте нужные поля: Например: «Оплачено», «Стоимость тарифа»,  «Осталось оплатить» 

Скопируйте их идентификаторы и добавьте в настройках правила:

Вставьте в Vakas-tools:

В значении используйте для стандартных полей «Базовые» или «Для заказов» шорткоды.

Аналогично добавьте все поля, которые необходимо передать.

Шорткоды

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

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

Шорткод Данные
{#name#} Имя контакта
{#email#} Email
{#phone#} Телефон
{#webinarId#} ID вебинара
{#city#} Город
{#bil_minut#} Был на вебинаре (минут)
{#clickFile#} Кликал ли по кнопке
{#positions#} Название тарифа
{#costMoney#} Сумма заказа
{#payedMoney#} Оплачено
{#leftCostMoney#} Осталось оплатить
{#payment_status#} Статус платежа
{#payment_number#} Номер заказа
{#utm_source#} UTM source
{#utm_medium#} UTM medium
{#utm_campaign#} UTM campaign

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

Ошибка подключения при добавлении сервиса
Проверьте: 1) правильный ли домен выбран — AccelOnline → accelonline.io, XL → app.xl.ru; 2) API-ключ валидный — скопируйте заново из личного кабинета; 3) у ключа есть права на выполнение сценариев.
Ошибка «Не указан id сценария»
Поле «ID сценария» пустое в действии. Нажмите «Действия» напротив правила и укажите числовой ID сценария из личного кабинета AXL.
Сценарий не запускается, хотя всё настроено
Проверьте: 1) правило активно — стоит галочка «Правило активно»; 2) сценарий активен в AXL — черновики и остановленные не запускаются; 3) ID сценария правильный; 4) E-mail контакта передаётся — это обязательное поле; 5) условия правила не отсекают лида.
Контакт не создаётся в AXL
Поле E-mail обязательно. Проверьте, что шорткод {#email#} возвращает значение. Без email контакт не будет создан.
Группы или теги не применяются
Проверьте: 1) названия указаны через запятую; 2) названия групп совпадают с существующими в AXL; 3) нет опечаток.
Телефон передаётся некорректно
Система автоматически добавляет + к номеру телефона. Если номер в базе уже содержит + — может быть двойной +. Проверьте формат номера в данных контакта.
Дополнительные атрибуты не сохраняются
Проверьте: 1) идентификатор атрибута совпадает с ключом в AXL; 2) значение не пустое; 3) тип значения соответствует типу атрибута в AXL.
Правило не срабатывает
Проверьте: 1) стоит галочка «Правило активно»; 2) условия заполнены корректно — если выбран оператор «содержит», поле значения не должно быть пустым; 3) порядок правил верный — предыдущее правило с галочкой «не выполнять другие» может блокировать текущее.
Ошибка таймаута
API AXL не ответил в течение 10 секунд. Повторите попытку. Если ошибка повторяется — проверьте статус платформы AXL.

Передача регистраций

Передача отчетов

Передача заказов и оплат

×