AddToUserList

AddToUserList — добавляет одного или нескольких пользователей в указанный список.

📝 Назначение

Используется для динамического наполнения пользовательских списков: добавление участников розыгрыша, формирование чёрного списка, группировка пользователей по интересам и т.д.

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

• Добавить пользователя в список участников розыгрыша
• Занести нарушителя в чёрный список
• Сформировать группу для таргетированной рассылки

💡 Совет: Списки должны быть предварительно созданы в разделе /adm → Люди → Списки пользователей.

⚙️ Параметры

📝 Форматы указания пользователя

⚠️ Важно: При массовом добавлении идентификаторы разделяются запятой без пробелов или с пробелом после запятой.

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

Пример 1: Добавление одного пользователя

Задача: Добавить пользователя, нажавшего кнопку, в список contest_participants.

Параметры AddToUserList:

• Список пользователей: contest_participants
• Пользователь: ${user.id}

Пример 2: Добавление пользователя по username

Задача: Добавить пользователя в чёрный список по команде администратора /addtoblacklist @username.

Параметры AddToUserList:

• Список пользователей: blacklist
• Пользователь: @username

Пример 3: Массовое добавление

Задача: Добавить нескольких пользователей в список одним вызовом.

Параметры AddToUserList:

• Список пользователей: contest_participants
• Пользователь: 123456789, 987654321, @user3

Пример 4: Добавление через переменную

Задача: Добавить пользователя, ID которого сохранён в переменной.

Параметры AddToUserList:

• Список пользователей: winners
• Пользователь: ${winner_id}

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

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

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