Переменные

В этом разделе мы рассмотрим, что такое переменные в Smartbot Pro.

Переменные позволяют сохранять сообщения и личные параметры пользователя (например, имя, id, набранные баллы и т.д.), ставить условия (текущие дата и время, тип канала, в котором получено сообщение), проводить математические операции и встраивать в сообщения динамический текст.

Так выглядит раздел переменных в Smartbot Pro

Переменные — это ключи в формате %название_переменной%, которые в тексте сообщения или условии будут заменены ботом на значения переменных.

Например, если написать в тексте сообщения %имя%, то бот заменит эту переменную на имя пользователя.

Есть два основных типа переменных: специальные и пользовательские

Специальные переменные

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

Специальные переменные выполняют сложные функции, к примеру, выдают id пользователя, сохраняют последнее полученное сообщение, следят за местным временем и т.д.

Вот далеко не полный список специальных переменных в Smartbot Pro, которые вы можете применять

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

Их вы можете создавать и изменять сами. Достаточно нажать кнопку "+Добавить переменную".

Допустим, это может быть счетчик бонусов %Баллы% или переменная %уже принимал участие%, начальное значение которой "нет", но после определенного действия оно поменяется на "да" и не позволит пользователю еще раз пройти активность.

Кастомные переменные бывают локальные (то есть, значение индивидуально для каждого человека) и глобальные (значение общее для всех пользователей).

Виды переменных

Вложение - в эту переменную можно сохранить файл: картинку, документ, аудиозапись и т.п.

Строка - слово, фраза, индивидуальный код. К примеру: %статус% = "клиент"

Число - цифра, с которой можно производить вычисления. Например, пополняемый счетчик бонусов; личный баланс в игре; виртуальная валюта.

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

Массив - сборник данных (чисел или строк). Имеет формат: ["элемент 1", "элемент 2", "элемент 3", "элемент 4"] - квадратные скобки, внутри которых каждый элемент записывается в кавычках и следует через запятую.

Массив может хранить промокоды на выдачу, имена участников определенной игры и многие другие полезности :)

Словарь - сборник пар данных ключ-значение.

Формат словаря: {"ключ": "значение", "ключ 2": "значение 2"} - фигурные скобки, двойные кавычки для ключей и значений (кроме значений, выраженных числами) и через запятую.

Таким образом, в массив вы можете добавить: «автомобиль, самолет, корабль»; а в словарь: «3 автомобиля, 4 самолета, 2 корабля» и менять их количество прямо по ходу цепочки. Если записывать это в правильном формате, получится так: ["автомобиль", "самолет", "корабль"] - в массив. {"автомобиль": 3, "самолет": 4, "корабль": 2} - в словарь

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

Подробнее о работе со словарями

И о работе с массивами

Переменные позволяют существенно расширить функционал и реализовать практически любую логику действий бота 💪