Mindbox

Доступные операции

Клиенты:
  • Создать клиента.

  • Обновить клиента.

  • Поиск клиента.

  • Поиск клиента по ID.

  • Добавить заметку клиенту.

Пользователи:
  • Поиск пользователя по Email.

  • Поиск пользователя по ID.

Заказы:
  • Создать заказ.

  • Обновить заказ.

  • Поиск заказа.

Ассортимент и склад:
  • Получить ассортимент.

  • Обновление цен (бета-версия).

  • Обновление запасов (бета-версия).

Уведомления:
  • Всплывающее уведомление о вызове.

Добавление коннектора

Для работы коннектора, в Mindbox необходимо создать операции по каждому инструменту, а также получить в личном кабинете ID конечной точки и Секретный ключ.

Подготовка

Шаг 1. Перейдите в раздел «Кампании»

  • Откройте Mindbox.

  • Перейдите в раздел Кампании.

Шаг 2. Создайте операцию

  1. Нажмите Создать кампанию → Операция

  2. Выберите папку, где будет храниться операция

  3. Нажмите Создать

Шаг 3. Настройте параметры операции

Выберите точку интеграции

  • Сайт, лендинг, касса, мобильное приложение

  • Можно выбрать несколько точек с одинаковыми настройками

Выберите тип операции

Тип Описание

Стандартная

Обычная скорость обработки (для большинства задач)

Приоритетная

Мгновенная обработка (для авторизации, регистрации, начисления баллов)

Дополнительные флаги (по необходимости)

  • «Запускает транзакционный сценарий»

  • «Операция требует передачи deviceUUID»

  • «Операция требует передачи секретного сервисного ключа»

  • «Операция возвращает валидационные ошибки»

Шаг 4. Настройте шаги операции

Шаги делятся на категории:
  • Шаги для работы с клиентами.

  • Шаги-действия (зависимые шаги).

Шаги для работы с клиентами

Добавление в базу
Шаг Описание

Зарегистрировать

Регистрация в ЛК или программе лояльности

Создать и подписать на рассылки

Подписка через формы или web-push

Импортировать

Создать нового или обновить существующего

Работа с существующими клиентами

Для авторизованных клиентов (уверены в личности)

  • Получить существующего

  • Редактировать

  • Дополнить

Для неавторизованных клиентов (не уверены в личности)

  • Получить существующего

  • Редактировать (только зону/город)

  • Зарегистрировать или дополнить

Шаги-действия (зависимые шаги)

После выбора типа клиента становятся доступны:

  • Оформление заказа

  • Установка списка товаров (корзина, избранное)

  • Отправка Email или SMS

  • Выдача действий

  • Изменение баланса

Шаги связаны между собой. Например, шаг «Оформление заказа» доступен только после выбора клиента.

Шаг 5. Сохраните и получите документацию

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

  2. Нажмите «Посмотреть описание» — система автоматически сгенерирует:

    • Описание вызова

    • Форматы передачи данных

    • Тело запроса

    • Примеры вызова и ответа

Шаг 6. Отладка и мониторинг

  • Мониторинг интеграции — список операций с количеством ошибок

  • Лог вызовов операций — детализация ошибочных вызовов

  • Включите флаги валидации для анализа ошибок в ответе

Применительно к коннектору в GigaCowork

Коннектор Mindbox, доступный для подключения, поддерживает следующие операции, которые должны быть предварительно настроены в Mindbox:

Инструмент коннектора Требуемая операция в Mindbox

Создать клиента (Sync/Async)

Операция с шагом «Зарегистрировать» или «Создать и подписать»

Обновить клиента

Операция с шагом «Редактировать клиента»

Получить информацию о клиенте

Операция с шагом «Получить существующего»

Создать/обновить заказ

Операция с шагами «Клиент» + «Оформление заказа»

Выдать действие

Операция с шагом «Выдача действий»

Отправить email-рассылку

Операция с шагом «Отправка Email»

Обновить статус линий заказа

Операция с шагом обновления статуса заказа

Получить ассортимент

Операция экспорта товаров

Перед подключением коннектора в GigaCowork убедитесь, что в Mindbox созданы соответствующие операции с нужными шагами для каждого инструмента, который планируете использовать.

Получение ID конечной точки и Секретного ключа

Для получения ID конечной точки и Секретного ключа:
  1. Перейдите в ЛК Mindbox → Интеграции → Редактировать интеграцию.

    connector mindbox 0

  2. Скопируйте два значения из блока Про точку интеграции:

    • ID конечной точки — Имя.

    • Секретный ключ — Секретный сервисный ключ.

    connector mindbox 1

Добавление

Для работы с коннектором:
  1. Проверьте, что коннектор находится в разделе button blocks Коннекторы. Если его нет, попросите администратора GigaCowork подключить его.

  2. Откройте коннектор и нажмите Войти в аккаунт. Коннектор уже может быть авторизован администратором, а кнопка входа и выхода из аккаунта недоступна. Это означает, что с коннектором уже можно работать.

  3. Укажите:

    • Endpoint ID — ID конечной точки из личного кабинета.

    • secretKey — секретный сервисный ключ из личного кабинета.

    • Domain — свой домен.

    • Customer Custom fields, Email Custom Fields и так далее — пользовательские поля сущностей,которые вы завели в Mindbox. CustomFields — это гибкий механизм для хранения данных, которые не входят в стандартный набор полей (например, email, firstName). Они позволяют расширять информацию о различных сущностях и используются для сегментации, персонализации и в сценариях автоматизации.