Массовый импорт профилей + отправка триггера

Описание

Добавление или обновление нескольких профилей с последующей отправкой триггерной кампании.

Данный запрос является batch-версией запроса Импорт профиля + Отправка триггера.

примечание

Тело запроса ограничено по умолчанию до 10мб, исключение: файлы — 100мб.

URL-адрес

Метод: POST

http://example.com/api/v1.1/campaigns/triggers/import_and_start_batch

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

Параметр	Тип	Пример	Обязательный	Описание
Импорт профиля клиента
token	string	"abcdefghijklmnqrstuvwxyz"	Да	API токен
data	JSON object	[    {       "data": {          "_fname": "John",          "_lname": "Lambert",          "email": "profile4@example.com",          "phones": "+79000000000"       }    },    {       "data": {          "_fname": "Tom",          "_lname": "Hard",          "email": "profile3@example.com",          "phones": "+79000000001"       }    } ]	Нет	Данные о профиле, в том числе подписки. Каждый профиль — это отдельный JSON-объект "data".
skip_triggers	bool	true	Нет	Пропустить запуск триггеров. По умолчанию – false.
skip_invalid_subscriptions	bool	true	Нет	Пропустить невалидные подписки. По умолчанию – false.
detect_geo	bool	true	Нет	Включает автоопределение geo данных по полю _regip или _ip в data
Поиск профиля подписчика для обновления
matching	string	"email" "email_profile" "phone" "profile_id" "custom"	Нет, если поиск по email из профиля или подписок	Режим поиска подписчика. по умолчанию - email. Подробнее.
email	string	"john@example.com"	"matching":"email" - по профилю и подпискам "matching":"email_profile" - только по профилю	Email-адрес
phone	string	"+79000000000"	"matching":"phone"	Номер телефона
profile_id	string	"abcdefghijklmnqrstuvwxyz"	"matching":"profile_id"	Идентификатор профиля
field_name	string	"CRM_ID"	"matching":"custom"	Название кастомного поля профиля для поиска.
field_value	int/string	"12345"	"matching":"custom"	Значение кастомного поля для поиска. подсказка Доступен поиск по сочетанию значений поля с типом "теги". Теги передаются в строке черз запятую: "тег_1, тег_2".
resource_id	int	24	Нет	Идентификатор ресурса для поиска по email и phone
Запуск триггера
trigger_id	int	13	Да	Идентификатор триггерной кампании для запуска
timeout	JSON object	{ "days": 0, "hours": 0, "minutes": 5 }	Нет	Задержка перед запуском триггера. Указываются дни, часы и минуты.
custom_data	JSON object	{ "sending_time": "12:31:12" }	Нет	Данные для Захвата событий (Action hooks). Можно передавать как в корне запроса, так и в каждом объекте data отдельно.
content	JSON object	{ "page": "registration_form" }	Нет	Дополнительные данные для подстановки в шаблон сообщения переменной {apicontent.fieldname}
attach	JSON objects array	{ "data": "data:text/csv;base64,SEVMTE8K", "name": "Attach.txt" }	Нет	Файл для прикрепления к email сообщению (только для email триггеров)

Возвращаемые параметры

Параметр	Тип	Описание
error_text	string	Текст ошибки
error	int	Код ошибки
result	array	Идентификаторы (profile_id) успешно импортированных профилей

Пример запроса с матчингом по email

{
	"token": "abcdefghijklmnqrstuvwxyz",
	"trigger_id": 8,
	"format": "json",
	"skip_triggers": false,
	"detect_geo": true,
	"matching": "email",
	"data": [
		{
			"data": {
				"_fname": "John",
				"_lname": "Lambert",
				"email": "profile4@example.com",
				"phones": "+79000000000"
				}
		},
		{
			"data" : {
				"_fname": "Tom",
				"_lname": "Hard",
				"email": "profile3@example.com",
				"phones": "+79000000001"
			}
		}
	]
}

Пример запроса с матчингом по custom-полю

{
	"token": "abcdefghijklmnqrstuvwxyz",
	"trigger_id": 455,
	"format": "json",
	"skip_triggers": false,
	"detect_geo": true,
	"matching": "custom",
	"field_name": "New_field_1",
	"data": [
		{
			"data": {
				"_fname": "NUMBER1",
				"_lname": "Lambert",
				"email": "profile01@example.com",
				"phones": "+79000000000",
				"New_field_1" : "0002"
			}
		},
		{
			"data" : {
				"_fname": "NUMBER2",
				"_lname": "Hard",
				"email": "profile02@example.com",
				"phones": "+79000000001",
				"New_field_1" : "0001"
			}
		}
	]
}

Пример ответа

{
	"error": 0,
	"error_text": "Successful operation",
	"result": [
		{
			"profile_id": "602103d65ae47a3bc65d5d83"
		},
		{
			"profile_id": "601ec71c5ae47a15d1c9b472"
		}
	]
}

Пример ответа при срабатывании ограничения запроса

{
	"error": 400,
	"error_debug": "http: request body too large",
	"error_text": "Invalid request"
}