Tham chiếu
Đăng story
Đăng story ảnh (JPEG) hoặc video (MP4, ≤ 60 giây, kèm duration/width/height) trong 24 giờ từ một tệp đã tải lên thư mục gửi đi của tài khoản; quyền xem everyone / contacts / close_friends; `pinned` giữ story trên hồ sơ sau đó. Chú thích ≤ 200 ký tự. Tính vào hạn mức ngày 'Đăng story'. Có `conversationId` (một chat kênh / siêu nhóm của tài khoản, worker ≥ 1.0.33) thì story được đăng cho kênh đó — luôn công khai; Telegram từ chối với BOOSTS_REQUIRED / CHAT_ADMIN_REQUIRED khi kênh thiếu boost hoặc tài khoản thiếu quyền quản trị.
Đăng story ảnh (JPEG) hoặc video (MP4, ≤ 60 giây, kèm duration/width/height) trong 24 giờ từ một tệp đã tải lên thư mục gửi đi của tài khoản; quyền xem everyone / contacts / close_friends; pinned giữ story trên hồ sơ sau đó. Chú thích ≤ 200 ký tự. Tính vào hạn mức ngày 'Đăng story'. Có conversationId (một chat kênh / siêu nhóm của tài khoản, worker ≥ 1.0.33) thì story được đăng cho kênh đó — luôn công khai; Telegram từ chối với BOOSTS_REQUIRED / CHAT_ADMIN_REQUIRED khi kênh thiếu boost hoặc tài khoản thiếu quyền quản trị.
Thông tin
| Tên | Giá trị |
|---|---|
| Mã | stories.post |
| Scope cần | profile.write |
| Mức | Ghi |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Xếp việc cho máy chạy |
Cần Idempotency-Key |
Có |
| Vai trò thành viên được phép | owner, manager |
| Cần máy chạy từ bản | 1.0.29 |
| Trong app | Tài khoản → Story → Đăng story |
Trường vào
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
accountId |
uuid |
Có | |
storagePath |
chữ |
Có | |
kind |
"photo" | "video" |
Có | |
mime |
chữ |
Có | |
caption |
chữ |
Không | |
privacy |
"everyone" | "contacts" | "close_friends" |
Có | |
pinned |
đúng/sai |
Không | |
video |
đối tượng |
Không | |
conversationId |
uuid |
Không |
Ví dụ gọi
curl -X POST https://tlg.builera.app/api/public/v2/ops/stories.post \
-H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: <mã riêng mỗi việc>" \
-d '{"accountId":"00000000-0000-0000-0000-000000000000","storagePath":"…","kind":"photo","mime":"…","privacy":"everyone"}'Trường ra (data)
| Trường | Kiểu | Bắt buộc |
|---|---|---|
ok |
true |
Có |
jobId |
chữ |
Có |
Ví dụ trả về
{
"data": {
"ok": true,
"jobId": "00000000-0000-4000-8000-000000000000"
}
}Dùng qua MCP
Không có tên sẵn trong profile nào: gọi tools_describe rồi tools_run với code: "stories.post". Tên tool khi được liệt kê: stories_post.