Метод hideGeneralForumTopic

Метод скрывает тему «Общее» в чате супергруппы форума, если бот имеет права администратора.

Описание

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

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

Примеры

php

<?php

$botToken = 'YOUR_BOT_TOKEN';
$chatId = 'CHAT_ID_OR_USERNAME'; // Например: 123456789 или "@supergroupusername"

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

$data = [
    'chat_id' => $chatId
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
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 "General forum topic hidden successfully!";
} else {
    echo "Error: " . $result['description'];
}

// Альтернативный вариант с использованием file_get_contents
/*
$options = [
    'http' => [
        'method' => 'POST',
        'header' => 'Content-Type: application/x-www-form-urlencoded',
        'content' => http_build_query($data)
    ]
];

$context = stream_context_create($options);
$response = file_get_contents($apiUrl, false, $context);
$result = json_decode($response, true);
*/
?>

python

import requests

def hide_general_forum_topic(bot_token, chat_id):
    """
    Скрывает общую тему в супергруппе с форумом.
    
    :param bot_token: Токен вашего бота
    :param chat_id: ID чата или username супергруппы
    :return: True в случае успеха, иначе вызывает исключение
    """
    url = f"https://api.telegram.org/bot{bot_token}/hideGeneralForumTopic"
    
    payload = {
        "chat_id": chat_id
    }
    
    response = requests.post(url, json=payload)
    response.raise_for_status()
    
    result = response.json()
    
    if result.get("ok"):
        return True
    else:
        raise Exception(f"Ошибка: {result.get('description')}")

# Пример использования
if __name__ == "__main__":
    BOT_TOKEN = "ВАШ_ТОКЕН_БОТА"
    CHAT_ID = -1001234567890  # Или "@supergroupusername"
    
    try:
        success = hide_general_forum_topic(BOT_TOKEN, CHAT_ID)
        print(f"Общая тема успешно скрыта: {success}")
    except Exception as e:
        print(f"Ошибка: {e}")

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

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