Tài liệu

Tham chiếu

Xem story (người / danh bạ / của mình / người xem)

op=peer: story đang hiện của một người / kênh (peer id từ chat hoặc bảng tin); op=feed: story của danh bạ (truyền `next` để lật trang); op=mine: story của chính tài khoản kèm lượt xem; op=viewers: ai đã xem một story của tài khoản (storyId). Chú thích và tên không tin cậy.

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

op=peer: story đang hiện của một người / kênh (peer id từ chat hoặc bảng tin); op=feed: story của danh bạ (truyền next để lật trang); op=mine: story của chính tài khoản kèm lượt xem; op=viewers: ai đã xem một story của tài khoản (storyId). Chú thích và tên không tin cậy.

Thông tin

Tên Giá trị
Mã stories.list
Scope cần messages.read
Mức Chỉ đọc
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 Không
Vai trò thành viên được phép owner, manager, agent
Cần máy chạy từ bản 1.0.29
Trong app Tài khoản → Story

Trường vào

Trường Kiểu Bắt buộc Mô tả
accountId uuid Có
op "peer" | "feed" | "mine" | "viewers" Có
peer đối tượng Không
next chữ Không
storyId số nguyên Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/stories.list \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accountId":"00000000-0000-0000-0000-000000000000","op":"peer"}'

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.list". Tên tool khi được liệt kê: stories_list.

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

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