Действия с полями/переменными: тип "Число"

Переменные типа "Число" используются для хранения и обработки числовых данных: количество товаров, баланс пользователя, рейтинг, сумма заказа и т. д.

С помощью блока "Действия с полями/переменными" можно:

Установить числовое значение (например, задать начальный баланс)
Увеличивать или уменьшать число (например, списывать баллы или увеличивать счетчик)
Выполнять математические операции (сложение, вычитание, умножение, деление)
Очищать значение переменной

Далее разберем, как правильно настроить работу с полями "Число", а также рассмотрим практические примеры.


Добавление блока в сценарий

Перейдите в редактор бота → В списке шагов выберите "Действия" → Внутри шага "Действия" нажмите "Добавить действие" → выберите "Действия с полями/переменными".

 Настройка блока "Действия с полями/переменными"

Выбор переменной

В поле "Название переменной" выберите переменную с типом "Число", с которой хотите работать.

  • Если нужной переменной нет, создайте новую в "Настройки" → "Пользовательские переменные" или "Настройки" → "Глобальные переменные".

  • Новая переменная автоматически добавится в список.

Выбор типа действия

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

📌 Установить значение
Позволяет записать новое числовое значение. Например, задать баланс пользователя или указать начальное количество товаров.

📌 Очистить значение
Удаляет текущее числовое значение из переменной, делая ее пустой.

📌 Увеличить значение на…
Добавляет указанное число к текущему значению переменной. Используется для увеличения баланса, количества покупок и т. д.

📌 Уменьшить значение на…
Вычитает указанное число из текущего значения переменной. Например, для списания бонусов или уменьшения доступного количества товаров.

📌 Математические операции
Позволяет выполнять расчеты (+, -, *, /) с числовыми значениями.

Далее разберем каждое действие подробнее.


📌 Установить значение

Позволяет задать конкретное числовое значение. Если переменная уже содержит число, оно заменится на новое.

Пример: Установка начального баланса
Сценарий: При регистрации пользователь получает начальный баланс в 1000 рублей.

Настройка блока:

  • Название переменной: Баланс

  • Тип действия: Установить значение

  • Значение: 1000

🎊 Теперь в переменной Баланс будет храниться 1000 рублей.


🗑 Очистить значение

Полностью удаляет число из переменной.

Пример: Очистка счетчика покупок
Сценарий: После завершения акции нужно сбросить счетчик покупок пользователя.

Настройка блока:

  • Название переменной: Счетчик покупок

  • Тип действия: Очистить значение

🎉 Теперь переменная Счетчик покупок станет пустой.


 Увеличить значение на…

Добавляет указанное число к текущему значению.

Пример: Начисление бонусов
Сценарий: После каждой покупки пользователю начисляется 100 бонусов.

Настройка блока:

  • Название переменной: Бонусы

  • Тип действия: Увеличить значение на...

  • Значение: 100

🎊 Теперь при каждом начислении в переменную Бонусы будет добавляться 100 баллов.


 Уменьшить значение на…

Вычитает указанное число из текущего значения.

Пример: Списание бонусов при оплате
Сценарий: Пользователь тратит 500 бонусов на оплату заказа.

Настройка блока:

  • Название переменной: Бонусы

  • Тип действия: Уменьшить значение на

  • Значение: 500

🎉 Теперь у пользователя спишется 500 бонусов из общего количества.


🧮 Математические операции

Позволяет выполнять вычисления внутри переменной.

Пример: Расчет скидки на товар
Сценарий: Нужно вычислить цену со скидкой 20%.

Настройка блока:

  • Название переменной: Цена_со_скидкой

  • Тип действия: Математические операции

  • Формула: {Цена} * 0.8

🎊 Теперь в переменной Цена_со_скидкой будет храниться сумма с учетом скидки.


💡 Особенности работы с "Число"

❗Если установлено новое значение, старое заменяется полностью – будьте внимательны.

❗При увеличении/уменьшении значения учитывайте минимальные и максимальные лимиты (если они есть в логике бота).

❗Операции деления могут давать дробные значения, если требуется округление – используйте дополнительную обработку.

❗Очистка значения полностью сбрасывает переменную, и если затем вызвать ее без повторного задания, бот может вернуть ошибку.


👆 На этом пока всё