Tài liệu

Tham chiếu

Danh sách thành viên

Một trang của danh sách thành viên: recent, admins, banned, restricted, bots, search, link, requests (`q` tìm theo tên; `link` liệt kê ai đã vào / xin vào qua một link mời). Nhóm thường chỉ có một danh sách tối đa 200 người. Theo dõi thao tác để nhận trang (`nextOffset` cho trang sau).

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

Một trang của danh sách thành viên: recent, admins, banned, restricted, bots, search, link, requests (q tìm theo tên; link liệt kê ai đã vào / xin vào qua một link mời). Nhóm thường chỉ có một danh sách tối đa 200 người. Theo dõi thao tác để nhận trang (nextOffset cho trang sau).

Thông tin

Tên Giá trị
Mã groups.members
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.37
Trong app Hộp thư → thông tin nhóm → Thành viên

Trường vào

Trường Kiểu Bắt buộc Mô tả
conversationId uuid Có
list "recent" | "admins" | "banned" | "restricted" | "bots" | "search" | "link" | "requests" Có
q chữ Không
link uri Không
offset số nguyên Không
limit số nguyên Không

Ví dụ gọi

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

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

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

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