Клиент

Массовый импорт клиентов

В инструкции описаны примеры POST-запросов. Интеграция с Mindbox не будет работать, если использовать запросы из примеров ниже без редактирования.

Операции именно под вашу задачу создает и описывает в техническом задании менеджер проекта, если у вас нет такого документа, то обратитесь к вашему менеджеру.

Описание метода

Осуществляется с помощью POST-запроса. Адрес запроса и набор принимаемых полей настраиваются в системе Майндбокс.

Массовый импорт клиентов
POST https://api.mindbox.ru/v3/operations/bulk?endpointId={уникальный идентификатор сайта и т.п.}&operation=DirectCrm.Customers.Import&csvCodePage=65001&csvColumnDelimiter=%3B&csvTextQualifier=%22&segment={Системное имя сегмента для клиентов}&SourceActionTemplate={Действие регистрации клиента}&transactionId={Значение ключа идемпотентности в формате GUID}

Authorization: SecretKey {Секретный ключ}
Accept: application/json
Content-Type: text/csv;charset=utf-8

Параметры запроса

csvCodePage - идентификатор кодовой страницы Windows для CSV-файла. Предпочтительно использовать 65001 (UTF-8).
csvColumnDelimiter - символ, использующийся для разделения колонок в CSV-файле.
csvTextQualifier - символ, опционально добавляющийся в начале и в конце значения колонки, позволяя использовать в нём символы, обычно не разрешённые.
endpointId - точка доступа, из которой будут взяты настройки интеграции. Значение настраивается в системе.
segment - cистемное имя сегмента
SourceActionTemplate - действие регистрации клиента. Например, "Регистрация на сайте" или "Заполнение бумажной анкеты в магазине". Значение настраивается в системе.
transactionId - ключ идемпотентности, позволяющий избежать повторного выполнения запроса. Ключ идемпотентности обязательно создавать в формате GUID (рекомендуется версия 4). Для повторных запросов c повторяющимся ключом в ответ вернется статус TransactionAlreadyProcessed.
данный сервис разрешает поставить не более 60 импортов в час. После превышения порога вы будете получать 429 Too Many Requests до тех пор, пока количество поставленных задач за час не опустится ниже 60.
максимальный размер принимаемого файла 200мб. В случае, если необходимо загрузить больший объем данных, данные нужно разбить на несколько файлов.
поддерживается формат gzip. Для этого веб-сервер должен вернуть заголовок Content-Encoding: gzip. При этом файл нужно прикрепить в бинарном виде (например, binary в postman)

Описание полей данных импорта

Заголовок	Описание
Websiteid	Идентификатор клиента на сайте
FirstName	Имя клиента
LastName	Фамилия клиента
MiddleName	Отчество клиента
MobilePhone	Мобильный телефон
Email	Емэйл клиента
BirthDate	Дата рождения в формате yyyy-MM-dd
SourceDateTimeUtc	Дата регистрации в формате yyyy-MM-dd HH:mm по UTC
SourcePointOfContact	Точка контакта регистрации, например "Сайт" или "Магазин на Тверской"
IsSubscribed	Статус подписки true/false
Дополнительное поле клиента	Значение дополнительного поля клиента

Все принимаемые поля описаны тут https://{системное_имя_проекта}.mindbox.ru/customers/import

Пример запроса

Массовый импорт клиентов
POST https://api.mindbox.ru/v3/operations/bulk?endpointId={уникальный идентификатор сайта и т.п.}&operation=DirectCrm.Customers.Import&csvCodePage=65001&csvColumnDelimiter=%3B&csvTextQualifier=%22&SourceActionTemplate=ZaregistrirovalsyaVLoyalnosti&editActionTemplate=OtredaktirovanNaSaite

Authorization: SecretKey {Секретный ключ}
Accept: application/json
Content-Type: text/csv;charset=utf-8


Email;BirthDate;SourceDateTimeUtc;SourcePointOfContact;LastName;FirstName;MiddleName;IsSubscribed
pelena@mindbox.ru;12.04.1982;16.04.2016 21:00;727;Петрова;Елена;Викторовна;1
pivan@mindbox.ru;16.01.1980;16.04.2016 21:00;727;Петров;Иван;Иванович;1

Last modified on November 6, 2026

Подтверждение мобильного телефона и подписки на СМС Массовый импорт карт и клиентов