unpinallgeneralforumtopicmessages
unpinallgeneralforumtopicmessages — открепляет все закреплённые сообщения в общей теме (General) группы-форума.
📝 Назначение
В группах-форумах есть специальная общая тема (General). Эта реакция очищает все закреплённые сообщения в ней за один вызов.
Когда это нужно:
- Очистка устаревших закреплённых сообщений в общем чате
- Подготовка общей темы к новому закреплению
- Устранение «мусора» из нескольких закреплённых сообщений в общем чате
💡 Совет: Эта реакция работает только с общей темой (General). Для очистки закреплений в обычных темах используйте
unpinAllForumTopicMessages.
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat_id | Integer/String | ✅ Да | ID группы-форума или @username |
📍 Результат
После выполнения реакции результат доступен в переменной:
${response.result}
Тип значения: Boolean — true при успешном откреплении всех сообщений.
🔐 Требуемые права бота
| Право | Описание |
|---|---|
| Бот — администратор чата | Обязательное условие |
| can_pin_messages | Право закреплять и откреплять сообщения в супергруппе |
⚠️ Важно: Без права
can_pin_messagesреакция вызовет ошибку.
🧪 Примеры использования
Пример 1: Очистка закреплений в общей теме
Задача: Удалить все закреплённые сообщения в общей теме форума.
Параметры unpinallgeneralforumtopicmessages:
chat_id:${chat.id}
Пример 2: Подготовка общей темы к новому закреплению
Задача: Перед закреплением нового сообщения в общем часе очистить все старые закрепления.
Реакции:
unpinallgeneralforumtopicmessages→chat_id:${chat.id}pinChatMessage→ закрепление нового сообщения в общем чате
Пример 3: Очистка общей темы по команде администратора
Задача: Администратор может очистить все закрепления в общем чате командой /unpingeneral.
Обработчик: Команда /unpingeneral
Реакции:
unpinallgeneralforumtopicmessages→chat_id:${chat.id}SendMessage→ текст:Все закреплённые сообщения в общей теме удалены.
Пример 4: Периодическая очистка по расписанию
Задача: Каждую неделю автоматически очищать закрепления в общем чате.
Расписание: Еженедельно
Реакции:
unpinallgeneralforumtopicmessages→chat_id:-100123456789
🔄 Особенности поведения
| Ситуация | Поведение |
|---|---|
| В общей теме нет закреплённых сообщений | Реакция не вызывает ошибку (ничего не меняется) |
| Бот не администратор | Реакция вызовет ошибку |
| У бота нет права can_pin_messages | Реакция вызовет ошибку |
| Чат не является форумом | Реакция вызовет ошибку |
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| unpinAllForumTopicMessages | Открепить все сообщения в обычной теме |
| pinChatMessage | Закрепить сообщение |
| unpinChatMessage | Открепить конкретное сообщение |
| unpinAllChatMessages | Открепить все сообщения в чате (без учёта тем) |
🔗 Связанные разделы
| Раздел | Описание |
|---|---|
| Топики | Общая информация о темах форума |