---
title: "Người tìm thấy trong nhóm"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/groups.people
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Người tìm thấy trong nhóm

Người tìm thấy trong một nhóm qua các lượt quét (lật trang theo offset).

Người tìm thấy trong một nhóm qua các lượt quét (lật trang theo offset).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `groups.people` |
| Scope cần | `crm.read` |
| Mức | Chỉ đọc |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Trả kết quả ngay |
| Cần `Idempotency-Key` | Không |
| Vai trò thành viên được phép | `owner`, `manager`, `agent`, `viewer` |
| Trong app | Tìm khách → Nhóm → Người |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `groupId` | `uuid` | Có |   |
| `q` | `chữ` | Không |   |
| `onlyNew` | `đúng/sai` | Không |   |
| `hasUsername` | `đúng/sai` | Không |   |
| `limit` | `số nguyên` | Không |   |
| `offset` | `số nguyên` | Không |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.people \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"groupId":"00000000-0000-0000-0000-000000000000"}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `page` | `null \| chữ \| số \| đối tượng \| any[] \| đúng/sai` | Có |
| `untrusted` | `true` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "page": "text",
    "untrusted": true
  }
}
```

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