---
title: "Danh sách khách"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/people.list
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Danh sách khách

Tìm và lọc người trong CRM (giai đoạn, thẻ, danh sách, nhiệt độ, tài khoản phụ trách). Lật trang theo offset.

Tìm và lọc người trong CRM (giai đoạn, thẻ, danh sách, nhiệt độ, tài khoản phụ trách). Lật trang theo offset.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `people.list` |
| 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 | Khách hàng → danh sách |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `q` | `chữ` | Không |   |
| `stageId` | `uuid` | Không |   |
| `tag` | `chữ` | Không |   |
| `listId` | `uuid` | Không |   |
| `temperature` | `"hot" \| "warm" \| "cold"` | Không |   |
| `ownerAccountId` | `uuid` | 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/people.list \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

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

Tool `people_list` 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`.