Действия с массивами
В шаге «Действия» можно заменить массив целиком, добавить или удалить элемент и очистить поле. Операции доступны для пользовательских и глобальных массивов.
Если массив ещё не создан, сначала прочитайте статью «Массивы: создание, формат и использование».
Как добавить действие
- Добавьте в сценарий шаг «Действия».
- Нажмите «Добавить действие».
- Выберите «Действия с полями/переменными».
- Выберите пользовательский или глобальный массив.
- Выберите операцию и укажите значение.
- Сохраните шаг и протестируйте сценарий.
Операции, доступные для массива
Установить значение
Операция заменяет весь текущий массив новым. Старые элементы не сохраняются.
Примеры:
["Онлайн-курс", "Консультация", "Чек-лист"][10, 20, 30]["2026-09-01", "2026-09-15"]["2026-09-01T09:30:00Z", "2026-09-01T12:00:00Z"][
{"name": "Онлайн-курс", "price": 2990},
{"name": "Консультация", "price": 1500}
]Чтобы установить пустой массив, укажите []. Если нужно полностью удалить значение пользовательского поля, используйте операцию «Очистить поле».
Добавить элемент в конец
Операция добавляет один элемент после всех существующих. Если у пользовательского массива ещё нет значения, BotMan создаст список и добавит в него первый элемент.
Добавление одного элемента в конец массива
Указывайте один элемент, а не массив:
| Тип массива | Значение |
|---|---|
| Текст | "Онлайн-курс" |
| Число | 2990 |
| Дата | "2026-09-15" |
| Дата и время | "2026-09-15T14:45:00Z" |
| Объект | {"name": "Онлайн-курс", "price": 2990} |
В значении можно использовать переменные. Например:
{"name": {Название товара}, "price": {Цена товара}}После подстановки переменных результат должен оставаться корректным JSON и соответствовать типу элементов массива.
Удалить элемент по индексу
Индекс — это позиция элемента, начиная с нуля:
| Индекс | Какой элемент будет удалён |
|---|---|
0 | первый |
1 | второй |
2 | третий |
Для массива ["A", "B", "C"] удаление индекса 1 даст результат ["A", "C"].
Если индекс отрицательный или больше последнего доступного индекса, массив не изменится.
Удалить элемент по значению
Операция находит точное совпадение и удаляет только первое найденное значение.
| Тип массива | Значение для удаления |
|---|---|
| Текст | "Онлайн-курс" |
| Число | 2990 |
| Дата | "2026-09-01" |
| Дата и время | "2026-09-01T09:30:00Z" |
| Объект | {"name": "Онлайн-курс", "price": 2990} |
Для объектов должны совпасть ключи и значения объекта. Если совпадения нет, массив не изменится.
Пример: в массиве ["A", "B", "A"] удаление значения "A" даст ["B", "A"].
Очистить поле
Операция удаляет текущее значение массива.
- Для пользовательского массива поле подписчика становится незаполненным.
- Для глобального массива общее значение очищается для всех сценариев, которые используют эту переменную.
Проверка «Пустой» считает пустыми и [], и поле без значения. Функция «Количество элементов массива» в обоих случаях возвращает 0.
Частые ошибки
Текст без кавычек
Неправильно: Онлайн-курс
Правильно: "Онлайн-курс"
Число в кавычках
Для числового массива используйте 2990, а не "2990".
Одинарные кавычки
JSON принимает двойные кавычки: "Москва". Запись 'Москва' не подходит.
Массив вместо одного элемента
В операции «Добавить элемент в конец» укажите "Москва", а не ["Москва"].
Изменение глобального массива
Глобальная переменная общая. Если действие удалит из неё значение, изменение увидят все подписчики и сценарии аккаунта. Для персональных списков используйте пользовательское поле.
Следующий шаг
Чтобы построить разные ветки сценария в зависимости от содержимого массива, используйте статью «Проверка массива».