deleteforumtopic

deleteforumtopic — удаляет тему форума вместе со всеми сообщениями в ней.

📝 Назначение

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

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

Удаление устаревших или неактуальных тем
Очистка чата от спам-тем
Полное удаление конфиденциального обсуждения

🔴 Важно: Операция необратима. Удалённая тема и все сообщения в ней не могут быть восстановлены.

⚙️ Параметры

Параметр	Тип	Обязательный	Описание
chat_id	Integer/String	✅ Да	ID группы-форума или @username
message_thread_id	Integer	✅ Да	ID темы для удаления

📍 Результат

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

${response.result}

Тип значения: Boolean — true при успешном удалении темы.

🔐 Требуемые права бота

Право	Описание
Бот — администратор чата	Обязательное условие
can_delete_messages	Право удалять сообщения (включая целые темы)

⚠️ Важно: В отличие от других операций с темами, для удаления требуется право can_delete_messages, а не can_manage_topics.

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

Пример 1: Удаление темы по ID

Задача: Удалить тему с ID 12345.

Параметры deleteforumtopic:

chat_id: ${chat.id}
message_thread_id: 12345

Пример 2: Удаление временной темы после мероприятия

Задача: После завершения мероприятия удалить временную тему.

Реакции:

(Мероприятие завершено)
deleteforumtopic → chat_id: ${chat.id}, message_thread_id: ${event_thread_id}

Пример 3: Удаление спам-темы

Задача: При обнаружении спам-темы автоматически удалить её.

Обработчик: (Условие обнаружения спама)

Реакции:

deleteforumtopic → chat_id: ${chat.id}, message_thread_id: ${spam_thread_id}
(Опционально) уведомление администраторов

Пример 4: Удаление темы по команде администратора

Задача: Администратор может удалить тему командой /deletetopic <id>.

Обработчик: Регулярное выражение /deletetopic (\d+)

Реакции:

deleteforumtopic → chat_id: ${chat.id}, message_thread_id: ${update.match.1}
SendMessage → текст: Тема ${update.match.1} удалена.

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

Ситуация	Поведение
Тема не существует	Telegram вернёт ошибку
Тема уже удалена	Реакция вызовет ошибку
Бот не администратор	Реакция вызовет ошибку
У бота нет права can_delete_messages	Реакция вызовет ошибку
Чат не является форумом	Реакция вызовет ошибку
Удаление общей темы (General)	Обычно невозможно (Telegram ограничивает)

⚠️ Важное предупреждение

Удаление темы безвозвратно:

Все сообщения в теме удаляются
История переписки теряется навсегда
Восстановление невозможно

💡 Совет: Перед удалением темы убедитесь, что важные данные сохранены. При необходимости сделайте резервную копию через LoadUserList или другие реакции.

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

Реакция	Назначение
createforumtopic	Создать новую тему
closeforumtopic	Закрыть тему (без удаления)
editforumtopic	Изменить название или иконку темы

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

Раздел	Описание
Топики	Общая информация о темах форума

🔗 Ссылка на официальную документацию

deleteForumTopic — Telegram Bot API