Системные функции: Генерация случайного числа

Используется, когда нужно добавить элемент случайности:

• разнообразить тексты и ответы,

• выбрать победителя в розыгрыше,

• случайно распределить пользователей по группам,

• создавать игровые механики или викторины.

💡 Пример:
Если вы зададите диапазон от 1 до 3, бот может вернуть 1, 2 или 3 — как повезёт!

Где можно использовать

Функция доступна почти во всех местах, где есть текстовое поле:

• в сообщениях,

• в блоках «Вопрос», «Текст», «Товар»,

• в сообщениях администраторам, шаблонах быстрых ответов и т.д.

Как вставить функцию в сценарий

Откройте нужный шаг — например, «Сообщение»:

Нажмите на «</> Выбор переменных и функций» ⭢ вкладка «Системные функции» ⭢ «Генерация случайного числа».

Вставится метка функции. Затем появится окно с настройками.

Как это выглядит в тексте:
{{random(min, max, fallback)}} — не пугайтесь этой записи: вы просто задаёте нижнюю и верхнюю границы числа.

• min — от какого числа считать (например, 1)

• max — до какого числа (например, 3)

• fallback — что вернуть «на всякий случай», если бот не сможет посчитать (можно не заполнять)

Пример:  {{random(1, 3)}}  вернёт 1, 2 или 3 — как повезёт

 Как работает настройка

После выбора функции откроется окно, где нужно указать диапазон чисел.

• Минимальное число — с какого значения начинать (например, 1).

• Максимальное число — до какого значения (например, 10).

• Резервное значение (необязательно) — подстраховка на случай ошибки. Если бот не сможет посчитать (например, введены неверные данные), он вернёт это число.

Сервис проверит, чтобы всё было логично:
если «минимальное» число больше «максимального», сохранить не даст.

Примеры из практики

1. Разные приветствия
Хотите, чтобы бот не говорил одно и то же каждый раз?
Используйте случайное число для выбора варианта.
Пример: {{random(1,3)}}
1 → Привет! 👋
2 → Здравствуй!
3 → Рад тебя видеть!
Каждый раз пользователь увидит разное приветствие.

2. Мини-розыгрыш
 {{random(1,100)}}
Если выпало 77 — поздравление и бонус!
Все остальные получают фразу: «Не повезло, попробуй снова 😉».

3. Персональная скидка
 {{random(5,15)}}
Бот сам подставляет случайное число:
«Ваша скидка сегодня — {{…}}%!»

4. Игра или викторина
 {{random(1,4)}}
Бот случайно выбирает, какой вариант ответа показать первым.
Так пользователи не смогут запомнить «правильную» кнопку.

5. Деление пользователей по группам
 {{random(1,2)}}
Если выпало 1 → пользователь идёт по ветке «Группа А»
Если 2 → по ветке «Группа B».
Отличный способ тестировать разные сценарии.

6. Подстраховка на случай ошибки
 {{random(10,5,999)}}
Если бот видит, что нижняя граница больше верхней, он не сможет сгенерировать число — зато подставит 999 (резервное значение).

Что делает бот “за кулисами”

• Бот всегда возвращает целое число — без запятых.

• Если всё указано правильно, выбирается случайное значение от «минимум» до «максимум» включительно.

• Если указаны переменные, бот подставит их значения при запуске сценария.

• Если не может вычислить результат (например, переменная пуста или границы перепутаны), сработает резервное значение, а если его нет — бот вернёт 0

 Перед запуском проверьте

• Диапазон указан корректно (от меньшего к большему).
• Если нужны подстраховки — добавлено резервное значение.
• Проверили результат на тестовом запуске.
• Не используете дробные числа (бот работает только с целыми).
• Переменные, если они есть, уже содержат нужные значения.

Частые вопросы

Что будет, если я не задам резервное значение?
Если функция не сможет выполниться, бот вернёт 0 — это “значение по умолчанию”.

Функция возвращает только целые числа?
Да. Если нужен выбор с десятичными, используйте округление в других функциях, например «Округление числа».

Почему кнопка «Сохранить» иногда не активна?
Потому что бот проверяет диапазон. Если указано, что “от 10 до 1” — функция не выполнится. Нужно исправить порядок.

💡 Совет

Чтобы добавить немного «магии» — используйте случайное число не только в текстах, но и в логике сценариев. Например, можно создать условие:

«Если число ≤ 5 — показать одну ветку, если > 5 — другую».
Так бот будет действовать чуть по-разному, создавая эффект “живого общения”.

Функция «Генерация случайного числа» помогает сделать ваш бот непредсказуемым и интересным.
Добавляйте её в сценарии, где хочется разнообразия, розыгрышей или просто “эффекта случайности”.