В данной статье разберём возможности вкладки Переменные.
Переменные — название функции, которая позволяет подставлять определенные значения индивидуально под каждого пользователя или для всех. Все переменные имеют общий вид {{NAME}} для обозначения используются двойные фигурные скобки с двух сторон и символы "a-z" "A-Z" "0-9" "_" для названия переменной.
Например: для приветствия пользователя по имени при входе в бота или группу.
Переменные бывают двух видов:
- Пользовательские (кастомные) — созданные пользователем во вкладке Переменные.
- Системные — созданные разработчиками (FIRST_NAME, USER_ID и далее) или созданные в других вкладках (Формы ввода, Блок результат и далее).
Важно! Группу системных переменных нельзя изменить или удалить.
На вкладке Переменные собраны все существующие внутри сервиса и бота Переменные, в том числе из вкладки Вход и Форм ввода.
Создание пользовательской переменной
Пользовательские переменные делятся на два типа:
- Персональные (розовые) — хранят индивидуальные значения пользователя.
Например: имя пользователя, баланс, баллы в игре.
- Глобальные (голубые) — хранят общие значения для всех пользователей.
Например: название бота, ссылка на сайт, название кнопки.
Важно! Глобальная переменная с форматом Формула не может содержать персональные переменные.
У каждой переменной есть значение, а каждое значение может быть одним из двух типов:
- Обычное значение — значение, которое хранится внутри бота.
- Интегрированное значение — значение, которое берётся со стороннего сервиса путём GET запроса, ответ должен быть в JSON формате.
URL запроса может содержать Переменные.
Важно! Для Переменных с интегрированным значением действуют кэш и ожидание ответа 5 секунд.
Разберём остальные настройки Переменных:
- Название переменной — символы "a-z" "A-Z" "0-9" "_".
- Формат значения — определяет тип значения, которое будет хранится в Переменной.
- Текст
- Число
- Формула — сложное значение, формирующееся из нескольких переменных и/или содержащее математические операции.
- Ссылка — может быть использовано в кнопках с действием ссылка и в форматировании текста.
- Документ — любой медиафайл.
Важно! В переменную формата Текст максимально можно записать 4096 символов.
Важно! Формат значения Формула и любые выражения с Переменными имеют свои правила написания, подробнее: Правила написания выражения или формулы для изменения Переменной.
- Значение по умолчанию — значение, которое будет отображаться у пользователя, пока в Переменную не будет записано другое значение или не будет изменено текущее.
Важно! В значение по умолчанию не может быть вставлена Переменная.
- Описание — текст, отображаемый только на вкладке Переменные.
- Группа — порядок отображения на вкладке Переменные.
Изменение переменной
Все переменные из Системной группы редактируются в тех местах, где они были созданы: Формы ввода — Конструктор, Реферальная система — Вход и так далее.
Пользовательские переменные можно редактировать двумя способами:
- Через Действия “Изменить переменную" или “Очистить переменную”.
- Через ручное редактирование значения.
Редактирование через Действие
Важно! Изменение Переменной происходит после вызова команды — если у вас в команде добавлено Действие изменить переменную
{{VARIABLE}}, а в текстовом блоке этой же команды настроена отправка переменной{{VARIABLE}}, то пользователю будет отправлено предыдущее значение.
При изменении Пользовательской переменной с форматом “Число” можно использовать универсальный оператор “=” или использовать наиболее популярные операторы.
Например: для уменьшение переменной {{BALANCE}} на 1 можно использовать оператор вычесть “-” и прописать в поле выражение 1 или использовать универсальный оператор “=” и прописать {{BALANCE}} - 1. Оба этих варианта равнозначны.
Для переменных с форматом “Текст” используется только оператор “=”.
Например: в Пользовательской переменной {{MY_DAY}} хранится любимый день недели пользователя, в нашем случае это “Понедельник”. Для замены переменной на другой день, к примеру “Вторник” в поле выражение после оператора “=” нужно вписать слово используя кавычки “Вторник”.
Важно! Формат значения Формула и любые выражения с Переменными имеют свои правила написания, подробнее: Правила написания выражения или формулы для изменения Переменной.
После обновления 31.12.2024 стали доступны Формулы в тексте — благодаря им необязательно добавлять отдельные переменные или создавать действие, достаточно указать в тексте, пример:
{{=100-45=}}. Формулы в тексте также поддерживают работу с переменными.
Редактирование ручное
Значение можно менять индивидуально для каждого пользователя.
Очистка переменной
Действие Очистка переменной очищает до значения по умолчанию.
Стандартные переменные
Стандартные переменные можно разделить на три группы:
- Переменные общие (работают везде);
- Переменные работающие только в боте;
- Переменные работающие только в ресурсах (чатах и каналах).
Переменные общие
Данная группа переменных создана администраторами сервиса и она:
- Не подлежит редактированию;
- Работает и в боте и в ресурсах (каналах и группах).
Важно! Все переменные даты и времени берут значения относительно часового пояса заданного в настройках аккаунта.
Переменные работающие только в боте
Пользовательская группа переменных, формируемая за счет создания во вкладке Переменные, Форм ввода и вкладки Вход.
Подробнее о работе Форм ввода в статье: Форма ввода.