Tham chiếu
Quét nhóm
Quét người gửi gần đây hoặc danh sách thành viên của nhóm bằng một tài khoản (tính vào hạn mức quét).
Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.
Quét người gửi gần đây hoặc danh sách thành viên của nhóm bằng một tài khoản (tính vào hạn mức quét).
Thông tin
| Tên | Giá trị |
|---|---|
| Mã | scans.start |
| Scope cần | groups.scan |
| 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 |
Không |
| Vai trò thành viên được phép | owner, manager |
| Trong app | Tìm khách → Nhóm → Quét |
Trường vào
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
groupId |
uuid |
Có | |
accountId |
uuid |
Có | |
mode |
"senders" | "members" |
Có | |
force |
đúng/sai |
Không |
Ví dụ gọi
curl -X POST https://tlg.builera.app/api/public/v2/ops/scans.start \
-H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"groupId":"00000000-0000-0000-0000-000000000000","accountId":"00000000-0000-0000-0000-000000000000","mode":"senders"}'Trường ra (data)
| Trường | Kiểu | Bắt buộc |
|---|---|---|
ok |
true |
Có |
scanId |
chữ |
Có |
Ví dụ trả về
{
"data": {
"ok": true,
"scanId": "00000000-0000-4000-8000-000000000000"
}
}Dùng qua MCP
Tool scans_start có tên sẵn trong profile: Tìm khách (prospecting). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.