> For the complete documentation index, see [llms.txt](https://multyai.gitbook.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://multyai.gitbook.io/home/docs/automation/variables/context.md). # Стандартные переменные {% embed url="" %} Стандартные переменные — это значения, которые мы получаем из событий и действий, которые произошли с пользователем или платформой (ВК, Telegram, Prodamus и т.д.) ## Список стандартных переменных | Переменная | Результат | | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | {user:first\_name} или {var:users.user.first\_name} | Имя пользователя | |

{user:last\_name} или
{var:users.user.last\_name}

| Фамилия пользователя | |

{user:full\_name} или
{var:users.user.last\_name}

| Имя + Фамилия | | {user:platform.url} | Ссылка на профиль пользователя | | {var:platform.user.username} | Логин пользователя | | {var:users.user.appeal} | Пол (0 - не указан, 1 - женский, 2 - мужской) | | {case:{var:users.user.appeal}\|\|уважаемая\|уважаемый} | Обращение к пользователям по гендеру | | {var:utm} | Все данные [ref-ссылки](/home/education/examples/parsing-ref-ssylok.md). Например {var:utm.ref} выдаст значение ref | |

{var:platform.user.id}
{user:platform.id}

| ID пользователя на платформе (VK,TG...) | | {var:users.user.profile\_type} или {var:platform.chat.profile\_type} | Тип профиля (user,bot,chat,channel) | | {var:users.user.contact.phone\[0]} | Телефон пользователя (если задан) | | {contact:phone} | Коротка версия переменной телефона | | {var:users.user.contact.email\[0]} | Email пользователя (если задан) | | {var:users.user.title} | Псевдоним | | {var:users.user.photo\_url} | Ссылка на фотографию профиля (для ВК) | | {var:platform.chat.id} | ID пользователя или чата | | {var:users.chat.project\_id} | ID проекта в MultyAI | |

{user:id}

{var:users.user.id}

{var:users.chat.id}

| ID пользователя в MultyAI | | {var:object.id} | ID объекта (сообщения, комментария и т.д.) | | {var:object.text} | Тест события (сообщения от пользователя, название продукта и т.д.) | | {var:object.payload} | Значение дополнительных данных кнопки (полезная нагрузка) | | {var:object.attachments\[0].code} | ID вложения | | {var:object.attachments\[0].photo\_url} | Ссылка на фотографию объекта (поста, сообщения, комментария) | | {var:object.type} | Тип объекта (message, comment, post, notice, admin, invite\_link) | | {var:object.author.id} | ID сообщества/бота | | {var:object.url} | Cсылка на пост | | {var:object.post.id} | ID поста, где произошло событие | | {var:object.reply.text} | Текст цитируемого или пересланного сообщения | | {var:platform.short\_name} | tg / vk - Короткое имя платформы | | {var:platform.author.id} | ID автора сообщения, комментарий (при ответе или пересылке) | | {var:platform.event.type} | Тип события: message (tg), message\_new (vk), like\_add (vk), wall\_post\_new, wall\_reply\_new\... | | {var:platform.integration.id} | ID бота/сообщества | | {var:platform.is\_premium} | Есть ли Telegram-премиум | | {var:platform.contact.type} | Тип контакта (vk\_id,tg\_id,email, phone и т.д.) | | {var:platform.chat.id} | ID чата | | {var:graph.project.id} | ID проекта | | {var:graph.integration.id} | ID интеграции | | {var:graph.project.title} | Название проекта | | {var:graph.item.id} | ID схемы | | {var:graph.event.localId} | Системный номер блока (#) события, которое запустило схему | | {var:graph.restore.localId} | Системный номер блока (#), который восстановил\* схему | | {var:graph.path} | Путь пользователя (eчитываются все типы объектов схемы: порты, блоки, стрелки, контейнеры) | | {var:ok} | Успешно ли выполнилось действие (true/1, false/0) | | {case:{var:ok}\|❌\|✅} | Визуальное отображения успеха | | {var:error.message} или {var:error} | Детали ошибки (undefined если их нет) | | {var:result} | Возвращает результат действий | | {var:effect} | Важные данные из результата работы конкретного типа действия | | {var:request} | Содержимое входящего запроса | | | Ссылка на переписку с пользователем от сообщества Вконтакте | | | Ссылка на конкретное сообщение с пользователем в сообществе ВК | | | Ссылка на комментарий в обсуждении Вконтакте | | \{**user**:platform.first\_name}\ | **Универсальная** кликабельная ссылка (ТГ/ВК) на профиль пользователя (Имя) | | \{**user**:full\_name}\ | **Универсальная** кликабельная ссылка (ТГ/ВК) на профиль пользователя (Имя Фамилия) | | \{**author**:platform.first\_name}\ | **Универсальная** кликабельная ссылка (ТГ/ВК) на профиль **упомянутого** пользователя (Имя) | | \{**author**:full\_name}\ | **Универсальная** кликабельная ссылка (ТГ/ВК) на профиль **упомянутого** пользователя (Имя Фамилия) | | \{user:full\_name}\ | Кликабельная ссылка на профиль пользователя с Именем и Фамилией в **Telegram** ([Кирилл Аксёнов](https://t.me/kir_axenov)) | |

@id{var:platform.user.id} ({user:full\_name})
или
@id{var:platform.user.id} ({var:users.user.first\_name})

|

Кликабельная ссылка на профиль пользователя ВКонтакте:
(Кирилл Аксёнов)
или
(Кирилл)

| | \{var:platform.**author**.first\_name}\ | Кликабельная ссылка на профиль **упомянутого** пользователя с Именем и Фамилией в **Telegram** ([Кирилл](https://t.me/kir_axenov)) | | @id{var:platform.**author**.id} ({var:platform.**author**.first\_name}) | Кликабельная ссылка на профиль **упомянутого** пользователя **ВКонтакте** ([Кирилл](https://vk.com/id417557015)) | ## Дополнительные функции переменных Кроме `{var:}` есть еще несколько функций, которые вы также можете использовать. Они поддерживают не только значения, которые вы туда сами записываете, но и вложения переменных. * `rand` - случайное число в указанном диапазоне * Пример: `{rand:`|`100|999}` * Пример результата: `357` * `incident` - случайный текст выбранный из всех предложенных вариантов * Пример: `{incident:|one|two|three|four}` * Пример результата: `two` * `num` - оставить только цифры / числа / математику * `int` - только цифры в виде одного числа - по умолчанию * `float` - число с точкой * `math` - числа (float) и математические операторы * `list` - числа и запятые * `human` - удобочитаемый формат * `price` - удобочитаемый формат цены (сумма с копейками, если такие переданы) * Пример: `{num:{var:product.price}|human}` * `calc` - посчитать простую математическую формулу (аналог действия Калькулятор) * Параметры: * 1 - Переменная откуда брать формулу * 2 - Математическое выражение. Может содержать вложенные переменные. Если указаны и первый и второй параметры, то второй параметр в приоритете * 3 - Количество знаков после запятой * Примеры: * а) `{calc:1.234 + 2*3}` = 7.234\ б) `{calc:1.234 + 2*3|1}` = 7.2 * а) `{var:expression}` = 1.234 + 2\*3\ б) `{calc:{var:expression}}|1}` = 7.2 * `date` - сменить формат даты * Пример: `{date:{var:var.with.date}|Format %F %T|%Y-%m-%d %H:%M:%S}` * где `%Y-%m-%d %H:%M:%S` - входящий формат даты (в значении переменной) * Сегодняшняя дата: `{date:|%d.%m.%Y}г.` - 31.12.2023г. * `case` - получение аргумента по его индексу, который находится в значении переменной * Пример: `{case:{var:users.user.appeal}|обращение на вы|женский|мужской}` * Суть функции: * Варианты значений воспринимаются как массив с числовыми индексами. * Нумерация элементов массива начинается с 0. * Значение переменной переводится в число и воспринимается как индекс этого массива. * И в итоге происходит поиск элемента по индексу, * или выводится значение переменной, если такой элемент с таким номером не найден. * например, `{var:users.user.appeal}` может принимать такие значения: * `0` - пол не указан, `1` - женский, `2` - мужской. * Поэтому и пример выше сработает как положено. * `lexeme` - склонение существительных после числительных * Пример: `в корзине было {var:apples} {lexeme:{var:apples}|яблок|яблоко|яблока}` * Пример результата: `в корзине было 24 яблока` * Суть: 0 или много → яблок, 1 → яблоко, 2 / 3 / 4 → яблока