Tham chiếu

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.

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

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

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ề

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

Danh sách khách

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)