postStory
Публікує історію від імені бізнес-акаунта.
Повертає: У разі успіху повертає Story.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
business_connection_id | String | Так | ID бізнес-підключення |
content | InputStoryContent | Так | JSON-об’єкт InputStoryContent |
active_period | Integer | Так | Тривалість показу в секундах: 21600, 43200, 86400 або 172800 |
caption | String | Ні | Підпис (0-2048) |
parse_mode | String | Ні | HTML, Markdown, MarkdownV2 |
caption_entities | Array of MessageEntity | Ні | JSON-масив MessageEntity |
areas | Array of StoryArea | Ні | JSON-масив StoryArea |
post_to_chat_page | Boolean | Ні | Опублікувати на сторінці чату |
protect_content | Boolean | Ні | Захистити вміст |
Приклад запиту
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/postStory" \
-H "Content-Type: application/json" \
-d '{
"business_connection_id": "BUSINESS_CONNECTION_ID",
"content": {
"type": "photo",
"photo": "attach://photo"
},
"active_period": 86400
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/postStory",
json={
"business_connection_id": "BUSINESS_CONNECTION_ID",
"content": {
"type": "photo",
"photo": "attach://photo"
},
"active_period": 86400
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/postStory`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"business_connection_id": "BUSINESS_CONNECTION_ID",
"content": {
"type": "photo",
"photo": "attach://photo"
},
"active_period": 86400
}),
});
console.log(await res.json());
Покроковий посібник: Як створити бота в Телеграм: від @BotFather до першого повідомлення
Схожі методи
editStoryРедагує історію від імені бізнес-акаунта.deleteStoryВидаляє історію від імені бізнес-акаунта.repostStoryРепостить історію з одного бізнес-акаунта в інший (Bot API 9.3).