UnBanBotUser

UnBanBotUser — разблокирует ранее заблокированного пользователя в боте.

📝 Назначение

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

⚠️ Важно: В отличие от UnBanChatMember (разблокировка в конкретном чате), UnBanBotUser разблокирует пользователя глобально во всех диалогах с ботом.

⚙️ Параметры

📍 Результат

После выполнения реакции пользователь удаляется из чёрного списка бота. Статус пользователя в разделе «Люди» меняется с 📵 Забанен на его предыдущий статус (например, 💚 Запустил).

🔄 Отличие от UnBanChatMember

💡 Совет: Используйте UnBanBotUser для полной разблокировки пользователя в боте. Используйте UnBanChatMember для разблокировки в конкретной группе.

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

Пример 1: Разблокировка текущего пользователя

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

Обработчик: Команда /unban

Реакция UnBanBotUser:

• user_id: ${user.id}

Пример 2: Разблокировка по @username

Задача: Разблокировать пользователя по его username.

Параметры UnBanBotUser:

• user_id: @spammer

Пример 3: Разблокировка после истечения срока наказания

Задача: Автоматически разблокировать пользователя через 24 часа.

Реакции в отложенном действии:

1. UnBanBotUser → user_id: ${task.data.user_id}
2. SendMessage → текст: Ваша блокировка снята. Добро пожаловать обратно!

Пример 4: Разблокировка через административное меню

Задача: Администратор выбирает пользователя из списка забаненных и разблокирует.

Реакция UnBanBotUser:

• user_id: ${menu.args1.1} (ID из кнопки меню)

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

⚠️ Частые ошибки и их решение

Ошибка 1: Пользователь не разблокируется

Причина: Указан неверный ID или username.

Решение: Убедитесь, что ID корректен. Используйте TakeUser для загрузки пользователя перед разблокировкой.

Ошибка 2: Путаница с UnBanChatMember

Причина: Использован UnBanChatMember вместо UnBanBotUser или наоборот.

Решение: UnBanBotUser — для глобальной разблокировки в боте. UnBanChatMember — для разблокировки в конкретном чате.

Ошибка 3: Статус пользователя не обновился

Причина: Возможно, пользователь не был забанен через BanBotUser, а был забанен через BanChatMember.

Решение: Для изменения статуса в боте используйте BanBotUser и UnBanBotUser.

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

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