Перейти к основному содержимому

Обновить триггер кампанию

Описание​

Изменить настройки существующей триггер-кампании.

URL-адрес​

Метод: POST

https://example.com/api/v1.1/campaigns/triggers/update/

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

ПараметрТипПримерОбязательныйОписание
tokenstring"abcdefghijklmnqrstuvwxyz"ДаAPI токен
formatstring"csv"НетФормат возвращаемых данных
по умолчанию – "json"
idint1ДаИдентификатор триггера
namestring"New Awesome Campaign"ДаНазвание кампании
is_activebooltrueНетСтатус кампании
contentJSON array
[
 {
 "from_email": "",
 "from_name": "",
 "message_id": 12,
 "replyto_email": "",
 "replyto_name": "",
 "subject": "Weather alert"
 }
]
НетКонтент, присоединенный к кампании
subidstring"Adv_1"НетSubid кампании
trigger_typestring"api_call"ДаТип триггера
skip_minutesint0НетПодождать Х минут перед активацией кампании
resource_idint24ДаИдентификатор ресурса
policy_idint1НетИдентификатор политики отправки
push_sending_modestring"fanout" (по умолчанию)
"last"		НетРежим отправки push-сообщений (только для push-каналов)
Smart настройки
virtual_sender_idint12НетИдентификатор виртуального сендера
Только для smart-аккаунтов
is_random_trk_prefixboolfalseНетСлучайный префикс трекинг-домена
Только для smart-аккаунтов
custom_trk_domainJSON array["trk.example.com", "trk2.example.com"]НетСписок трекинг-доменов
Только для smart-аккаунтов
blind_carbon_copyJSON array["john@example.com", "george@example.com"]НетАдреса для скрытой копии
Только для smart-аккаунтов
unconditional_sendingbooltrueНетОтправка вне зависимости от статуса подписки
Только для smart-аккаунтов

примечание

Изменять канал в уже сохраненной кампании нельзя. При передаче соответствующих параметров — send_channel, content_type, send_email_content, send_sms_content, send_push_content — запрос не вернет ошибку, но и не обновит канал отправки.

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

ПолеТипОписаниеapi_callapi_importactionupdatepixelsubscribe
actionstringТип запуска, основанный на действииНетНетДаНетНетНет
update_queryJSON arrayОбновление полей профиля:
{ 
 "fieldname": "custom_ID",
 "fieldtype": "int",
 "operator": "equal",
 "value": "2000" 
 }
НетНетНетДаНетНет
link_namestringИмя ссылки в сообщенииНетНетДаНетНетНет
message_idintИдентификатор шаблона сообщения для событий захватаНетНетДаНетНетНет
list_idintИдентификатор базы данныхДаДаНетДаНетНет
subscribe_resource_idintИдентификатор ресурса подписки, на которую реагирует триггерНетНетНетНетНетДа
channelstringКанал на который реагироватьНетНетНетНетНетДа
is_new_subboolРеагировать на новый ресурсНетНетНетНетНетДа
is_new_chboolРеагировать на новый канал в ресурсНетНетНетНетНетДа
is_new_contactboolРеагировать на новый контакт в каналеНетНетНетНетНетДа
is_status_changedboolРеагировать на смену статуса на перечисленные в trigger_statusesНетНетНетНетНетДа
trigger_statusesarray(int)Статусы новых/измененных подписок, на которые реагирует триггерНетНетНетНетНетДа
pixel_idintИдентификатор пикселя для захвата событийНетНетНетНетДаНет

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

{
  "token": "abcdefghijklmnqrstuvwxyz",
  "id": 42,
  "name": "New trigger campaign update",
  "content": [
    {
      "subject": "Maybe not very important message",
      "from_email": "",
      "from_name": "Alex",
      "replyto_email": "",
      "replyto_name": "",
      "message_id": 8
    }
  ],
  "trigger_type": "api_call",
  "list_id": 1
}

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

{
  "data": {
    "saved_id": 42,
    "trigger_link": "http://trk.example.com:8095/trg/3a345a07f01657e7966566e657a34d023a345a07f01802e7/<email|md5|xxh>"
  },
  "error": 0,
  "error_text": "Successful operation"
}

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

ПараметрТипОписание
errorintКод ошибки
error_textstringТекст ошибки
saved_idint12
trigger_linkstringТолько если trigger_type = "api_call"
Последнее обновление