Метод editGeneralForumTopic

Метод позволяет изменить название обобщённой темы 'General' в супергруппе форума при наличии у бота прав администратора.

Описание

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

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

Примеры

php

<?php

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

// Данные для редактирования общего топика
$chatId = -1001234567890; // ID супергруппы или @supergroupusername
$newTopicName = 'Общие обсуждения'; // Новое название общего топика

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

// Отправка запроса
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl . 'editGeneralForumTopic');
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
/*
$context = stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => 'Content-Type: application/x-www-form-urlencoded',
        'content' => http_build_query($data)
    ]
]);

$response = file_get_contents($apiUrl . 'editGeneralForumTopic', false, $context);
$result = json_decode($response, true);
*/
?>

python

import requests

def edit_general_forum_topic(bot_token, chat_id, name):
    """
    Редактирует название общей темы в супергруппе с форумом.
    
    :param bot_token: Токен вашего бота
    :param chat_id: ID чата или username супергруппы
    :param name: Новое название темы (1-128 символов)
    :return: Результат запроса
    """
    url = f"https://api.telegram.org/bot{bot_token}/editGeneralForumTopic"
    
    payload = {
        "chat_id": chat_id,
        "name": name
    }
    
    response = requests.post(url, json=payload)
    return response.json()

# Пример использования
if __name__ == "__main__":
    # Конфигурация
    BOT_TOKEN = "ВАШ_ТОКЕН_БОТА"
    CHAT_ID = "@supergroupusername"  # или числовой ID
    NEW_NAME = "Общие обсуждения"
    
    # Вызов метода
    result = edit_general_forum_topic(BOT_TOKEN, CHAT_ID, NEW_NAME)
    print(result)

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

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