---
title: "Quét nhóm"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/scans.start
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# 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).

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

```bash
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ề

```json
{
  "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`.