TakeUserList

TakeUserList — загружает список пользователей в целевые переменные для массовой обработки.

📝 Назначение

В отличие от LoadUserList, которая просто загружает массив в ${load}, TakeUserList помещает список пользователей в целевую переменную (${target.from}), что позволяет отправлять сообщения или выполнять действия автоматически для каждого пользователя из списка.

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

• Массовая рассылка сообщений всем пользователям из списка
• Выполнение действия для каждого пользователя (например, выдача бонуса)
• Обработка списка пользователей в цикле

⚠️ Важно: Реакция загружает первые 200 пользователей из списка. Если в списке больше 200 участников, остальные не будут обработаны.

⚙️ Параметры

📍 Результат

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

🔧 Опция «Устанавливать chat»

По умолчанию (опция включена):

• ${target.chat} — информация о чате, где произошло событие
• ${target.from} — массив пользователей из списка

При включённой опции:

• ${target.chat} дублирует информацию из ${target.from} (каждый пользователь становится «чатом»)
• Это удобно для массовых рассылок, где нужно отправить сообщение каждому пользователю

Пример структуры target по умолчанию:

{
  "chat": {
    "id": -1001798752916,
    "title": "Group Testing",
    "type": "supergroup"
  },
  "from": {
    "first_name": "Example",
    "id": 7042623778,
    "is_bot": false,
    "last_name": "07"
  }
}

Пример структуры target при включённой опции:

{
  "chat": {
    "first_name": "Example",
    "id": 7042623778,
    "last_name": "07",
    "type": "user"
  },
  "from": {
    "first_name": "Example",
    "id": 7042623778,
    "is_bot": false,
    "last_name": "07"
  }
}

📊 Ограничения

💡 Совет: Если в списке больше 200 пользователей, разбейте рассылку на несколько этапов или используйте LoadUserList для получения полного списка.

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

Пример 1: Массовая рассылка сообщений

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

Реакции:

1. TakeUserList → Список пользователей: contest_participants, Устанавливать chat: true
2. SendMessage → (автоматически для каждого пользователя) текст: Вы участвуете в розыгрыше!

Пример 2: Выдача бонуса всем участникам списка

Задача: Начислить 100 бонусов каждому пользователю из списка vip_users.

Реакции:

1. TakeUserList → Список пользователей: vip_users
2. AddVarCloud → (для каждого пользователя) value: 100

Пример 3: Проверка количества пользователей перед рассылкой

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

Реакции:

1. TakeUserList → Список пользователей: contest_participants
2. TriggerFolder с условием: проверка, пуст ли ${target.from}

• Внутри (если не пуст): рассылка
• Иначе: SendMessage → Список пуст

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

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

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