Переменные

Переменные — раздел для хранения различных типов данных длительное время.

Типы

Параметры

Загрузить или отобразить содержимое переменной можно 2 способами:

• С помощью реакции GetVarCloud и переменной ${var.тип.название}
• С помощью макроса varcloud

Не рекомендуется использовать GetVarCloud, если нужно загрузить значение только одной переменной — используйте макрос !{varcloud}.

Пример:

• ${var.person.number}
• ${var.member.name}
• ${var.chat.id}

Пользователь

Переменная пользователя - переменная привязанная к пользователям бота. значение переменной всегда одинаковой, независимо от того, где пользователь будет обращаться к боту, будь то личный чат с ботом или чат.

После использования реакции GetVarCloud, значение переменной будет доступно по адресу: ${var.person.названиеПеременной}

Участник-подписчик

Переменная участник/подписчик — привязывается к пользователю и к чату.

Доступна по адресу: ${var.member.названиеПеременной}

Группа-канал

Переменная группа/канал - переменная привязывается к группе или каналу. Значение переменной будет меняться в зависимости от места, где она будет вызываться.

После использования реакции ⚡getVarCloud, значение переменной будет доступно по адресу: ${var.chat.названиеПеременной}

Динамические

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

Когда использовать:

• Для данных, которые должны существовать только в рамках текущей сессии
• Для промежуточных вычислений между несколькими реакциями
• Для кэширования данных, которые могут измениться при следующем вызове

Особенности:

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

1. SetVarCloud → Тип: dynamic, Название: temp_data, Значение: {"step": 1, "data": "..."}
2. Доступ: !{varcloud|type: dynamic; name: temp_data}

💡 Совет: Используйте динамические переменные для временных данных, которые не нужно сохранять между сессиями. Для постоянных данных используйте person, member или global.

Глобальные

Глобальные переменные — это переменные, общие для всех пользователей бота. Значение глобальной переменной одинаково для всех.

Когда использовать:

• Счётчик запусков бота
• Режим обслуживания (включён/выключен)
• Общие настройки, которые меняются редко
• Статистика по всему боту

Особенности:

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

1. AddVarCloud → Тип: global, Название: total_users, Значение: 1
2. Доступ: !{varcloud|type: global; name: total_users}

Рекомендации при работе с переменными

Рекомендуется

Использовать в названии параметров переменной только строчные и заглавные буквы: sum, text, SumText, ProfileText.

Не рекомендуется

• Использовать в названиях параметров переменной: символы, цифры, эмодзи, пробелы.
• Использовать одинаковые названия параметров переменной.
• Использовать параметры переменной для хранения временных значений. Для хранения таких значений необходимо использовать локальные переменные.
• Использовать параметры переменной для хранения значений, одинаковых для всех пользователей бота. Для хранения таких значений необходимо использовать глобальные переменные.

Реакции