Обновить триггерную рассылку

Описание

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

URL-адрес

Метод: POST

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

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

Параметр	Тип	Пример	Обязательный	Описание
token	string	"abcdefghijklmnqrstuvwxyz"	Да	API-токен
format	string	"csv"	Нет	Формат возвращаемых данных по умолчанию – "json"
id	int	1	Да	Идентификатор триггера
name	string	"New Awesome Campaign"	Да	Название рассылки
is_active	bool	true	Нет	Статус рассылки
content	JSON array	[ { "from_email": "", "from_name": "", "message_id": 12, "replyto_email": "", "replyto_name": "", "subject": "Weather alert" } ]	Нет	Контент, присоединенный к рассылке
subid	string	"Adv_1"	Нет	Subid рассылки
trigger_type	string	"api_call"	Да	Тип триггера
skip_minutes	int	0	Нет	Подождать Х минут перед активацией рассылки
resource_id	int	24	Да	Идентификатор ресурса
policy_id	int	1	Нет	Идентификатор политики отправки
push_sending_mode	string	"fanout" (по умолчанию) "last"	Нет	Режим отправки push-сообщений (только для push-каналов)
attributes	object	"season":"2024_summer"	Нет	Атрибуты, назначенные рассылке, и их значения
Smart настройки
virtual_sender_id	int	12	Нет	Идентификатор виртуального сендера Только для smart-аккаунтов
is_random_trk_prefix	bool	false	Нет	Случайный префикс трекинг-домена Только для smart-аккаунтов
custom_trk_domain	JSON array	["trk.example.com", "trk2.example.com"]	Нет	Список трекинг-доменов Только для smart-аккаунтов
blind_carbon_copy	JSON array	["john@example.com", "george@example.com"]	Нет	Адреса для скрытой копии Только для smart-аккаунтов
unconditional_sending	bool	true	Нет	Отправка вне зависимости от статуса подписки Только для smart-аккаунтов

примечание

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

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

Поле	Тип	Описание	api_call	api_import	action	update	pixel	subscribe
action	string	Тип запуска, основанный на действии	Нет	Нет	Да	Нет	Нет	Нет
update_query	JSON array	Обновление полей профиля: { "fieldname": "custom_ID", "fieldtype": "int", "operator": "equal", "value": "2000" }	Нет	Нет	Нет	Да	Нет	Нет
link_name	string	Имя ссылки в сообщении	Нет	Нет	Да	Нет	Нет	Нет
message_id	int	Идентификатор шаблона сообщения для событий захвата	Нет	Нет	Да	Нет	Нет	Нет
list_id	int	Идентификатор базы данных	Да	Да	Нет	Да	Нет	Нет
subscribe_resource_id	int	Идентификатор ресурса подписки, на которую реагирует триггер	Нет	Нет	Нет	Нет	Нет	Да
channel	string	Канал на который реагировать	Нет	Нет	Нет	Нет	Нет	Да
is_new_sub	bool	Реагировать на новый ресурс	Нет	Нет	Нет	Нет	Нет	Да
is_new_ch	bool	Реагировать на новый канал в ресурс	Нет	Нет	Нет	Нет	Нет	Да
is_new_contact	bool	Реагировать на новый контакт в канале	Нет	Нет	Нет	Нет	Нет	Да
is_status_changed	bool	Реагировать на смену статуса на перечисленные в trigger_statuses	Нет	Нет	Нет	Нет	Нет	Да
trigger_statuses	array(int)	Статусы новых/измененных подписок, на которые реагирует триггер	Нет	Нет	Нет	Нет	Нет	Да
pixel_id	int	Идентификатор пикселя для захвата событий	Нет	Нет	Нет	Нет	Да	Нет

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

JSON

{
  "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
}

XML

<xml>
    <token>abcdefghijklmnqrstuvwxyz</token>
    <id>42</id>
    <name>New trigger campaign 3</name>
    <content array='true'>
        <from_email/>
        <from_name>James</from_name>
        <message_id>15</message_id>
        <replyto_email/>
        <replyto_name/>
        <subject>Maybe very important message</subject>
    </content>
    <trigger_type>api_call</trigger_type>
    <list_id>1</list_id>
</xml>

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

JSON

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

XML

<xml>
    <error>0</error>
    <error_text>Successful operation</error_text>
    <data>
        <saved_id>42</saved_id>
        <trigger_link>http://trk.example.com:8095/trg/3a345a07f01657e7966566e657a34d023a345a07f01802e7/&lt;email|md5|xxh&gt;</trigger_link>
    </data>
</xml>

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

Параметр	Тип	Описание
error	int	Код ошибки
error_text	string	Текст ошибки
saved_id	int	12
trigger_link	string	Только если trigger_type = "api_call"