closeforumtopic

closeforumtopic — закрывает открытую тему в группе-форуме.

📝 Назначение

Используется для закрытия темы, после чего участники не могут отправлять в неё новые сообщения. Закрытую тему можно вновь открыть через reopenforumtopic.

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

• Обсуждение завершено и не требует новых сообщений
• Временная блокировка темы из-за нарушения правил
• Архивация устаревших обсуждений

💡 Совет: После закрытия темы сообщения в ней остаются доступными для чтения, но отправить новые нельзя. Закрытая тема помечается специальным значком в интерфейсе Telegram.

⚙️ Параметры

📍 Результат

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

${response.result}

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

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

💡 Совет: Если бот создал тему через createforumtopic, он может закрыть её без прав администратора.

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

Пример 1: Закрытие темы по ID

Задача: Закрыть тему с ID 12345.

Параметры closeforumtopic:

• chat_id: ${chat.id}
• message_thread_id: 12345

Пример 2: Закрытие темы после завершения обсуждения

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

Реакции:

1. (Обработка заказа)
2. closeforumtopic → chat_id: ${chat.id}, message_thread_id: ${order_thread_id}
3. SendMessage → в тему: Обсуждение заказа завершено. Тема закрыта.

Пример 3: Закрытие темы, созданной ботом

Задача: Бот создал тему и закрывает её после выполнения задачи.

Реакции:

1. createforumtopic → создание темы, сохранение message_thread_id
2. (Выполнение задачи)
3. closeforumtopic → chat_id: ${chat.id}, message_thread_id: ${saved_thread_id}

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

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

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

Реакции:

1. closeforumtopic → chat_id: ${chat.id}, message_thread_id: ${update.match.1}
2. SendMessage → текст: Тема ${update.match.1} закрыта.

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

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

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

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

closeForumTopic — Telegram Bot API