LoadUserList

LoadUserList — загружает содержимое списка пользователей в текущий контекст.

📝 Назначение

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

Когда это нужно:

• Получить список участников для массовой рассылки
• Проверить состав списка перед очисткой
• Перебрать пользователей для выполнения действий над каждым

💡 Совет: Если нужно не просто получить список, а сразу выполнить действие над каждым пользователем, используйте TakeUserList.

⚙️ Параметры

📍 Результат

После выполнения реакции содержимое списка доступно в переменной:

${load}

Структура ${load} — массив строк (ID пользователей):

[
  "123456789",
  "987654321",
  "555666777"
]

⚠️ Важно: ID загружаются в виде строк, даже если исходно были числами.

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

Пример 1: Загрузка списка и отправка сообщения каждому пользователю

Задача: Отправить сообщение всем участникам списка contest_participants.

Реакции:

1. LoadUserList → Список пользователей: contest_participants
2. TriggerFolder с итерацией по ${load} (цикл)

• Внутри: SendMessage → chat_id: ${user_id}, текст: Поздравляем! Вы участвуете в розыгрыше.

Пример 2: Проверка количества участников в списке

Задача: Узнать, сколько пользователей в списке blacklist.

Реакции:

1. LoadUserList → Список пользователей: blacklist
2. SetVarLocal → count = !{list.len|list: ${load}}
3. SendMessage → текст: В чёрном списке ${localVar.count} пользователей

Пример 3: Проверка, пуст ли список

Задача: Перед рассылкой проверить, есть ли участники.

Реакции:

1. LoadUserList → Список пользователей: contest_participants
2. TriggerFolder с условием: Number → !{list.len|list: ${load}} = 0

• Внутри: SendMessage → Список пуст. Добавьте участников.

Пример 4: Получение первого пользователя из списка

Задача: Выбрать первого участника из списка для специального приза.

Реакции:

1. LoadUserList → Список пользователей: winners
2. SetVarLocal → first_winner = !{pick|value: ${load}; key: 0}
3. SendMessage → Первый победитель: ${localVar.first_winner}

🔄 Особенности поведения

🔗 Связанные реакции

🔗 Связанные разделы