Действия с массивами

Как установить массив, добавить элемент, удалить по индексу или значению и очистить пользовательский либо глобальный массив.

Обновлено 4 ноября 2026 г. 3 мин чтения

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

Если массив ещё не создан, сначала прочитайте статью «Массивы: создание, формат и использование».

Как добавить действие¶

Добавьте в сценарий шаг «Действия».
Нажмите «Добавить действие».
Выберите «Действия с полями/переменными».
Выберите пользовательский или глобальный массив.
Выберите операцию и укажите значение.
Сохраните шаг и протестируйте сценарий.

Операции, доступные для массива

Установить значение¶

Операция заменяет весь текущий массив новым. Старые элементы не сохраняются.

Примеры:

["Онлайн-курс", "Консультация", "Чек-лист"]

[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 принимает двойные кавычки: "Москва". Запись 'Москва' не подходит.

Массив вместо одного элемента¶

В операции «Добавить элемент в конец» укажите "Москва", а не ["Москва"].

Изменение глобального массива¶

Глобальная переменная общая. Если действие удалит из неё значение, изменение увидят все подписчики и сценарии аккаунта. Для персональных списков используйте пользовательское поле.

Следующий шаг¶

Чтобы построить разные ветки сценария в зависимости от содержимого массива, используйте статью «Проверка массива».