В данной статье разберём возможности вкладки Переменные.

Переменные — название функции, которая позволяет подставлять определенные значения индивидуально под каждого пользователя или для всех. Все переменные имеют общий вид {{NAME}} для обозначения используются двойные фигурные скобки с двух сторон и символы "a-z" "A-Z" "0-9" "_" для названия переменной.

Например: для приветствия пользователя по имени при входе в бота или группу.

Переменные бывают двух видов:

Пользовательские (кастомные) — созданные пользователем во вкладке Переменные.
Системные — созданные разработчиками (FIRST_NAME, USER_ID и далее) или созданные в других вкладках (Формы ввода, Блок результат и далее).

Важно! Группу системных переменных нельзя изменить или удалить.

На вкладке Переменные **собраны все** существующие внутри сервиса и бота Переменные, в том числе из вкладки Вход и Форм ввода.

Создание пользовательской переменной

Пользовательские переменные делятся на два типа:

Персональные (розовые) — хранят индивидуальные значения пользователя.
Например: имя пользователя, баланс, баллы в игре.
Глобальные (голубые) — хранят общие значения для всех пользователей.
Например: название бота, ссылка на сайт, название кнопки.

Важно! Глобальная переменная с форматом Формула не может содержать персональные переменные.

У каждой переменной есть значение, а каждое значение может быть одним из двух типов:

Обычное значение — значение, которое хранится внутри бота.
Интегрированное значение — значение, которое берётся со стороннего сервиса путём GET запроса, ответ должен быть в JSON формате.

URL запроса может содержать Переменные.

Важно! Для Переменных с интегрированным значением действует кэш 10 секунд.

Разберём остальные настройки Переменных:

Название переменной — символы "a-z" "A-Z" "0-9" "_".
Формат значения — определяет тип значения, которое будет хранится в Переменной.
- Текст
- Число
- Формула — сложное значение, формирующееся из нескольких переменных и/или содержащее математические операции.
- Ссылка — может быть использовано в кнопках с действием ссылка и в форматировании текста.
- Документ — любой медиафайл.

Важно! Формат значения Формула и любые выражения с Переменными имеют свои правила написания, подробнее: Правила написания выражения или формулы для изменения Переменной.

Значение по умолчанию — значение, которое будет отображаться у пользователя, пока в Переменную не будет записано другое значение или не будет изменено текущее.

Важно! В значение по умолчанию не может быть вставлена Переменная.

Описание — текст, отображаемый только на вкладке Переменные.
Группа — порядок отображения на вкладке Переменные.

Изменение переменной

Все переменные из Системной группы редактируются в тех местах, где они были созданы: Формы ввода — Конструктор, Реферальная система — Вход и так далее.

Пользовательские переменные можно редактировать двумя способами:

Через Действия “Изменить переменную" или “Очистить переменную”.
Через ручное редактирование значения.

Редактирование через Действие

Важно! Изменение Переменной происходит после вызова команды — если у вас в команде добавлено Действие изменить переменную {{VARIABLE}}, а в текстовом блоке этой же команды настроена отправка переменной {{VARIABLE}}, то пользователю будет отправлено предыдущее значение.

При изменении Пользовательской переменной с форматом “Число” можно использовать универсальный оператор “=” или использовать наиболее популярные операторы.

Например: для уменьшение переменной {{BALANCE}} на 1 можно использовать оператор вычесть “-” и прописать в поле выражение 1 или использовать универсальный оператор “=” и прописать {{BALANCE}} - 1. Оба этих варианта равнозначны.

Для переменных с форматом “Текст” используется только оператор “=”.

Например: в Пользовательской переменной {{MY_DAY}} хранится любимый день недели пользователя, в нашем случае это “Понедельник”. Для замены переменной на другой день, к примеру “Вторник” в поле выражение после оператора “=” нужно вписать слово используя кавычки “Вторник”.

Важно! Формат значения Формула и любые выражения с Переменными имеют свои правила написания, подробнее: Правила написания выражения или формулы для изменения Переменной.

Редактирование ручное

Значение можно менять индивидуально для каждого пользователя.

Очистка переменной

Действие Очистка переменной очищает до значения по умолчанию.

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

Стандартные переменные можно разделить на три группы:

Переменные общие (работают везде);
Переменные работающие только в боте;
Переменные работающие только в ресурсах (чатах и каналах).

Переменные общие

Данная группа переменных создана администраторами сервиса и она:

Не подлежит редактированию;
Работает и в боте и в ресурсах (каналах и группах).

{{BOT_NAME}} — Название бота (ссылкой);
{{BOT_NAME_TEXT}} — Название бота;
{{BOT_USERNAME}} — Юзернейм бота (ссылкой);
{{BOT_USERNAME_TEXT}} — Юзернейм бота;
{{HOURS}} — Часы (двузначное число);
{{MINUTES}} — Минуты (двузначное число);
{{SECONDS}} — Секунды (двузначное число);
{{DAY}} — День в месяце (двузначное число);
{{MONTH}} — Номер месяца (двузначное число);
{{MONTH_TEXT}} — Месяц (текстом);
{{YEAR}} — Год (четырёхзначное число);
{{WEEKDAY}} — День недели (текстом);
{{USD}} — Курс доллара (берётся с cbr.ru, отображается в долларах);
{{EUR}} — Курс евро (берётся с cbr.ru, отображается в долларах);
{{BTC}} — Курс Bitcoin (берётся с CoinMarketCup);
{{ETH}} — Курс Etherium (берётся с CoinMarketCup);
{{BIP}} — Курс BIP блокчейна Minter (берётся с CoinMarketCup);
{{HUB}} — Курс HUB блокчейна Minter (берётся с CoinMarketCup);
{{TONCOIN}} — Курс TON Coin (берётся с CoinMarketCup);

Работают в боте или в ресурсах, но и при событиях (приветствие новых пользователей или триггеры):

{{FIRST_NAME}} — Имя пользователя (ссылкой);
{{FIRST_NAME_TEXT}} — Имя пользователя;
{{LAST_NAME}} — Фамилия пользователя (ссылкой);
{{LAST_NAME_TEXT}} — Фамилия пользователя;
{{USERNAME}} — Юзернейм пользователя (ссылкой);
{{USERNAME_TEXT}} — Юзернейм пользователя;
{{USER_ID}} — ID пользователя в Telegram (ссылкой);
{{USER_ID_TEXT}} — ID пользователя в Telegram;
{{CATEGORY_NAME}} или {{CATEGORY_NAMES}} — Название категории, в которой находится пользователь.
{{JOIN_DATE}} — Дата входа в бота или ресурс (в формате “26.06.2020 15:41:29”);
{{JOIN_DATE_TIMESTAMP}} — Дата входа в бота или ресурс в формате Timestamp;
{{CURRENT_DATE}} — Текущая дата и время;
{{CURRENT_TIMESTAMP}} — Текущая время в формате Timestamp;
{{ACTIVE_SCENARIOS}} — Активные сценарии (названия текстом через запятую);

Важно! Все переменные даты и времени берут значения относительно часового пояса заданного в настройках аккаунта.

Переменные работающие только в боте

Пользовательская группа переменных, формируемая за счет создания во вкладке Переменны, Форм ввода и вкладки Вход.

Подробнее о работе Форм ввода в статье: Форма ввода.

Переменные работающие только в ресурсах

Все общие переменные;
{{RES_TITLE}} — Название ресурса, в который происходит отправка сообщения, приветствия и пр. (ссылкой);
{{RES_TITLE_TEXT}} — Название ресурса, в который происходит отправка сообщения, приветствия и прочее;
{{RES_DESCRIPTION}} — Описание ресурса, в который происходит отправка сообщения, приветствия и прочее.