Задание на массовый импорт профилей + отправка триггера
Описание
Добавление или обновление нескольких профилей с последующей отправкой триггерн ой кампании.
Данный запрос является batch-версией запроса Импорт профиля + Отправка триггера.
Возвращает ответ с id таска, не дожидаясь выполнения.
примечание
Тело запроса ограничено по умолчанию до 10мб, исключение: файлы — 100мб.
URL-адрес
Метод: POST
http://example.com/api/v1.1/campaigns/triggers/import_and_start_batch_task
Параметры запроса
Параметр | Тип | Пример | Обязательный | Описание |
---|---|---|---|---|
Импорт профиля клиента | ||||
token | string | "abcdefghijklmnqrstuvwxyz" | Да | API токен |
data | array | [ | нет | Данные о профиле, в том числе подписки. Каждый профиль — это отдельный 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. |
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 |
| Нет | Задержка перед запуском триггера. Указываются дни, часы и минуты. |
custom_data | JSON object |
| Нет | Данные для Захвата событий. Можно передавать как в корне запроса, так и в каждом объекте data отдельно. |
content | JSON object |
| Нет | Дополнительные данные для подстановки в шаблон сообщения переменной {apicontent.fieldname} |
attach | JSON objects array |
| Нет | Файл д ля прикрепления к email сообщению (только для email триггеров) |
Возвращаемые параметры
Параметр | Тип | Описание |
---|---|---|
error_text | string | Текст ошибки |
error | int | Код ошибки |
task_id | string | Идентификатор задачи |
Пример запроса с матчингом по email
{
"token": "abcdefghijklmnqrstuvwxyz",
"matching": "email",
"data": [
{
"data": {
"_fname": "John",
"_lname": "Lambert",
"email": "profile4@example.com",
"phones": "+79000000000",
"subscriptions": [
{
"channel": "email",
"email": "example@example.com",
"resource_id": 1
},
{
"channel": "phone",
"phone": "+79000000000",
"resource_id": 1
}
]
}
},
{
"data": {
"_fname": "Tom",
"_lname": "Hard",
"email": "profile3@example.com",
"phones": "+79000000001",
"subscriptions": [
{
"channel": "email",
"email": "example@example.com",
"resource_id": 1
},
{
"channel": "phone",
"phone": "+79000000000",
"resource_id": 1
}
]
}
}
],
"trigger_id": 13,
"timeout": {
"days": 0,
"hours": 0,
"minutes": 5
},
"content": {
"page": "registration_form"
},
"attach": [
{
"data": "data:text/csv;base64,5LuK5pel44GvCg==",
"name": "Attach.txt"
}
]
}
Пример запроса с матчингом по 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",
"task_id": "30421978-7f6d-4f39-913f-fb6cad8e2477"
}