Как правильно использовать переменные в процессе

Переменные — это атрибут, вместо которого подставляются индивидуальные данные пользователя или связанного с ним объекта (заказ, покупка и т.д.)

Переменные в процессах чаще всего используются в таких операциях, как:

• «Вопрос менеджеру»
• «Уведомить партнера»
• «Уведомить сотрудника»
• «Отправить сообщение»
• «Вызвать URL»

Очень важно указывать переменные в процессах в правильном формате, чтобы вместо них корректно подставлялись данные о пользователях, заказах и других объектах.

В процессах по пользователям переменные необходимо указывать в фигурных скобках с приставкой object:

Полный список переменных по объекту «Пользователи» перечислен в отдельной статье → «Переменные в рассылках и на страницах сайта».

В процессах по заказам доступны переменные по:

• заказу,
• пользователю, которому принадлежит заказ.

Чтобы использовать переменные по заказу, добавьте к ним приставку object:

{object.number} — Номер заказа.

{object.positions} — Состав заказа.

{object.payment_link} — Ссылка на оплату.

{object.offers} — Состав заказа: ID-идентификаторы предложений.

{object.promocode} — Название промокода, использованного в заказе.

{object.cost_money} — Стоимость заказа с указанием валюты.

{object.funnel_id} — ID доски продаж, на которой находится заказ.

{object.funnel_stage_id} — ID этапа на доске продаж, в котором находится заказ.

Чтобы в процессе по заказу использовать переменные по пользователю, добавьте приставки object и user:

{object.user.first_name} — Имя пользователя.

{object.user.email} — Электронная почта пользователя.

{object.user.phone} — Телефон пользователя.

{object.user.city} — Город пользователя.

В процессах по покупкам доступны переменные по:

• покупке,
• пользователю, которому принадлежит покупка.

Чтобы использовать переменные по покупке, добавьте к ним приставку object:

Чтобы в процессе по покупкам использовать переменные по пользователю, добавьте приставки object и user:

Чтобы подставлять данные по партнёру, используйте в переменных приставки object, user и partner.

В процессах по пользователям переменная будет иметь вид:

• {object.partner.email}

В процессах по покупкам используйте дополнительную приставку user, если хотите передать данные владельца покупки:

• {object.user.partner.email}

В процессах по заказам можно передавать данные партнера пользователя и партнера заказа:

• {object.partner.email} — партнер в заказе;
• {object.user.partner.email} — партнер пользователя.

Ниже представлен полный список доступных переменных по партнеру:

В процессах можно использовать переменные по персональному менеджеру пользователя:

• {personal_manager} — имя менеджера;
• {personal_manager_email} — email менеджера;
• {personal_manager_phone} — телефон менеджера.

Для подстановки контактов менеджера, укажите их для него в разделе «Партнерская программа»:

1. Эл. адрес, с которого уходят письма клиентам. Если поле не отображается в профиле персонального менеджера, настройте в своем аккаунте доменную почту.
   
2. Имя отправителя. Если поле не заполнено, то значение для переменной {personal_manager} подтянется из профиля сотрудника-менеджера.
   
3. Добавочный номер телефона.

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

Формируются переменные источника при помощи приставок object, user и create_session.

В процессах по пользователям переменные имеют следующий формат:

• {object.create_session.utm_source}

В процессах по заказам и покупкам используйте дополнительную приставку user.

• {object.user.create_session.utm_source}

Для передачи UTM-меток используются следующие переменные:

• {create_session.utm_source}
• {create_session.utm_medium}
• {create_session.utm_campaign}
• {create_session.utm_content}
• {create_session.utm_term}
• {create_session.utm_group}

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

• {create_session.gcpc} — партнёрский код;
• {create_session.clickid} — произвольный дополнительный параметр из источника пользователя.

Для создания переменной используется заголовок дополнительного поля. Далее добавьте к полученной переменной приставки для корректной работы в процессе.

Выбор приставок зависит от типа объекта, для которого создано дополнительное поле:

• дополнительные поля пользователя обрабатываются как переменные по пользователю;
• дополнительные поля заказа обрабатываются как переменные по заказу;
• дополнительные поля покупок обрабатываются как переменные по покупкам.

Ниже разберем примеры использования переменных.

Для этого используем заголовки дополнительных полей:

• «Часовой пояс» — дополнительное поле пользователя;
• «Дата консультации» — дополнительное поле заказа;
• «Удобная дата продления» — дополнительное поле покупки.

В процессе по пользователям используйте дополнительные поля пользователя с приставкой object:

• {object.Часовой пояс}

В процессе по заказам используйте приставку object для дополнительного поля заказа:

• {object.Дата консультации}

Чтобы передать дополнительное поле пользователя, используйте приставки object и user:

• {object.user.Часовой пояс}

В процессе по покупкам используйте приставку object для дополнительного поля покупки:

• {object.Удобная дата продления}

Чтобы передать дополнительное поле пользователя, используйте приставки object и user:

• {object.user.Часовой пояс}

Чтобы передать название промокода, который применен в заказе, используйте переменную {object.promocode} в процессе по объекту «Заказы».

Для вывода дат доступны следующие переменные:

• {today} — отображает сегодняшнюю дату;
• {today plus} — отображает сегодняшнюю дату + Х дней;
• {nextweekday} — переменная выводит даты ближайшего указанного дня недели.

Подробнее о доступных форматах дат читайте в статье → «Переменные для вывода дат».

Вы можете использовать в процессах собственные переменные, созданные в разделе «Сайт» — «Страницы» — «Переменные». Об их создании подробно рассказали в статье → «Собственные пользовательские переменные».

В процессах, как и в рассылках, можно использовать переменные сложной автозамены:

1. {first_name delimiter="," letter="п"}ривет

Если у пользователя указано имя в профиле, то оно автоматически подставится в сообщении/уведомлении. Если имя отсутствует, то отправится только «Привет!».

2. {first_name delimiter="," word="здравствуйте"}

Если у пользователя указано имя в профиле, то оно автоматически подставится в сообщении/уведомлении. Если имя отсутствует, то отправится только «Здравствуйте».

3. {gender male="он" female="она" other="оно"} или Сдел{gender male="ал" female="ала" other="ало"}

С помощью такой переменной вы можете указать, какую форму глагола использовать в тексте в зависимости от пола в профиле. Например, «оформил» или «оформила».

В рассылках, независимо от способа отправки, используются названия переменных без дополнительного форматирования, например:

• {email},
• {positions}.

Другие статьи о переменных:

• Переменные в рассылках и на страницах сайта
• Переменные для вывода даты в рассылках и на страницах сайта
• Собственные пользовательские переменные