Mindbox
Доступные операции
-
Создать клиента.
-
Обновить клиента.
-
Поиск клиента.
-
Поиск клиента по ID.
-
Добавить заметку клиенту.
-
Поиск пользователя по Email.
-
Поиск пользователя по ID.
-
Создать заказ.
-
Обновить заказ.
-
Поиск заказа.
-
Получить ассортимент.
-
Обновление цен (бета-версия).
-
Обновление запасов (бета-версия).
-
Всплывающее уведомление о вызове.
Добавление коннектора
Для работы коннектора, в Mindbox необходимо создать операции по каждому инструменту, а также получить в личном кабинете ID конечной точки и Секретный ключ.
Подготовка
Шаг 1. Перейдите в раздел «Кампании»
-
Откройте Mindbox.
-
Перейдите в раздел Кампании.
Шаг 2. Создайте операцию
-
Нажмите «Создать кампанию» → «Операция»
-
Выберите папку, где будет храниться операция
-
Нажмите «Создать»
Шаг 3. Настройте параметры операции
Выберите точку интеграции
-
Сайт, лендинг, касса, мобильное приложение
-
Можно выбрать несколько точек с одинаковыми настройками
Выберите тип операции
| Тип | Описание |
|---|---|
Стандартная |
Обычная скорость обработки (для большинства задач) |
Приоритетная |
Мгновенная обработка (для авторизации, регистрации, начисления баллов) |
Дополнительные флаги (по необходимости)
-
«Запускает транзакционный сценарий»
-
«Операция требует передачи deviceUUID»
-
«Операция требует передачи секретного сервисного ключа»
-
«Операция возвращает валидационные ошибки»
Шаг 4. Настройте шаги операции
-
Шаги для работы с клиентами.
-
Шаги-действия (зависимые шаги).
Шаги для работы с клиентами
Добавление в базу
| Шаг | Описание |
|---|---|
Зарегистрировать |
Регистрация в ЛК или программе лояльности |
Создать и подписать на рассылки |
Подписка через формы или web-push |
Импортировать |
Создать нового или обновить существующего |
Работа с существующими клиентами
Для авторизованных клиентов (уверены в личности)
-
Получить существующего
-
Редактировать
-
Дополнить
Для неавторизованных клиентов (не уверены в личности)
-
Получить существующего
-
Редактировать (только зону/город)
-
Зарегистрировать или дополнить
Шаги-действия (зависимые шаги)
После выбора типа клиента становятся доступны:
-
Оформление заказа
-
Установка списка товаров (корзина, избранное)
-
Отправка Email или SMS
-
Выдача действий
-
Изменение баланса
| Шаги связаны между собой. Например, шаг «Оформление заказа» доступен только после выбора клиента. |
Шаг 5. Сохраните и получите документацию
-
Нажмите «Добавить»
-
Нажмите «Посмотреть описание» — система автоматически сгенерирует:
-
Описание вызова
-
Форматы передачи данных
-
Тело запроса
-
Примеры вызова и ответа
-
Шаг 6. Отладка и мониторинг
-
Мониторинг интеграции — список операций с количеством ошибок
-
Лог вызовов операций — детализация ошибочных вызовов
-
Включите флаги валидации для анализа ошибок в ответе
Применительно к коннектору в GigaCowork
Коннектор Mindbox, доступный для подключения, поддерживает следующие операции, которые должны быть предварительно настроены в Mindbox:
| Инструмент коннектора | Требуемая операция в Mindbox |
|---|---|
Создать клиента (Sync/Async) |
Операция с шагом «Зарегистрировать» или «Создать и подписать» |
Обновить клиента |
Операция с шагом «Редактировать клиента» |
Получить информацию о клиенте |
Операция с шагом «Получить существующего» |
Создать/обновить заказ |
Операция с шагами «Клиент» + «Оформление заказа» |
Выдать действие |
Операция с шагом «Выдача действий» |
Отправить email-рассылку |
Операция с шагом «Отправка Email» |
Обновить статус линий заказа |
Операция с шагом обновления статуса заказа |
Получить ассортимент |
Операция экспорта товаров |
| Перед подключением коннектора в GigaCowork убедитесь, что в Mindbox созданы соответствующие операции с нужными шагами для каждого инструмента, который планируете использовать. |
Получение ID конечной точки и Секретного ключа
-
Перейдите в ЛК Mindbox → Интеграции → Редактировать интеграцию.

-
Скопируйте два значения из блока Про точку интеграции:
-
ID конечной точки — Имя.
-
Секретный ключ — Секретный сервисный ключ.

-
Добавление
-
Проверьте, что коннектор находится в разделе
Коннекторы. Если его нет, попросите администратора GigaCowork подключить его. -
Откройте коннектор и нажмите Войти в аккаунт. Коннектор уже может быть авторизован администратором, а кнопка входа и выхода из аккаунта недоступна. Это означает, что с коннектором уже можно работать.
-
Укажите:
-
Endpoint ID — ID конечной точки из личного кабинета.
-
secretKey — секретный сервисный ключ из личного кабинета.
-
Domain — свой домен.
-
Customer Custom fields, Email Custom Fields и так далее — пользовательские поля сущностей,которые вы завели в Mindbox. CustomFields — это гибкий механизм для хранения данных, которые не входят в стандартный набор полей (например, email, firstName). Они позволяют расширять информацию о различных сущностях и используются для сегментации, персонализации и в сценариях автоматизации.
-