Метод deleteStory | Telegram Bot API

Описание

Удаляет историю, ранее опубликованную ботом от имени управляемого бизнес-аккаунта. Требует права бизнес-бота can_manage_stories. Возвращает True при успешном выполнении.

Параметр	Тип	Обязательный	Описание
business_connection_id	String	Да	Уникальный идентификатор бизнес-подключения
story_id	Integer	Да	Уникальный идентификатор истории для удаления

Примеры

php

<?php

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

$postData = [
    'business_connection_id' => 'YOUR_BUSINESS_CONNECTION_ID',
    'story_id' => 123456789
];

$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);

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

if ($response === false) {
    $error = curl_error($ch);
    curl_close($ch);
    throw new Exception("cURL Error: {$error}");
}

curl_close($ch);

$result = json_decode($response, true);

if ($httpCode !== 200 || !$result['ok']) {
    $error = $result['description'] ?? 'Unknown error';
    throw new Exception("API Error: {$error}");
}

if ($result['result'] === true) {
    echo "Story deleted successfully!";
} else {
    echo "Failed to delete story.";
}

?>

python

import requests

def delete_story(bot_token, business_connection_id, story_id):
    """
    Deletes a story previously posted by the bot on behalf of a managed business account.
    
    Args:
        bot_token (str): Telegram Bot API token
        business_connection_id (str): Unique identifier of the business connection
        story_id (int): Unique identifier of the story to delete
    
    Returns:
        bool: True if successful, False otherwise
    """
    url = f"https://api.telegram.org/bot{bot_token}/deleteStory"
    
    payload = {
        "business_connection_id": business_connection_id,
        "story_id": story_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"
    BUSINESS_CONNECTION_ID = "your_business_connection_id"
    STORY_ID = 12345  # ID истории для удаления
    
    success = delete_story(BOT_TOKEN, BUSINESS_CONNECTION_ID, STORY_ID)
    
    if success:
        print("Story deleted successfully")
    else:
        print("Failed to delete story")

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

API 9.0. Добавлен метод deleteStory