Описание
Используйте этот метод для изменения названия темы '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