Метод unpinAllGeneralForumTopicMessages

Описание

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

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

Примеры

php

<?php

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

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

$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 "Все сообщения в общем форумном топике откреплены успешно!";
} else {
    echo "Ошибка: " . $result['description'];
}

?>

python

import requests

def unpin_all_general_forum_topic_messages(bot_token, chat_id):
    """
    Clears the list of pinned messages in a General forum topic.
    
    Parameters:
    - bot_token (str): Your bot's token
    - chat_id (int | str): Unique identifier for the target chat or username 
                          of the target supergroup (e.g., @supergroupusername)
    
    Returns:
    - bool: True on success, raises exception on error
    """
    url = f"https://api.telegram.org/bot{bot_token}/unpinAllGeneralForumTopicMessages"
    
    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"API Error: {result.get('description')}")

# Пример использования:
if __name__ == "__main__":
    # Замените на реальные данные
    BOT_TOKEN = "YOUR_BOT_TOKEN"
    CHAT_ID = -1001234567890  # или "@supergroupusername"
    
    try:
        success = unpin_all_general_forum_topic_messages(BOT_TOKEN, CHAT_ID)
        print(f"Success: {success}")
    except Exception as e:
        print(f"Error: {e}")

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

API 6.8. Добавлен метод unpinAllGeneralForumTopicMessages