Стандартные переменные
Last updated
Last updated
Стандартные переменные — это значения, которые мы получаем из событий и действий, которые произошли с пользователем или платформой (ВК, 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}
{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>
@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>
@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 → яблока
Все данные . Например {var:utm.ref} выдаст значение ref
Кликабельная ссылка на профиль пользователя с Именем и Фамилией в Telegram ()
Кликабельная ссылка на профиль пользователя ВКонтакте: () или ()
Кликабельная ссылка на профиль упомянутого пользователя с Именем и Фамилией в Telegram ()
Кликабельная ссылка на профиль упомянутого пользователя ВКонтакте ()