Tài liệu

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ị.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

Đă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.

Trang này có hữu ích không?

Kiểm lại lần cuối: 24/10/2026 · bản 2.0