Разработка интеграции Mindbox для YULIAWAVE на inSales
Fashion-бренд YULIAWAVE переехал с 1С-Битрикс: Управление сайтом на inSales — для новой витрины требовалось разработать интеграцию с Mindbox: с минимальной потерей исторических данных и сохранением уже настроенных механик.
Цель — выстроить корректную интеграцию с учетом бизнес-процессов клиента: сохранить и улучшить механики и дополнить их новыми данными и событиями. Работа велась под руководством представителя Mindbox и совместно с агентством Весёлкина Маша.
inSales — SaaS-платформа: данные передаются через фронтенд на витрине, API и вебхуки, без прямого доступа к backend магазина. Для клиента критичны корректная передача информации по товарам, поддержка мультикатегорий в фиде и единая логика для гостевых и авторизованных сессий.
Mindbox требует потока событий с витрины в реальном времени и надёжной передачи критичных операций через backend-каналы платформы. Мы разделили интеграцию на фронтенд-события и серверные операции.
На витрине inSales отслеживаются действия пользователя и передаются в Mindbox:
События отправляются асинхронно и не блокируют интерфейс магазина.
Критичные операции идут через подписку на вебхуки inSales:
Перед отправкой в Mindbox данные валидируются и нормализуются на стороне интеграции.
Работа велась в формате регулярных созвонов с клиентом, представителем Mindbox и агентством «Весёлкина Маша». Каждый этап завершался согласованным артефактом: от карты событий и схемы API до чек-листа тестов перед запуском.
Ниже — части интеграции, которые мы детально спроектировали и реализовали. Для каждого сценария определены операции Mindbox, источники данных inSales и правила передачи через фронтенд, API и вебхуки.
Ключевые решения при разработке интеграции на inSales: нестандартный фид, связка с фронтенд-API common.v2.js и выверенные правила идентификаторов. Ниже — логика реализации: как обходили ограничения SaaS-платформы и edge-cases витрины.
Фид собран на Liquid с подходом, который не описан в открытой документации inSales: внутри — товары и варианты, мультикатегории, дополнительные атрибуты и остатки для механики «Лист ожидания». Структура и идентификаторы выверены с Mindbox и используются единообразно во всех событиях витрины.
На витрине — единый класс трекера Mindbox: очередь вызовов до загрузки tracker.js, инициализация сценариев после готовности DOM. Логика завязана на фронтенд-API inSales из common.v2.js — Shop, Cart, EventBus: глобальные объекты платформы, их нельзя переопределять и вызывать раньше, чем инициализирует шаблон.
Корзина не готова в момент загрузки страницы: перед SetCart или ClearCart скрипт рекурсивно проверяет, что Cart.order инициализирован. Подписки на EventBus (always:insales:cart, update_variant:insales:product, избранное) срабатывают только после запуска common.js — так данные в Mindbox совпадают с актуальным состоянием витрины, а не с промежуточным.
Сопоставлены справочники inSales и Mindbox: способы оплаты и статусы заказов — единые правила для API, вебхуков и триггеров. В Mindbox загружены идентификаторы клиентов, созданные в inSales, чтобы сохранить связки и не потерять аудиторию при переходе на новую платформу.
Учтена логика выбора модификации на витрине и предвыбора по ссылке с get-параметром variant_id: при открытии карточки отправляется просмотр конкретного варианта, без параметра — товара. Смена варианта на странице отслеживается через EventBus; первое техническое событие при инициализации отсекается, чтобы не дублировать просмотр при загрузке.
Вход детектируется по цепочке URL: переход с формы входа на страницу заказов с маркером auth_triggered. В операцию AuthorizeCustomer передаётся websiteID клиента из данных страницы. UUID устройства Mindbox из cookie подставляется в кастомное поле клиента в момент авторизации — для связки фронтенд-сессии с серверными скриптами inSales.
Статус оплаты передаётся отдельно через дополнительное поле заказа — гранулярность статусов в inSales и Mindbox различается. Способы доставки и оплаты включены в payload заказа по согласованным справочникам. Скидки, смена статусов и состава заказа синхронизируются через API и вебхуки с валидацией перед отправкой в Mindbox.
Корзина передаётся как список позиций с идентификатором productId_variantId, количеством и ценой; при пустой корзине — операция очистки. Избранное синхронизируется по событиям FavoritesProducts при добавлении и удалении. Все вызовы на витрине — асинхронные, без блокировки интерфейса магазина.
Интеграция с Mindbox разработана на inSales с нуля — без потери данных, на согласованных правилах. В Mindbox попадают только валидированные данные: корректные SKU, мультикатегории и статусы заказов.
Механики доработаны по бизнес-процессам, данные дополнены для новых триггеров. Маркетинговая команда может запускать триггерные сценарии: поведение на сайте, корзина, избранное, статусы заказов, подписки (включая форму в подвале) и кастомный лист ожидания.
