Tham chiếu
Thao tác hàng loạt với khách
Áp một thay đổi cho tối đa 500 người: lưu, giai đoạn, thêm/bỏ thẻ, thêm/bỏ khỏi danh sách, hoặc không liên hệ (không bao giờ nhắn nữa).
Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.
Áp một thay đổi cho tối đa 500 người: lưu, giai đoạn, thêm/bỏ thẻ, thêm/bỏ khỏi danh sách, hoặc không liên hệ (không bao giờ nhắn nữa).
Thông tin
| Tên | Giá trị |
|---|---|
| Mã | people.bulk |
| Scope cần | crm.write |
| Mức | Ghi |
| Có thể cần xác nhận | Có |
| 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 |
| Trong app | Khách hàng → chọn nhiều |
Trường vào
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
ids |
uuid[] |
Có | |
op |
"save" | "stage" | "tag_add" | "tag_remove" | "list_add" | "list_remove" | "suppress" |
Có | |
value |
chữ |
Không |
Ví dụ gọi
curl -X POST https://tlg.builera.app/api/public/v2/ops/people.bulk \
-H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ids":[],"op":"save"}'Trường ra (data)
| Trường | Kiểu | Bắt buộc |
|---|---|---|
ok |
true |
Có |
changed |
số |
Có |
Ví dụ trả về
{
"data": {
"ok": true,
"changed": 1
}
}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: "people.bulk". Tên tool khi được liệt kê: people_bulk.