Метод closeForumTopic

Метод для закрытия открытой темы в форуме супергруппы, требующий у бота прав администратора на управление темами.

Описание

Используйте этот метод, чтобы закрыть открытую тему в чате супергруппы форума. Бот должен быть администратором в чате для работы этого метода и должен иметь права администратора can_manage_topics, если только он не является создателем темы. Возвращает True при успешном выполнении.

Параметр Тип Обязательный Описание
chat_id Целое число или Строка Да Уникальный идентификатор целевого чата или имя пользователя целевой супергруппы (в формате @supergroupusername)
message_thread_id Целое число Да Уникальный идентификатор целевой ветки сообщений темы форума

Примеры

php

<?php

$botToken = 'YOUR_BOT_TOKEN';
$apiUrl = "https://api.telegram.org/bot{$botToken}/";

// Параметры для закрытия темы форума
$chatId = -1001234567890; // ID супергруппы или @username
$messageThreadId = 123; // ID темы форума

// Подготовка данных
$data = [
    'chat_id' => $chatId,
    'message_thread_id' => $messageThreadId
];

// Отправка запроса
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl . 'closeForumTopic');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

$response = curl_exec($ch);
curl_close($ch);

// Обработка ответа
$result = json_decode($response, true);

if ($result['ok']) {
    echo "Тема форума успешно закрыта!";
} else {
    echo "Ошибка: " . $result['description'];
}

// Альтернативный вариант с использованием file_get_contents
/*
$url = $apiUrl . 'closeForumTopic?' . http_build_query($data);
$response = file_get_contents($url);
$result = json_decode($response, true);

if ($result['ok']) {
    echo "Тема форума успешно закрыта!";
} else {
    echo "Ошибка: " . $result['description'];
}
*/
?>

python

import requests

def close_forum_topic(bot_token, chat_id, message_thread_id):
    """
    Закрывает открытую тему в супергруппе форума.
    
    Args:
        bot_token (str): Токен вашего бота
        chat_id (int or str): ID чата или username супергруппы
        message_thread_id (int): ID темы форума
    
    Returns:
        bool: True в случае успеха
    """
    url = f"https://api.telegram.org/bot{bot_token}/closeForumTopic"
    
    payload = {
        "chat_id": chat_id,
        "message_thread_id": message_thread_id
    }
    
    response = requests.post(url, json=payload)
    result = response.json()
    
    if result.get("ok"):
        return True
    else:
        print(f"Ошибка: {result.get('description')}")
        return False

# Пример использования
if __name__ == "__main__":
    # Замените значения на реальные
    BOT_TOKEN = "ВАШ_ТОКЕН_БОТА"
    CHAT_ID = -1001234567890  # Или "@supergroupusername"
    TOPIC_ID = 123  # ID темы форума
    
    success = close_forum_topic(BOT_TOKEN, CHAT_ID, TOPIC_ID)
    if success:
        print("Тема успешно закрыта")

История изменений

  • API 6.3. Добавлен метод closeForumTopic
Комментарии