Стандартные переменные

Стандартные переменные — это значения, которые мы получаем из событий и действий, которые произошли с пользователем или платформой (ВК, 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-ссылки. Например {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}	Содержимое входящего запроса
https://vk.com/gim{var:platform.integration.id}?sel={var:platform.user.id}	Ссылка на переписку с пользователем от сообщества Вконтакте
https://vk.com/gim{var:platform.integration.id}?sel={var:platform.user.id}&msgid={var:object.id}	Ссылка на конкретное сообщение с пользователем в сообществе ВК
https://vk.com/gim{var:platform.integration.id}?sel={var:platform.user.id}&msgid={var:object.id}	Ссылка на комментарий в обсуждении Вконтакте
<a href="{user:platform.url}">{user:platform.first_name}</a>	Универсальная кликабельная ссылка (ТГ/ВК) на профиль пользователя (Имя)
<a href="{user:platform.url}">{user:full_name}</a>	Универсальная кликабельная ссылка (ТГ/ВК) на профиль пользователя (Имя Фамилия)
<a href="{user:platform.url}">{author:platform.first_name}</a>	Универсальная кликабельная ссылка (ТГ/ВК) на профиль упомянутого пользователя (Имя)
<a href="{user:platform.url}">{author:full_name}</a>	Универсальная кликабельная ссылка (ТГ/ВК) на профиль упомянутого пользователя (Имя Фамилия)
<a href="tg://user?id={var:platform.user.id}">{user:full_name}</a>	Кликабельная ссылка на профиль пользователя с Именем и Фамилией в Telegram (Кирилл Аксёнов)
@id{var:platform.user.id} ({user:full_name}) или @id{var:platform.user.id} ({var:users.user.first_name})	Кликабельная ссылка на профиль пользователя ВКонтакте: (Кирилл Аксёнов) или (Кирилл)
<a href="tg://user?id={var:platform.author.id}">{var:platform.author.first_name}</a>	Кликабельная ссылка на профиль упомянутого пользователя с Именем и Фамилией в Telegram (Кирилл)
@id{var:platform.author.id} ({var:platform.author.first_name})	Кликабельная ссылка на профиль упомянутого пользователя ВКонтакте (Кирилл)

Переменная

Результат

{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-ссылки. Например {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}

Содержимое входящего запроса

https://vk.com/gim{var:platform.integration.id}?sel={var:platform.user.id}

Ссылка на переписку с пользователем от сообщества Вконтакте

https://vk.com/gim{var:platform.integration.id}?sel={var:platform.user.id}&msgid={var:object.id}

Ссылка на конкретное сообщение с пользователем в сообществе ВК

https://vk.com/gim{var:platform.integration.id}?sel={var:platform.user.id}&msgid={var:object.id}

Ссылка на комментарий в обсуждении Вконтакте

<a href="{user:platform.url}">{user:platform.first_name}</a>

Универсальная кликабельная ссылка (ТГ/ВК) на профиль пользователя (Имя)

Универсальная кликабельная ссылка (ТГ/ВК) на профиль пользователя (Имя Фамилия)

<a href="{user:platform.url}">{author:platform.first_name}</a>

Универсальная кликабельная ссылка (ТГ/ВК) на профиль упомянутого пользователя (Имя)

<a href="{user:platform.url}">{author:full_name}</a>

Универсальная кликабельная ссылка (ТГ/ВК) на профиль упомянутого пользователя (Имя Фамилия)

Кликабельная ссылка на профиль пользователя с Именем и Фамилией в Telegram (Кирилл Аксёнов)

@id{var:platform.user.id} ({user:full_name}) или @id{var:platform.user.id} ({var:users.user.first_name})

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

<a href="tg://user?id={var:platform.author.id}">{var:platform.author.first_name}</a>

Кликабельная ссылка на профиль упомянутого пользователя с Именем и Фамилией в Telegram (Кирилл)

@id{var:platform.author.id} ({var:platform.author.first_name})

Кликабельная ссылка на профиль упомянутого пользователя ВКонтакте (Кирилл)

Дополнительные функции переменных

Кроме {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 → яблока

PreviousПеременные NextВременные переменные

Last updated 11 months ago