Модуль интеграции Mindbox и RetailCRM

На вкладке «Доступ Mindbox» укажите реквизиты точки интеграции — их выдаёт менеджер Mindbox в разделе «Интеграции» вашего проекта:

• Идентификатор точки интеграции Mindbox (endpointId) — системное имя точки интеграции.
• Секретный ключ Mindbox — ключ авторизации запросов к API.
• Device UUID запросов к Mindbox — необязательное поле; заполняется, если ваша конфигурация Mindbox требует передавать deviceUUID в запросах.
• Системное имя Бренда — бренд, к которому относятся подписки клиентов.

После сохранения модуль готов отправлять запросы в синхронные операции Mindbox API v3.

Вкладка «(v2) Клиенты» отвечает за передачу покупателей из RetailCRM в Mindbox.

Условия передачи. Флажок «Передавать клиентов без заказов» включает выгрузку всей клиентской базы, а не только заказчиков. В таблице операций укажите названия операций вашей точки интеграции Mindbox:

• Импортировать клиента RetailCRM в Mindbox — создание профиля;
• Поиск существующего клиента по номеру телефона — проверка перед созданием, чтобы не плодить дубли (поиск идёт по телефону, затем по e-mail);
• Редактировать клиента — обновление данных профиля при изменениях в CRM;
• Подтвердить мобильный телефон — автоподтверждение номера после импорта.

Операция, оставленная пустой, просто не используется. Клиент передаётся с ФИО, телефоном, e-mail, полом, датой рождения и пользовательскими полями.

Идентификаторы. Внутренний идентификатор клиента Mindbox — всегда mindboxId. Во втором поле укажите ключ, в котором Mindbox хранит ID клиента RetailCRM (например, websiteID).

Подписки. Задайте системное имя бренда и, при необходимости, тематику и канал подписки (Email, SMS, Viber, Webpush, Mobilepush). Статус подписки модуль берёт из карточки клиента RetailCRM отдельно по каждому каналу, поэтому покупатель, отписавшийся от писем, но согласный на SMS, приедет в Mindbox именно так. Флажок «Передавать подписки раздельно» отправляет две записи — по Email и по SMS.

Только клиенты с e-mail. Флажок «Передавать только клиентов и заказы с email» отсекает покупателей без адреса: такой клиент не уходит в Mindbox, а его заказ пропускается целиком. Опция выключена по умолчанию — включайте её, если Mindbox нужен для e-mail рассылок и профили без адреса вам не интересны.

Мгновенное обновление по триггеру. Без триггера данные покупателя попадают в Mindbox при обработке его заказов. Чтобы подписки и контакты обновлялись сразу после правки карточки, настройте триггер в RetailCRM:

• на вкладке «Доступ» скопируйте адрес из поля «Хук для триггера на изменение клиента (v2)»;
• в RetailCRM создайте триггер на изменение клиента с действием «Выполнить HTTP-запрос» по этому адресу;
• подстановка {{customer.id}} внутри адреса передаёт модулю конкретного покупателя — обрабатывается только он, без перебора базы.

Получив вызов, модуль найдёт клиента в Mindbox и обновит профиль, а если его там ещё нет — создаст.

Вкладка «(v2) Заказы» — основная логика обмена заказами.

Условия передачи. В поле «Способы оформления заказов» выберите, какие заказы участвуют в обмене (пустое поле — все). Далее для каждой операции укажите её название в Mindbox и статусы заказа RetailCRM, при которых она вызывается:

• Процессинг — Расчёт заказа — Mindbox рассчитывает акции, скидки и доступные бонусы; результат возвращается в заказ RetailCRM;
• Процессинг — Создать и обновить заказ — фиксация заказа в Mindbox (начисление и списание баллов по правилам программы лояльности);
• Обновить статус позиций заказа — передача смены статусов, включая отмену;
• Обновить дополнительные поля заказа — отправка произвольных полей из вкладки «Сопоставление полей».

Идентификаторы. Укажите ключи, в которых Mindbox хранит внутренний ID заказа RetailCRM и внешний ID (номер заказа с сайта). Флажок «Передавать идентификатор Mindbox для внешнего ID заказа при расчёте» нужен, если расчёт должен идти по уже существующему в Mindbox заказу.

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

Маркетинговые правила. Создайте в RetailCRM два пользовательских поля заказа: числовое — для суммы списываемых бонусов и строковое — для промокода, и выберите их в этих настройках. Менеджер вводит значение в поле заказа — модуль передаёт его в Mindbox и возвращает пересчитанные цены позиций.

Вкладка «(v2) Товары» — как позиции заказа сопоставляются с продуктами Mindbox.

• Идентификаторы — выберите, по какому полю товара RetailCRM идёт сопоставление (Внешний ID или xmlId), и укажите идентификатор товарного каталога в Mindbox. Отдельно задаётся код статуса, который получат позиции при удалении заказа в RetailCRM.
• Особенности передачи цен — флажок отключает возврат пересчитанных цен из Mindbox в заказ RetailCRM. Для товаров-услуг (например, доставка, у которой количество зависит от цены) добавьте их идентификаторы в отдельный список — их цены пересчитываться не будут.
• Свойства товаров — источник скидки для Mindbox: стандартное поле скидки товара или отдельное свойство, а также свойства с ценой продажи.
• Сопоставление статусов товаров — каждому статусу позиции RetailCRM назначьте код статуса Mindbox.

Вкладка «(v2) Сопоставление полей» — произвольные поля сверх стандартного набора. В левой колонке выберите поле заказа или заказчика RetailCRM (включая пользовательские поля), в правой — введите код поля Mindbox. Строки добавляются и удаляются кнопками «+» и «корзина».

После настройки всех вкладок обмен запускается автоматически. Ошибки обмена смотрите на вкладке «Логи ошибок»; если что-то не получается — напишите в поддержку через раздел «Поддержка» в модуле.