VarCloudValue
Проверяет значение, сохранённое в облачной переменной, позволяя управлять логикой бота на основе данных пользователя (например, возраст, подписка, город).
| Настройка | Описание |
|---|---|
| Переменная | выбрать облачную переменную, например age, is_premium или city. |
| Has | проверять только наличие переменной, без сравнения значения. |
| Тип проверки | зависит от типа данных выбранной переменной (булевое значение, число, строка). |
| Значение | задать эталон, с которым сравнивается переменная. |
Когда использовать: нужно персонализировать доступ: давать функции только тем, у кого заполнена переменная, сравнивать баланс или проверять подписку.
Как работает: Действие выполняется, только если проверка переменной вернула true.
Поддерживаемые виды проверок:
Has
Проверяет только то, что переменная у пользователя заполнена, значение при этом не сравнивается. Подходит для любого типа данных.
| Режим | Когда сработает |
|---|---|
| Has | Переменная заполнена |
| NOT | Переменная не заполнена |
При включённой галке Has поле «Значение» и операторы сравнения скрываются — они в проверке не участвуют.
⚠️ Важно:
✅ Пустое значение и отсутствие переменной — разные вещи: сохранённая пустая строка считается заполненной переменной.
✅ Если у переменной задан срок хранения и он истёк, переменная считается незаполненной.
✅ Для динамических переменных режим Has недоступен: их значение вычисляет триггер, и отсутствие записи означает лишь то, что она ещё не посчитана.
Bool
| Режим | Когда сработает |
|---|---|
| ✅ | Переменная существует и равна true (например, подписка активна) |
| NOT | Переменная равна false (подписка не активна) |
⚠️ Важно:
✅ Если переменная у пользователя не заполнена, сравнение значения выполнить не с чем: условие завершается ошибкой и действие не выполняется — в том числе с NOT. Чтобы обработать такой случай, используйте режим Has.
Number
| Режим | Когда сработает |
|---|---|
| = | (по умолчанию) Значение переменной равно заданному |
| < | Значение переменной меньше заданного |
| > | Значение переменной больше заданного |
| ≤ | Значение переменной меньше или равно заданному |
| ≥ | Значение переменной больше или равно заданному |
| NOT | Инвертирует любой из выбранных операторов |
⚠️ Важно:
✅ Чтобы проверить «не равно» — используйте NOT + =
String
| Режим | Когда сработает |
|---|---|
| Равно | Текст в переменной полностью совпадает с указанным |
| Содержит | Текст в переменной включает указанную подстроку |
| Начинается с | Текст в переменной начинается с указанной подстроки |
| Заканчивается на | Текст в переменной заканчивается на указанную подстроку |
| NOT | Инвертирует любой из выбранных режимов |
⚠️ Важно:
✅ Чтобы проверить «не содержит», «не начинается с», «не заканчивается на» или «не равно» — используйте NOT + соответствующий режим
Итоговая формула
| Если нужно | То в интерфейсе выбираем |
|---|---|
| Проверить, что условие выполняется (true) | Сам режим проверки (✅, =, Равно, Содержит, ...) |
| Проверить, что условие НЕ выполняется (false) | NOT + тот же режим проверки |
⚠️ Важно
- Булевы значения не поддерживают операторы сравнения =, <, > и поиск подстроки.
- Числа не поддерживают строковые операции (поиск подстроки, начало/конец).
- Строки не поддерживают математические сравнения (<, >, ≤, ≥).
Примеры
| Пример | Когда сработает |
|---|---|
| VarCloudValue → is_premium → ✅ | пользователь имеет активную премиум-подписку |
| NOT → VarCloudValue → is_premium → ✅ | пользователь НЕ имеет премиум-подписку |
| VarCloudValue → balance → ≥ → 100 | баланс пользователя 100 или больше |
| NOT → VarCloudValue → balance → ≥ → 100 | баланс пользователя меньше 100 |
| VarCloudValue → city → ☑ → бург | город пользователя содержит «бург» (Гамбург, Санкт-Петербург) |
| VarCloudValue → status → = → "active" | статус пользователя точно равен «active» |
| VarCloudValue → city → Has | у пользователя заполнен город |
| NOT → VarCloudValue → city → Has | у пользователя не заполнен город |
Итоговая формула
| Если нужно | То в интерфейсе выбираем |
|---|---|
| Проверить, что условие выполняется (true) | сам тип проверки (✅, =, ☑, ≥ и т.д.) |
| Проверить, что условие НЕ выполняется (false) | NOT + тот же тип проверки |
⚠️ Важно:
Тип данных выбранной переменной определяет доступный набор проверок. Булевы значения не поддерживают операторы =, <, > и поиск подстроки. Для чисел не работает поиск подстроки. Строки не поддерживают математические сравнения (<, >, ≤, ≥).