Системные переменные
Системные переменные — готовые значения о клиенте, дате и сценарии, которые платформа заполняет сама. Их не нужно создавать: просто подставляйте в текст, условия и действия.
Данные клиента и даты
Эти значения бот берёт из карточки клиента и часов сервера в момент шага:
| Переменная | Что содержит |
|---|---|
{{system.first_name}} | Имя клиента |
{{system.last_name}}, {{system.full_name}} | Фамилия, имя и фамилия |
{{system.phone}}, {{system.email}} | Телефон и email из карточки |
{{system.client_id}} | ID клиента в APX |
{{system.client_external_id}} | ID клиента в мессенджере |
{{system.current_date}}, {{system.tomorrow_date}} | Сегодня и завтра, ГГГГ-ММ-ДД, по часовому поясу организации |
{{system.current_time}} | Время ЧЧ:ММ по часовому поясу организации |
{{system.current_day_of_week}} | День недели: 1 — понедельник, 7 — воскресенье |
{{system.scenario_name}} | Название сценария |
{{system.subscription_date}} | Дата начала текущего прохода сценария |
Переменные при старте сценария
При запуске сценария бот кладёт в обычные переменные данные клиента — их можно писать без system.:
| Переменная | Что содержит |
|---|---|
{{name}} | Имя клиента |
{{phone}}, {{email}} | Телефон и email из карточки |
{{username}} | Имя пользователя в мессенджере |
{{channel_type}} | Канал: telegram, max, vk, avito или website |
{{start_param}} | Метка из ссылки на бота — см. ниже |
Это снимок на момент старта: если «Вопрос» сохранит новый ответ в phone, переменная {{phone}} изменится, а {{system.phone}} покажет телефон из карточки.
Телефон и email бывают пустыми, пока клиент их не оставил. Не полагайтесь на них там, где значение обязательно, — спросите через ноду «Вопрос».
Параметр запуска (start_param)
start_param — метка, которую вы зашиваете в ссылку на бота. По ней видно, откуда пришёл клиент: из рекламы, поста или реферальной ссылки.
- Telegram — ссылка
t.me/ваш_бот?start=ads: Telegram отправит/start, аadsпопадёт в{{start_param}}. - MAX — ссылка
max.ru/ваш_бот?start=ads: кнопка «Начать» работает как/start, метка попадает в{{start_param}}. - VK, Avito и сайт — меток нет, переменная пустая.
Как использовать
Системная переменная подставляется так же, как поля, — в двойных фигурных скобках:
- в тексте сообщений — для персонализации;
- в условиях — справа, в значении для сравнения;
- в действиях — чтобы передать данные во внешние системы.
Когда применять / Пример
- Приветствие по имени. «Здравствуйте,
{{system.first_name|друг}}!» — имя из профиля мессенджера, а если его нет — «друг». - Учёт источника. Клиент пришёл по ссылке с меткой
ads. Заведите пользовательское полеstart_paramи в «Условии» ведите «рекламных» клиентов в ветку со спецпредложением.