Справочник по точкам

Каждая точка содержит объект point_data с ровно одним вложенным ключом, соответствующим point_type точки (см. соответствие point-type → ключ). На этой странице документируется структура под каждым ключом.

Примечание

Точки входа, времени, разделения, действия и конверсии полностью документированы ниже.

Для точек отправки сообщений (send_*, inapp) на этой странице рассматриваются только структурные поля: какой пресет или контент использовать и какие настройки канала передавать. Само содержимое сообщения определяется в пресете и документировано в API пресетов и в документации по каждому каналу. Некоторые поля ссылаются на вложенные объекты, которые отражают элементы управления в конструкторе Customer Journey.

Точки входа

Journey должен иметь хотя бы одну точку входа. Все точки входа имеют один вывод default.

start_by_segment

Добавляет пользователей, которые соответствуют сегменту. POINT_TYPE_START_BY_SEGMENT.

Поле	Тип	Описание
application_code	string	Код приложения.
filter_code	string	Код сегмента/фильтра, который определяет аудиторию.
repeat	SegmentRepeat	Необязательное расписание для повторяющегося входа (см. SegmentRepeat).
start_at	timestamp	Не обрабатывать до этого времени (ISO 8601).
is_deactivated	bool	Выключена ли эта точка входа.

message_bus (вход по событию)

Добавляет пользователей, когда они вызывают событие. POINT_TYPE_EVENT.

Поле	Тип	Описание
event_name	string	Имя события, которое нужно отслеживать.
application_code	string	Код приложения.
event_conditions	PointEventCondition[]	Условия, сопоставляемые с атрибутами события.
active_period	Period	Временное окно, в течение которого триггер активен.
multi_entry	MultiEntry	Как пользователь может войти более одного раза (см. MultiEntry).
attribute_entry	AttributeEntry	Регистрировать User ID, содержащиеся в атрибуте события, вместо пользователя, который вызвал событие (см. AttributeEntry).
allow_reenter	bool	Могут ли пользователи повторно входить в Journey.

AttributeEntry

Регистрирует User ID, содержащиеся в атрибуте события, вместо пользователя, который вызвал событие. Отражает Пользователи из атрибута события в конструкторе Customer Journey.

Поле	Тип	Описание
enabled	bool	Регистрировать ли пользователей, указанных в атрибуте события, а не пользователя, который вызвал событие.
attribute_name	string	Имя атрибута события, который содержит User ID (или список User ID) для регистрации.

start_by_api

Точка входа, используемая вызовом Start by API. POINT_TYPE_START_BY_API.

Поле	Тип	Описание
application_code	string	Код приложения.
attributes	string[]	Имена кастомных атрибутов, которые могут быть переданы в attribute_values запроса Start by API.
is_deactivated	bool	Выключена ли эта точка входа.

Точки времени

delay (wait)

Приостанавливает каждого пользователя на фиксированный или вычисляемый интервал. POINT_TYPE_WAIT. Объект point_data.delay устанавливает ровно один из следующих ключей интервала:

Ключ интервала	Тип	Описание
sec	uint64	Ожидать фиксированное количество секунд.
exact_time	ExactTime	Ожидать до определенного времени суток (hour, minute).
exact_date_time	ExactDateTime	Ожидать до абсолютной даты и времени.
exact_week_days_time	ExactWeekDaysTime	Ожидать до определенного времени в определенные дни недели (соответствие дня 0=Понедельник … 6=Воскресенье → ExactTime).
dynamic_time	DynamicTime	Ожидать относительно значения из тега или события.

dynamic_time с split_branches: true добавляет ветвь output1 (см. ключи вывода).

DynamicTime

Поле	Тип	Описание
from	enum DynamicTimeFrom	Указывает, откуда берется базовое время: из тега или события.
direction	enum DynamicTimeDirection	Смещение до или после базового времени.
duration	uint64	Размер смещения.
unit	enum DynamicTimeUnit	Единица измерения duration (минуты, часы, дни, …).
split_branches	bool	Разделять пользователей на отдельные ветви, когда их вычисленное время отличается.
tag_name	string	Тег, содержащий базовое время (когда from — это тег).
event_name / event_attribute / point_id	string	Источник события базового времени (когда from — это событие).

wait_event

Ожидает, пока пользователи не вызовут событие (или не истечет время ожидания). POINT_TYPE_WAIT_EVENT. Вывод default — это путь для не сработавшего события. Путь для сработавшего события — output1 или, при использовании скрипта, одна ветвь на каждое условие.

Поле	Тип	Описание
events	PointWaitEventInfo[]	События, которых нужно ожидать.
conditions_script	string	Необязательный скрипт для сложной логики с несколькими событиями. Разобранные имена условий становятся ключами вывода.
multi_entry	MultiEntry	Поведение при повторном входе.

Точки разделения и фильтрации

boolean_splitter

Направляет пользователей по ветвям на основе условия. POINT_TYPE_BOOLEAN_SPLITTER.

Поле	Тип	Описание
split_strategy	enum	SPLIT_FILTER (по сегменту), SPLIT_TAGS (по условиям тегов) или SPLIT_EVENTS (по условиям событий).
load_policy	enum	ALL (любое из устройств пользователя может соответствовать) или FILTER (только текущее устройство).
filter_code	string	Код сегмента, когда split_strategy — SPLIT_FILTER.
filter_expressions	FilterExpression[]	Условия тегов, когда split_strategy — SPLIT_TAGS: одна дополнительная ветвь output на каждое выражение.
event	BooleanSplitterEventInfo	Условия событий, когда split_strategy — SPLIT_EVENTS: одна дополнительная ветвь output на каждое условие.

ab_splitter

Случайным образом разделяет пользователей на взвешенные варианты. POINT_TYPE_AB_SPLITTER. Ключи вывода — output0, output1, … (по одному на каждую запись в split, индексируется с 0. default отсутствует).

Поле	Тип	Описание
split	uint32[]	Процент для каждой ветви. Сумма должна быть равна 100. Индекс i соответствует ключу вывода output{i}.
auto_select_winner	bool	Автоматически ли выбирать выигрышную ветвь.
winner_strategy	enum	ANY_GOAL или SPECIFIC_GOAL.
goal_uuid	string	Цель, используемая для определения победителя (с SPECIFIC_GOAL).
winner_split	uint32	Номер выигрышной ветви (начиная с 1, 0 = победитель еще не определен).

filter

Позволяет продолжать движение только соответствующим пользователям (default), направляя остальных в output1. POINT_TYPE_FILTER.

Поле	Тип	Описание
filter	enum Filter	Предопределенная проверка: EMAIL_EXISTS, PUSH_TOKEN_EXISTS, SMS_TOKEN_EXISTS, WHATSAPP_TOKEN_EXISTS, LINE_TOKEN_EXISTS или CUSTOM.
filter_raw	string	Кастомное выражение фильтра, когда filter — CUSTOM.

Точки действия

set_tags

Обновляет теги пользователя. POINT_TYPE_SET_TAGS.

Поле	Тип	Описание
application_code	string	Код приложения.
tags	Tag[]	Теги для записи.

Tag

Поле	Тип	Описание
name	string	Имя тега.
type	enum TagType	Тип данных и операция: TYPE_STRING, TYPE_INTEGER, TYPE_DATE, TYPE_BOOLEAN, TYPE_LIST, TYPE_LIST_APPEND, TYPE_LIST_REMOVE, TYPE_DYNAMIC, …
value	oneof	Ровно один ключ значения, соответствующий type: str, int, bool, date, price, version, timezone, list или dynamic.

web_hook

Отправляет исходящий HTTP-запрос. POINT_TYPE_WEBHOOK. Один вывод default.

Поле	Тип	Описание
method	string	HTTP-метод (GET, POST, PUT, …).
url	string	Целевой URL.
request_template	string	Шаблон тела запроса. Поддерживает шаблонизацию Liquid.
headers	map<string, string>	HTTP-заголовки.
disabled	bool	Только для чтения. true, когда Pushwoosh автоматически отключил вебхук после повторных ошибок.
reactivate	bool	Только для записи. Установите true, чтобы повторно включить отключенный вебхук.

audience_sync

Добавляет или удаляет пользователя из кастомной аудитории Meta. POINT_TYPE_AUDIENCE_SYNC.

Поле	Тип	Описание
ad_account_id	string	ID рекламного аккаунта Meta.
ad_account_name	string	Отображаемое имя для ad_account_id, только для UI.
audience_id	string	ID кастомной аудитории Meta.
audience_name	string	Отображаемое имя для audience_id, только для UI.
action	enum AudienceSyncAction	AUDIENCE_SYNC_ACTION_ADD или AUDIENCE_SYNC_ACTION_REMOVE.

Осторожно

Это не проверяется при создании или обновлении точки — только когда Journey проходит валидацию или запускается. Неверный ad_account_id (больше не подключен) или audience_id (не возвращается Meta) сохраняется без ошибок и обнаруживается только на этом этапе, а не незаметно при синхронизации каждого пользователя.

Точки конверсии

goal_event

Отслеживает цель конверсии. POINT_TYPE_GOAL_EVENT. Не имеет выводов.

Поле	Тип	Описание
event_name	string	Имя события цели.
application_code	string	Код приложения.
event_conditions	PointEventCondition[]	Условия, сопоставляемые с атрибутами события цели.
is_throw_out	bool	Удалять ли пользователя из Journey после достижения цели.
is_cancel_event	bool	Является ли это отрицательной (отменяющей) целью.

Точки выхода

terminator

Завершает Journey для пользователя. POINT_TYPE_EXIT. Пустой объект ({}) и нет выводов.

{ "point_type": "POINT_TYPE_EXIT", "point_data": { "terminator": {} }, "outputs": [] }

Точка-терминатор является необязательной. Если оставить info.next_point_uuid вывода неустановленным, это завершит Journey для пользователя так же, как и явный терминатор — оба случая учитываются одинаково, как Выходы, а не как ошибки.

Точки отправки сообщений

Все точки отправки сообщений отправляют через канал и имеют общую оболочку. Каждая имеет один вывод default, если не включен разделитель (см. ключи вывода).

Общие поля:

Поле	Тип	Описание
application_code	string	Код приложения.
preset_code	string	Пресет (шаблон) для отправки. inapp использует richmedia_code вместо этого.
content / title	string	Встроенное содержимое сообщения, если не используется пресет (зависит от канала).
campaign_code	string	Код кампании для отслеживания. Создается автоматически, если не указан.
split_params	BehaviorSplitter	Необязательно: ожидать взаимодействия и разветвляться на его основе.
message_type	enum	Тип сообщения Маркетинговое или транзакционное (контролирует обработку контрольной группы). Не используется send_email, у которого есть своя пара email_type/email_category ниже.

Типы точек и их примечательные дополнительные поля:

Тип точки	Ключ point_data	Примечания
POINT_TYPE_SEND_PUSH	send_push	split_params (поведение) плюс разделитель по доставке могут создавать до трех выводов. send_by_user_id, wait_optimal_time.
POINT_TYPE_SEND_EMAIL	send_email	liquid_template_params, personalise, email_type, email_category (см. ниже). См. Email API.
POINT_TYPE_SEND_SMS	send_sms	См. SMS.
POINT_TYPE_SEND_WHATSAPP	send_whatsapp	personalise (см. ниже). Пресет с быстрыми ответами добавляет один вывод на каждый ответ (ключ = значение ответа). См. WhatsApp.
POINT_TYPE_SEND_TELEGRAM	send_telegram	Канал Telegram.
POINT_TYPE_SEND_KAKAO	send_kakao	См. Kakao.
POINT_TYPE_SEND_LINE	send_line	См. LINE API.
POINT_TYPE_SEND_DATA	send_data	Тихое сообщение с данными (без UI).
POINT_TYPE_INAPP	inapp	Использует richmedia_code, expire_in_days, capping.

Осторожно

В send_email поле email_type должно быть опущено или установлено в значение marketing или transactional — в нижнем регистре, любое другое значение будет отклонено. email_category обязателен, когда email_type равен marketing, и должен быть кодом существующей категории, а не ее отображаемым названием.

В send_whatsapp запись personalise.placeholders[] с type: "MPM" (сообщение с несколькими продуктами) должна иметь actions.actions[].type установленным в значение action — это единственный тип действия, который Meta принимает в кнопке шаблона MPM. Любое другое значение будет отклонено.

Ничего из этого не проверяется при создании или обновлении точки — только когда Journey проходит валидацию или запускается. Неверное значение сохраняется без ошибок и обнаруживается только на этом этапе.

Общие типы

SegmentRepeat

Поле	Тип	Описание
enabled	bool	Включен ли повторяющийся вход.
frequency	string	daily, weekly, monthly или dates.
every	uint32	Повторять каждые N периодов.
dates	string[]	Конкретные даты, когда frequency — dates.
time	SegmentRepeatTime	Конфигурация времени суток.

Объекты времени

• ExactTime: { "hour": 0–23, "minute": 0–59 }.
• ExactDateTime: { "year", "month": 1–12, "day": 1–31, "hour": 0–23, "minute": 0–59 }.

BehaviorSplitter

Поле	Тип	Описание
enabled	bool	Ожидать ли взаимодействия и разветвляться на его основе.
interval	uint64	Секунды ожидания взаимодействия.

MultiEntry

Контролирует, сколько активных сессий пользователь может иметь в Journey одновременно. Отражает Контроль количества одновременных сессий пользователя в конструкторе Customer Journey. Используется точкой входа по событию и wait_event.

Поле	Тип	Описание
enabled	bool	Может ли пользователь иметь несколько активных сессий одновременно. false: одна активная сессия на пользователя. true: несколько активных сессий на пользователя.
attribute_name	string	Необязательно. Атрибут события, который определяет область действия каждой сессии. Когда установлено, пользователь может иметь одну активную сессию для каждого уникального значения этого атрибута (например, одну на order_id). События с одинаковым значением используют одну сессию. Оставьте пустым, чтобы объединить все входы пользователя.

Связанные статьи

Объект Journey

Создание и обновление

API пресетов