Стандартные переменные
Стандартные переменные — это значения, которые мы получаем из событий и действий, которые произошли с пользователем или платформой (ВК, Telegram, Prodamus и т.д.)
Пользователь
| Переменная |
Результат |
| {user:first_name} |
Имя пользователя |
| {user:last_name} |
Фамилия пользователя |
| {user:full_name} |
Имя + Фамилия пользователя |
| {user:platform.id} |
ID пользователя на платформе (VK/TG...) |
| {user:id} |
ID пользователя в проекте MultyAI |
| {user:platform.url} |
Ссылка на профиль пользователя |
| <a href="{user:platform.url}">{user:full_name}</a> |
Кликабельное имя и фамилия пользователя (VK/TG) |
| <a href="{user:platform.url}">{user:first_name}</a> |
Кликабельное имя пользователя (VK/TG) |
| <a href="tg://user?id={author:platform.id}">{author:platform.first_name}</a> |
Кликабельное имя упомянутого пользователя (TG) |
| @id{author:platform.id} ({author:platform.first_name}) |
Кликабельное имя упомянутого пользователя (VK) |
Данные пользователя
Обратите внимание, что у некоторых пользователей эти данные могут быть не заданы, не переданы в Малти или не собирались вами в блок-схемах.
| Переменная |
Результат |
| {user:appeal} |
Пол (0 - не указан, 1 - женский, 2 - мужской) |
| {case:{user:appeal}||уважаемая|уважаемый} |
Обращение к пользователям по гендеру |
| {contact:phone} |
Телефон пользователя |
| {contact:email} |
Email пользователя |
| {contact:vk_id} |
VK id пользователя |
| {contact:tg_id} |
TG id пользователя |
| {user:title} |
Псевдоним/Отчество |
| {user:platform.username} |
Никнейм пользователя на внешней платформе |
| {user:photo_url} |
Ссылка на фотографию профиля (VK) |
| {var:platform.contact.type} |
Тип контакта (vk_id, tg_id, email, phone) |
| {user:profile_type} |
Тип профиля (user,bot,chat,channel) |
Переменные событий
| Переменная |
Результат |
| {var:object.text} |
Текст события (сообщения от пользователя, название продукта и т.д.) |
| {var:object.id} |
ID объекта (сообщения, комментария и т.д.) |
| {var:object.url} |
Cсылка на пост |
| {var:object.post.id} |
ID поста |
| {var:platform.integration.id} |
ID бота/сообщества |
| {var:object.attachments[0].code} |
ID вложения |
| {var:object.attachments[0].photo_url} |
Ссылка на фотографию объекта (поста, сообщения, комментария) |
| {var:object.type} |
Тип объекта (message, comment, post, notice, admin, invite_link) |
Переменные чата
| Переменная |
Результат |
| {var:platform.chat.id} |
ID чата |
| {var:object.reply.text} |
Текст цитируемого или пересланного сообщения |
| {var:object.reply.id} |
ID цитируемого сообщения (можно проверять в условии - "если >0" - это ответ на сообщение) |
| {var:platform.author.id} |
ID автора сообщения, комментарий (при ответе или пересылке) |
Переменные оплаты
| Переменная |
Результат |
| {var:object.text} |
Название продукта |
| {var:object.price} |
Сумма оплаты |
| {num:{var:object.price}|float|0} |
Сумма оплаты без копеек |
| {var:object.order.id} |
ID заказа |
| {var:object.invoice.discount} |
Сумма скидки |
| {var:object.subscription.id} |
ID подписки (Prodamus) |
Переменные полезных функций
| Переменная |
Результат |
| {rand:|0|1000} |
Выдает случайное числовое значение в выбранном диапазоне. Например: "137" |
| {incident:|отлично|супер|превосходно|замечательно} |
Выдает случайное текстовое значение из указанных. Например: "отлично" |
| {lexeme:{var:apples}|яблок|яблоко|яблока} |
Выдает правильное склонение для определенного числа. В данном случае {var:apples} - содержит число яблок у пользователя. |
| {num:{var:product.price}} |
Убирает текст, оставляя только числа / мат. выражения. |
|
{calc:1+1}
{calc:{var:count1}+{var:count1}}
{calc:1.1232|1} = 1.1
|
Переменная калькулятора.
Поддерживает переменные.
Можно указать количество символов после запятой через |1 в конце
|
| {date:|%d.%m.%Y}г. |
Сегодняшняя дата в формате 31.12.9999г. |
| {case:{var:users.user.appeal}||уважаемая|уважаемый} |
Получение аргумента по его индексу, который находится в значении переменной |
Для переменной num также доступны настройки через прямую черту. Например {num:{var:product.price}|human}
human - удобочитаемый формат
int - только цифры в виде одного числа - по умолчанию
float - число с точкой
math - числа (float) и математические операторы
list - числа и запятые
price - удобочитаемый формат цены (сумма с копейками, если такие переданы)
Переменная IF
Переменная IF (с англ. ЕСЛИ) позволяет делать сравнение данных внутри одной переменной.
Так выглядит основная логика:
{if:{var:num}|✅|❌}
Где {var:num} 1 или 0
Соответственно:
{if:1|✅|❌} = ✅
{if:0|✅|❌} = ❌
Но IF также поддерживает функции сравнения:
- > (больше)
- < (меньше)
- = (соответствует)
- == (равняется)
- != (не равно)
- >= (больше или равно)
- <= (меньше или равно)
- and (и)
- or (или)
Примеры работы функции:
false and (false or true) {if:false and (false or true)|❌|✅}
((false or (false or true)) and true) {if:((false or (false or true)) and true)|✅|❌}
false and false or true {if:false and false or true|✅|❌}
undefined {if:undefined|❌|✅}
undefined or null or none{if:undefined or null or none|❌|✅}
some text {if:some text |✅|❌}
not false {if:not false|✅|❌}
not (1<0) {if:not (1<0)|✅|❌}
0 {if:0|❌|✅}
1 {if:1|✅|❌}
1>0 {if:1>0|✅|❌}
1 < 0 {if:1 < 0|❌|✅}
-1 < 0 {if:-1 < 0|✅|❌}
0 >-10 {if:0 >-10|✅|❌}
0 >= 0 {if:0 >= 0|✅|❌}
1 == 1 {if:1 == 1|✅|❌}
1 != 1 {if:1 != 1|❌|✅}
1 != 2 {if:1 != 2|✅|❌}
👌 {if:👌🚀🤖🧠❤️🔥|✅|❌}
1 < 2 and -1 != 2 {if:1 < 2 and -1 != 2|✅|❌}
1 < 2 and (2 != 2 or 1 > 0 ) {if:1 < 2 and (2 != 2 or 1 > 0 )|✅|❌}
{if:{var:date}|{date:{var:date}|%d.%m.%Y}|} - Если {var:date} не задана, выводит пустоту.
Полезные переменные
| Переменная |
Результат |
| {var:utm} |
Все данные ref-ссылки. Например {var:utm.ref} выдаст значение ref |
| {var:object.payload} |
Значение дополнительных данных кнопки |
| https://vk.com/gim{var:platform.integration.id}?sel={var:platform.user.id} |
Ссылка на переписку с пользователем от сообщества ВКонтакте |
Общие переменные события
| Переменная |
Результат |
| {var:request} |
Необработанное содержимое входящего запроса |
| {var:object} |
Объект (самые важные и полезные данные) текущего события |
| {var:platform} |
Данные платформы. Обычно уникальные данные в рамках конкретной платформы. А также данные пользователя на платформе |
Переменные результата и ошибок
| Переменная |
Результат |
| {var:ok} |
Успешно ли выполнилось действие (true/1, false/0) |
| {case:{var:ok}|❌|✅} |
Визуальное отображения успеха |
| {var:error.message} или {var:error} |
Детали ошибки (undefined если их нет) |
| {var:result} |
Возвращает результат действий |
|
{var:effect}
|
Важные данные из результата работы конкретного типа действия |
Пример готового текста сообщения для полного результата действия:
Результат: {case:{var:ok}|❌|✅}
<code>{var:result}</code>
_______
Ошибка: <code>{var:error.message}</code>
Переменные проекта
| Переменная |
Результат |
| {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} |
Путь пользователя (считываются все типы объектов схемы: порты, блоки, стрелки, контейнеры) |