Метод unhideGeneralForumTopic

Этот метод делает видимой общую тему в чате супергруппы форума, если бот имеет права администратора.

Описание

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

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

Примеры

php

<?php

$botToken = 'YOUR_BOT_TOKEN';
$chatId = 'YOUR_CHAT_ID'; // Can be integer ID or @username for supergroup

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

$postData = [
    'chat_id' => $chatId,
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // Only for testing, remove in production

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    $responseData = json_decode($response, true);
    
    if ($responseData['ok'] === true) {
        echo "General forum topic successfully unhidden!";
    } else {
        echo "Error: " . $responseData['description'];
    }
}

curl_close($ch);

// Alternative using file_get_contents (if allow_url_fopen is enabled)
/*
$context = stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => 'Content-Type: application/x-www-form-urlencoded',
        'content' => http_build_query($postData)
    ]
]);

$response = file_get_contents($apiUrl, false, $context);
$responseData = json_decode($response, true);

if ($responseData['ok'] === true) {
    echo "General forum topic successfully unhidden!";
} else {
    echo "Error: " . $responseData['description'];
}
*/
?>

python

import requests

def unhide_general_forum_topic(bot_token, chat_id):
    """
    Unhides the 'General' topic in a forum supergroup chat.
    
    Args:
        bot_token (str): Your bot's token
        chat_id (int or str): Unique identifier for the target chat or 
                             username of the target supergroup (in format @supergroupusername)
    
    Returns:
        bool: True if successful, False otherwise
    """
    url = f"https://api.telegram.org/bot{bot_token}/unhideGeneralForumTopic"
    
    payload = {
        "chat_id": chat_id
    }
    
    try:
        response = requests.post(url, json=payload)
        response.raise_for_status()
        result = response.json()
        
        if result.get("ok"):
            return True
        else:
            print(f"Error: {result.get('description')}")
            return False
            
    except requests.exceptions.RequestException as e:
        print(f"Request failed: {e}")
        return False

# Пример использования
if __name__ == "__main__":
    # Замените на ваш токен бота
    BOT_TOKEN = "YOUR_BOT_TOKEN"
    
    # Пример с числовым chat_id
    chat_id_1 = -1001234567890  # ID супергруппы (отрицательное число)
    result1 = unhide_general_forum_topic(BOT_TOKEN, chat_id_1)
    print(f"Result 1: {result1}")
    
    # Пример с username
    chat_id_2 = "@myforumgroup"  # Username супергруппы
    result2 = unhide_general_forum_topic(BOT_TOKEN, chat_id_2)
    print(f"Result 2: {result2}")

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

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